> ## 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!


## Related topics

- [Retries](/webhooks/retries.md)
- [Authentication](/api-reference/authentication.md)
- [Introduction](/api-reference/introduction.md)
- [Events](/features/events.md)
- [Production Checklist](/getting-started/production-checklist.md)