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

# API

> The BMONI Embedded REST API — interactive reference hosted at embedded.bmoni.com.

The BMONI API is the backend that powers the embedded wallet product. It exposes endpoints for wallet provisioning, balance queries, transaction history, and money movement across the [supported regions](/api-reference/supported-regions) — the US, Nigeria, Canada, Europe, Mexico, and wider LATAM.

<Info>
  The full interactive API reference — including all endpoints, request/response schemas, and a live **Try it** console — is hosted separately at **[embedded-dev.bmoni.com/docs](https://embedded-dev.bmoni.com/docs)**.
</Info>

<Card title="Open the API reference" icon="arrow-up-right-from-square" href="https://embedded-dev.bmoni.com/docs">
  View all endpoints, schemas, and try requests live in the Scalar API reference.
</Card>

***

## Base URL

Production:

```
https://embedded.bmoni.com
```

Development / Sandbox:

```
https://embedded-dev.bmoni.com
```

For sandbox testing you can use the shared key **`pk_a025cacbf33a_76fb864113f3540909de5b1da39cc146906e35b1c6d4d1e4`** as your `x-api-key`. It only works against the development base URL — get your own key before you touch production.

***

## Authentication

All API requests require your partner API key in the `x-api-key` header:

```http theme={null}
x-api-key: <your_api_key>
```

Organizations should email [developers@bkey.me](mailto:developers@bkey.me) to get their own sandbox API key. Individuals exploring the API can use the [shared sandbox key](#base-url) above instead.

***

## Implementing `EmbeddedWalletReadDataSource`

If you are using `bmoni_embedded_wallets_cards`, implement `EmbeddedWalletReadDataSource` against the API endpoints documented at the reference link above. The contract interface is defined in [Data contracts](/wallets/data-contracts).