> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.yoco.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.yoco.com/_mcp/server.

To ensure consistent performance and fair access to the API, reasonable rate limits are enforced on
API endpoints.

Whilst rate limits aren't published, reasonable limits have been applied based on intended use in
real-world applications.

If your application exceeds rate limits, an HTTP [429 Too Many Requests](https://http.dev/429)
status code is returned. The response contains a `Retry-After` header indicating the number of
seconds you need to wait before retrying the request. The response body also contains an error with
code [rate_limited](/docs/api/error-codes/rate-limited).

*Example:*

```json
{
  "type": "https://developer.yoco.com/docs/api/error-codes/rate-limited",
  "title": "Too Many Requests",
  "detail": "You have exceeded the rate limit for this API end-point.",
  "status": 429,
  "code": "rate_limited"
}
```

You should implement your own retry logic that gracefully handles 429 errors and respects the
`Retry-After` header.