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

# API Reference

> Moca Network REST API reference — server-to-server endpoints for credential issuance, issuance status, catalog browsing, and partner operations.

The Moca Network REST API enables server-to-server operations that do not require user presence. Use it for backend automation, bulk credential issuance, programmatic status checks, and browsing the credential catalog.

## Base URLs

| Environment | Base URL                                    |
| ----------- | ------------------------------------------- |
| Sandbox     | `https://api.sandbox.mocachain.org/v1`      |
| Production  | `https://mocachain-mainnet.api.air3.com/v1` |

## Authentication

**Credential endpoints** require a **Partner JWT** passed in the `x-partner-auth` header. The JWT must be signed with your private key (RS256 or ES256) and include:

| Claim       | Required | Description                                   |
| ----------- | -------- | --------------------------------------------- |
| `partnerId` | Yes      | Your Partner ID from the Developer Dashboard  |
| `email`     | Yes      | Target user's email address                   |
| `scope`     | Yes      | Operation scope (e.g. `"issue on-behalf"`)    |
| `exp`       | Yes      | Expiration timestamp (recommended: 5 minutes) |

The JWT header must include `kid` (Key ID) matching a key in your JWKS endpoint and `typ: "JWT"`.

For full setup instructions, key generation, and code examples see [Partner Authentication](/airkit/usage/partner-authentication).

**Catalog endpoints** are public and require no authentication.

**API Playground:** Requests from the Try it out playground are sent directly from your browser to the API. Your API must allow CORS from your docs origin (e.g. your Mintlify subdomain or custom domain) for the playground to work. If you see 403 from the playground, check that the API allows the request origin and that your Partner JWT is valid.

## Credentials

<CardGroup cols={2}>
  <Card title="Issue credential on behalf" icon="certificate" href="/api-reference/credentials/issue-credential-on-behalf">
    Submit server-side credential issuance for a user without requiring their active session.
  </Card>

  <Card title="Check issuance status" icon="circle-check" href="/api-reference/credentials/get-credential-status">
    Poll the status of an asynchronous credential issuance until it is confirmed on-chain.
  </Card>
</CardGroup>

## Catalog

<Warning>
  **Sandbox only at this stage.** Catalog endpoints are available exclusively on `https://api.sandbox.mocachain.org/v1` during the pilot. They are under active development and may change without notice — not yet available in production.
</Warning>

<CardGroup cols={2}>
  <Card title="Browse schemas" icon="table-layout" href="/api-reference/catalog/browse-schemas">
    Paginated list of credential schemas with credential count and number of issuers. Sortable by popularity or title.
  </Card>

  <Card title="Schema detail" icon="table-layout" href="/api-reference/catalog/schema-detail">
    Single schema with every credential built on it, including issuer info and traction metrics.
  </Card>

  <Card title="Credential detail" icon="id-badge" href="/api-reference/catalog/credential-detail">
    Full credential profile: data points, issuer identity, holder/issuance/verification metrics, linked programs, and availability window.
  </Card>

  <Card title="Browse programs" icon="list-check" href="/api-reference/catalog/browse-programs">
    Paginated list of verification programs with verification counts and accepted credential types.
  </Card>

  <Card title="Program detail" icon="list-check" href="/api-reference/catalog/program-detail">
    Verification program with verifier identity, pricing model, accepted credentials, and ZK verification conditions.
  </Card>

  <Card title="Search catalog" icon="magnifying-glass" href="/api-reference/catalog/search-catalog">
    Full-text search across credentials, issuers, and programs with relevance-ranked grouped results.
  </Card>
</CardGroup>

## Code examples

For end-to-end integration examples including issue-and-poll flows, webhook-driven issuance, and retry logic, see [Issue on Behalf API & Examples](/airkit/usage/credential/issue-on-behalf-api).