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

> ## Agent Instructions
> Rail402 is an x402 payment facilitator, Stellar-native Bazaar discovery layer, and agent tooling for the Stellar network. It currently targets stellar:testnet.
> The live testnet facilitator is https://facilitator.rail402.dev with endpoints /verify, /settle, /supported, /health, and /discovery/*.
> Payment amounts use 7-decimal SEP-41 integer (stroop) arithmetic. Never use floating-point math for amounts.
> Every rejection returns a machine-readable error code and a non-null human-readable reason. When explaining a failure, surface both.

# Health and catalog storage status



## OpenAPI

````yaml /api-reference/facilitator.openapi.yaml get /health
openapi: 3.1.0
info:
  title: Rail402 Facilitator API
  version: '2.0'
  license:
    name: Apache-2.0
    identifier: Apache-2.0
  description: >
    The Rail402 x402 facilitator and Bazaar discovery layer on
    `stellar:testnet`.

    Verify and settle x402 payments, read what the facilitator supports, and
    browse or

    search the discovery catalog. Speaks the x402 v2 wire format, so a stock
    `@x402` client

    interoperates with no Rail402-specific code.


    Amounts are integer strings in atomic units at 7 decimals: one USDC is
    `10000000`, so

    `500000` is 0.05 USDC. Every rejection carries a machine `code`, a non-null
    `reason`, and a

    `retryable` flag.
servers:
  - url: https://facilitator.rail402.dev
    description: stellar:testnet
security: []
tags:
  - name: Payments
    description: Verify and settle payments
  - name: Discovery
    description: Browse and search the Bazaar catalog
  - name: Info
    description: Capabilities, health, and metrics
paths:
  /health:
    get:
      tags:
        - Info
      summary: Health and catalog storage status
      operationId: getHealth
      responses:
        '200':
          description: Always returned, even when catalog persistence is degraded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
              example:
                status: ok
                uptimeSeconds: 169525
                networks:
                  - stellar:testnet
                signers: 1
                feeBump: disabled
                catalog:
                  entries: 8
                  storage: durable
components:
  schemas:
    HealthResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - ok
            - degraded
        uptimeSeconds:
          type: integer
        networks:
          type: array
          items:
            type: string
        signers:
          type: integer
        feeBump:
          type: string
          enum:
            - enabled
            - disabled
        catalog:
          type: object
          properties:
            entries:
              type: integer
            storage:
              type: string
              enum:
                - memory
                - durable
                - degraded

````