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

# ZeroClick API overview

> Pay-per-request, AI-agent-facing REST endpoints fronted by ZeroClick.

The ZeroClick agentic API is a conventional HTTP REST API under `/api/v1/*`,
fronted by the **ZeroClick** storefront. Agents pay at ZeroClick's pay URL;
ZeroClick verifies payment, HMAC-signs the request, and forwards it to the
Momentra upstream. The backend verifies the signature, checks the allowance,
serves, and settles usage.

## How a call flows

<Steps>
  <Step title="Agent pays at ZeroClick">
    The agent is issued a challenge and pays at the ZeroClick pay URL (paid
    routes only).
  </Step>

  <Step title="ZeroClick signs and forwards">
    ZeroClick HMAC-signs the request (`zc-signature`) and forwards it to the
    Momentra backend, preserving the path verbatim.
  </Step>

  <Step title="Momentra verifies and serves">
    The backend verifies the signature, checks the allowance for paid routes,
    serves, and settles usage via a `zc-usage` header on the `2xx`.
  </Step>
</Steps>

<Warning>
  Every REST request **must** include the full `/api/v1` prefix exactly as shown.
  Dropping it returns `403 Missing Authentication Token`. The `/api/v1` prefix is
  owned by the paths, not the base URL — the storefront base owns the host, the
  paths own the prefix.
</Warning>

## Connection

| | |
| - | - |
| **Storefront base** | `https://agents.momentra.org` (origin only — do **not** append `/api/v1`) |
| **Auth** | ZeroClick-signed request (`zc-signature`) with a registered agent, or `Authorization: Bearer <agent key>` on read routes |
| **Service slug** | `momentra-events` |
| **Billing** | ZeroClick per-request units; free routes do an identity check only |

<CardGroup cols={2}>
  <Card title="Endpoints" icon="list" href="/zeroclick/endpoints">
    The six `/api/v1/*` routes and their bodies.
  </Card>

  <Card title="The ZeroClick contract" icon="file-signature" href="/zeroclick/contract">
    Verify → check allowance → serve → settle.
  </Card>

  <Card title="Free and paid" icon="scale-balanced" href="/zeroclick/free-and-paid">
    The two kinds of free work and the credit parity.
  </Card>

  <Card title="Configuration" icon="gear" href="/zeroclick/configuration">
    Dashboard setup, SSM secrets, go-live checklist.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.