---
updatedAt: 2026-08-03T14:43:16.000Z
---

Fetch the complete documentation index at: https://docs.apollo.io/llms.txt. Use this file to discover all available pages before exploring further.

# Status Codes and Errors

When interacting with Apollo API endpoints, it helps to understand the status codes that might be returned.

To find a status code for an endpoint:

1. Go to the reference documentation for an endpoint such as [People API Search](https://docs.apollo.io/docs/people-api-search).
2. By default, the **Response** section of the reference docs shows an example response with a `200` status. To view other status codes, click the **EXAMPLE** drop-down, then select a status code.
3. The status you select appears in the response section.

You don't need to supply an API key to review the Apollo-generated example response or other status codes. Check out [How to Test API Endpoints](https://docs.apollo.io/reference/how-to-test-api-endpoints) to perform your own testing and generate unique responses.

![Find API status codes in Apollo documentation.](https://storage.googleapis.com/apollo-public-assets/kb_images/api_status_codes/i1.png)

## Common status codes

Most Apollo API endpoints share the following status codes. Some endpoints return additional, endpoint-specific codes and error messages — always check the **Response** examples on that endpoint's reference page for exact details.

| Status code | Meaning               | Common cause                                                                                                                                                                                                                           | `error_code`                                 |
| ----------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| `401`       | Unauthorized          | Your API key or access token is missing or invalid, or your account is no longer active. See [Authentication](https://docs.apollo.io/reference/authentication).                                                                        | `INVALID_ACCESS_TOKEN` (OAuth access tokens) |
| `403`       | Forbidden             | Your plan doesn't include API access, or the endpoint isn't available through the public API for your credentials. [Contact Apollo](https://app.apollo.io/#/settings/account?nextStep=redirecttochat) if you believe this is an error. | `API_INACCESSIBLE`                           |
| `404`       | Not found             | The requested record doesn't exist or isn't accessible with your credentials. Double-check the ID in your request.                                                                                                                     | —                                            |
| `422`       | Unprocessable entity  | Your request was received but couldn't be processed — usually a validation error or an invalid or missing parameter. The response body describes the specific issue; the exact shape varies by endpoint.                               | varies by endpoint                           |
| `429`       | Too many requests     | You've exceeded your rate limit. Rate-limit details are returned in the response headers. See [Rate Limits](https://docs.apollo.io/reference/rate-limits).                                                                             | —                                            |
| `500`       | Internal server error | An unexpected error occurred on Apollo's side. Retry the request; if it persists, [contact Apollo](https://app.apollo.io/#/settings/account?nextStep=redirecttochat).                                                                  | —                                            |

> 📘 Status Report
>
> Not all API status codes are currently documented by Apollo. This documentation contains the most common codes.