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

# API reference

> Every Mesh endpoint, with a playground.

Each page in this section is generated from Mesh's OpenAPI description, with a playground to try the call.

## Base URL

```
https://<your bank's Mesh host>/v1
```

Your bank gives you the host. One URL serves test and live; the key decides which.

## Authentication

Send your key in the `X-Api-Key` header, from an address on the key's allowlist. In the playground, use a **test** key. See [Authentication](https://docs.mesh.larkwave.org/essentials/authentication.md).

## Conventions

| | |
| - | - |
| Format | JSON in and out, `snake_case` fields |
| Amounts | Integers in kobo: `amount_minor: 150000` is ₦1,500.00 |
| Times | ISO 8601, UTC |
| Creates | Need an `Idempotency-Key` header: see [Idempotency](https://docs.mesh.larkwave.org/essentials/idempotency.md) |
| Lists | Newest first, `limit` and `cursor`: see [Pagination](https://docs.mesh.larkwave.org/essentials/pagination.md) |
| Responses | `success`, `data`, `message`, `request_id`, and `code` on failure: see [Responses and errors](https://docs.mesh.larkwave.org/essentials/responses-and-errors.md) |
| Permissions | Each endpoint lists the permission and feature it needs |


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