> 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.

This problem occurs when you exceed the rate limit for a particular API end-point.

See [rate limiting](/docs/api/rate-limiting) for more information.

## Troubleshooting

* You should look at the `Retry-After` header and wait until that amount of seconds has passed
  before retrying the request.

## Example error

```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"
}
```