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

# Health

> Liveness and configuration summary. receiptsToHcs false means the seller runs without a receipts topic, so settled payments are only visible in listReceipts for as long as the process lives; auditsToHcs false means an auditor's attestations are dry runs and a buyer's trust policy will not see them.



## OpenAPI

````yaml /openapi.yaml get /health
openapi: 3.1.0
info:
  title: Agora402 seller API
  version: 1.0.0
  description: >-
    HTTP API served by every Agora402 seller: free discovery documents, a free
    quote endpoint, and paid endpoints gated by x402 and settled on Hedera
    through the Blocky402 facilitator. Typical agent flow: getManifest (what is
    sold, at what price, paid to which account) -> requestQuote (lock a signed
    price, counter below list if you like) -> call the paid endpoint with the
    quoteId. The first call answers 402 with a PAYMENT-REQUIRED header; the
    retry carries PAYMENT-SIGNATURE; the response carries PAYMENT-RESPONSE with
    the Hedera transaction id. Then read listReceipts or the seller's HCS
    receipts topic to audit what was charged. All amounts are decimal strings in
    atomic units of the asset (tinybars for HBAR, 8 decimals); timestamps are
    ISO 8601 unless stated; quote expiry is unix seconds.
servers:
  - url: http://localhost:4402
    description: Local services seller (npm run dev)
  - url: http://localhost:4404
    description: Local auditor (npm run dev)
security: []
tags:
  - name: Discovery
    description: Free documents that describe the seller. Read these before paying anyone.
  - name: Negotiation
    description: Free, signed, time-limited price quotes.
  - name: Paid services
    description: x402-gated endpoints. Every call is a Hedera micropayment.
  - name: Trust
    description: Paid audits of other sellers, attested on the HCS audit topic.
  - name: Receipts
    description: What this seller has been paid for.
paths:
  /health:
    get:
      tags:
        - Discovery
      summary: Health
      description: >-
        Liveness and configuration summary. receiptsToHcs false means the seller
        runs without a receipts topic, so settled payments are only visible in
        listReceipts for as long as the process lives; auditsToHcs false means
        an auditor's attestations are dry runs and a buyer's trust policy will
        not see them.
      operationId: getHealth
      responses:
        '200':
          description: Health
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Health'
              example:
                status: ok
                uaid: >-
                  uaid:aid:2NEpo7TZRRrLZSi2U;uid=agora-demo-seller;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.5001234;domain=localhost:4402
                network: hedera:testnet
                facilitator: https://api.testnet.blocky402.com
                llm: groq
                receiptsToHcs: true
                role: services
                auditsToHcs: false
components:
  schemas:
    Health:
      type: object
      required:
        - status
        - uaid
        - network
        - facilitator
        - llm
        - receiptsToHcs
        - role
        - auditsToHcs
      properties:
        status:
          type: string
          enum:
            - ok
        uaid:
          $ref: '#/components/schemas/Uaid'
        network:
          $ref: '#/components/schemas/Network'
        facilitator:
          type: string
          format: uri
        llm:
          type: string
          description: 'LLM provider name: groq, anthropic or mock'
        receiptsToHcs:
          type: boolean
          description: true when receipts are published to the receipts topic
        role:
          type: string
          enum:
            - services
            - auditor
            - both
          description: Which endpoints this process sells
        auditsToHcs:
          type: boolean
          description: true when audits are recorded on the audit topic
    Uaid:
      type: string
      pattern: '^uaid:'
      description: HCS-14 universal agent id
      example: >-
        uaid:aid:2NEpo7TZRRrLZSi2U;uid=agora-demo-seller;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.5001234;domain=localhost:4402
    Network:
      type: string
      enum:
        - hedera:testnet
        - hedera:mainnet
      description: CAIP-2 network id

````