> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agrihub360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Readiness probe

> Returns `200` when the database is reachable and `503` when it is not. Unauthenticated and exempt from the rate limit.



## OpenAPI

````yaml /api-reference/device-api.yaml get /readyz
openapi: 3.1.0
info:
  title: AgriHub360 Device API
  version: 1.0.0
  description: |
    The Device API is the path a device takes to put a reading on a field. One
    authenticated endpoint stores a reading. Two unauthenticated probes report
    whether the service is up.

    A device authenticates with a per-device bearer API key or a client
    certificate, posts one `{ device_id, metric_id, value }` per request, and
    receives the stored row back with a server-assigned timestamp. Devices are
    claimed and keys are issued in the app.
  contact:
    name: AgriHub360 support
    url: https://www.agrihub360.com/support
servers:
  - url: https://devices.agrihub360.example
    description: Device API
security: []
tags:
  - name: telemetry
    description: Store a reading
  - name: health
    description: Liveness and readiness probes
paths:
  /readyz:
    get:
      tags:
        - health
      summary: Readiness probe
      description: >-
        Returns `200` when the database is reachable and `503` when it is not.
        Unauthenticated and exempt from the rate limit.
      operationId: readyz
      responses:
        '200':
          description: Ready. The database is reachable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Ready'
              example:
                status: ok
        '503':
          description: Not ready. The database is unreachable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Ready'
              example:
                status: unavailable
      security: []
components:
  schemas:
    Ready:
      type: object
      required:
        - status
      properties:
        status:
          type: string
          enum:
            - ok
            - unavailable

````