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

# Error codes

> Common Trophy API HTTP status codes.

This page summarizes the HTTP status codes you will see most often when integrating with the Trophy Application API. For endpoint-specific behaviour and response schemas, see the [API reference](/api-reference/introduction.md).

## Authentication errors

| Status | When it happens | What to do |
| - | - | - |
| `401 Unauthorized` | The `X-API-KEY` header is missing or invalid | Create or rotate an application API key and verify [authentication](/api-reference/authentication.md) set up |

## Rate limiting

| Status | When it happens | What to do |
| - | - | - |
| `429 Too Many Requests` | Your organisation exceeded the endpoint [rate limit](/api-reference/rate-limiting.md) | Back off and retry; request a higher limit if needed |

## Retry guidance

* Retry `429` and `5xx` with exponential backoff.
* On retry, send the same idempotency key for the same logical action so Trophy does not double-count.
* Do not retry `401` until the API key is fixed.

## Get support

Want to get in touch with the Trophy team? Reach out to us via [email](mailto:support@trophy.so). We're here to help!


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