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

# API Reference

> Nuvera REST API for partner server-to-server integrations

The Nuvera REST API provides partner organizations with server-to-server access to customers, beneficiaries, documents, payment reference data, payments, screening reads, and support workflows.

Only partner organizations can use the REST API layer. Customer-platform users do not receive API applications or API keys. Nuvera admins can manage partner API applications only for support, emergency disablement, permission correction, and partner-assisted key rotation.

## Base URL

```
https://api.nuvera.global
```

## Authentication

Every REST request must include both headers:

```http theme={null}
x-api-key: <your-api-key>
Authorization: Bearer <signed-request-jwt>
```

The API key identifies the API application. The signed JWT proves possession of the partner-held RSA private key and binds the request method, exact path and query string, short expiration, replay nonce, and request body hash.

Endpoint security schemes are generated from the Nest REST decorators when the API dev server starts. Do not hand-edit `docs/api-reference/openapi.json`; use the guide pages for human signing and rotation instructions, and use the generated endpoint pages for request and response schemas.

<CardGroup cols={3}>
  <Card title="Create API Application" icon="plus" href="/get-started/partner-api/create-api-application">
    Set up the application, public signing key, permissions, and first one-time API key.
  </Card>

  <Card title="Request Signing" icon="signature" href="/get-started/partner-api/request-signing">
    Build the RS256 JWT required for each REST API call.
  </Card>

  <Card title="Key Rotation" icon="rotate" href="/get-started/partner-api/key-rotation">
    Replace API keys and signing keys without exposing old secrets.
  </Card>
</CardGroup>

## Resources

<CardGroup cols={2}>
  <Card title="Customers" icon="users">
    Create and manage business customers with KYB verification.
  </Card>

  <Card title="Beneficiaries" icon="building-columns">
    Add payment recipients with bank account details.
  </Card>

  <Card title="Payments" icon="money-bill-transfer">
    Initiate and track cross-border payments.
  </Card>

  <Card title="Documents" icon="file-arrow-up">
    Upload and manage compliance documents.
  </Card>
</CardGroup>