> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trophy.so/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).

<h2 id="authentication-errors">
  Authentication errors
</h2>

| 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) set up |

<h2 id="rate-limiting">
  Rate limiting
</h2>

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

<h2 id="retry-guidance">
  Retry guidance
</h2>

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

<h2 id="get-support">
  Get Support
</h2>

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.