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

# API reference

> Base URLs, authentication and conventions.

## Base URLs

| Service | URL |
| - | - |
| API | `https://api.talescria.com` |
| Access tokens | `https://idp.talescria.com/oauth/token` |
| Hosted checkout | `https://pay.talescria.com` |

The same URLs serve test and live. Your access token decides which environment a request acts in: see [Environments](https://docs.talescria.com/concepts/environments.md).

## Authentication

Send an access token from your OAuth client as a bearer token:

```bash theme={null}
curl https://api.talescria.com/v1/accounts \
  -H "Authorization: Bearer at_test_…"
```

[Get an access token](https://docs.talescria.com/api-reference/get-an-access-token.md) explains how. Each operation lists the scope it needs.

## Conventions

* Requests and responses are JSON (`Content-Type: application/json`).
* Amounts are integer strings in minor units: see [Money](https://docs.talescria.com/concepts/money.md).
* Timestamps are milliseconds since the Unix epoch.
* Writes that create something or move money require an `Idempotency-Key` header: see [Idempotency](https://docs.talescria.com/concepts/idempotency.md).
* Every response has an `x-request-id` header.
* Errors look like `{"error": {"code": "…", "message": "…"}}`: see [Errors and limits](https://docs.talescria.com/concepts/errors.md).


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