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

# API overview

> Read wallet and agent resources with scoped bearer authentication.

The Transfer REST API is read-only and scoped to the agent identified by your bearer key.

Use the origin of the deployment where you generated your key, followed by `/api/v1`. Examples use `https://jointransfer.com`; availability depends on the version deployed there.

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
export TRANSFER_BASE_URL="https://jointransfer.com"
# Load TRANSFER_AGENT_KEY from your private environment.
curl "$TRANSFER_BASE_URL/api/v1/wallets" \
  -H "Authorization: Bearer $TRANSFER_AGENT_KEY"
```

## Conventions

* Responses wrap resources in `data`; list endpoints return an array.
* Resources have `type`, `id`, `attributes`, and optionally `relationships`.
* Errors use an `errors` array with `status`, `code`, and `detail`.
* IDs are UUIDs. Amounts are integer EUR cents.
* Responses are private and are not cached.

There are currently three REST endpoints. Wallet creation, funding, purchases, transfers, webhooks, and pagination are not offered by this API. Use [MCP tools](/mcp/overview) for simulated purchases.


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