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

# Status Codes & Rate Limiting

> This is a list of status codes used by TMDB.

## Success Codes

| Code | HTTP Status | Message                                                                  |
| :--- | :---------- | :----------------------------------------------------------------------- |
| 1    | 200         | Success.                                                                 |
| 12   | 201         | The item/record was updated successfully.                                |
| 13   | 200         | The item/record was deleted successfully.                                |
| 21   | 200         | <b>Entry not found:</b> The item you are trying to edit cannot be found. |
| 40   | 200         | Nothing to update.                                                       |

## Error Codes

| Code | HTTP Status | Message                                                                               |
| :--- | :---------- | :------------------------------------------------------------------------------------ |
| 2    | 501         | Invalid service: this service does not exist.                                         |
| 3    | 401         | Authentication failed: You do not have permissions to access the service.             |
| 4    | 405         | Invalid format: This service doesn't exist in that format.                            |
| 5    | 422         | Invalid parameters: Your request parameters are incorrect.                            |
| 6    | 404         | Invalid id: The pre-requisite id is invalid or not found.                             |
| 7    | 401         | Invalid API key: You must be granted a valid key.                                     |
| 8    | 403         | Duplicate entry: The data you tried to submit already exists.                         |
| 9    | 503         | Service offline: This service is temporarily offline, try again later.                |
| 10   | 401         | Suspended API key: Access to your account has been suspended, contact TMDB.           |
| 11   | 500         | Internal error: Something went wrong, contact TMDB.                                   |
| 14   | 401         | Authentication failed.                                                                |
| 15   | 500         | Failed.                                                                               |
| 16   | 401         | Device denied.                                                                        |
| 17   | 401         | Session denied.                                                                       |
| 18   | 400         | Validation failed.                                                                    |
| 19   | 406         | Invalid accept header.                                                                |
| 20   | 422         | Invalid date range: Should be a range no longer than 14 days.                         |
| 22   | 400         | Invalid page: Pages start at 1 and max at 500. They are expected to be an integer.    |
| 23   | 400         | Invalid date: Format needs to be YYYY-MM-DD.                                          |
| 24   | 504         | Your request to the backend server timed out. Try again.                              |
| 25   | 429         | Your request count (#) is over the allowed limit of (40).                             |
| 26   | 400         | You must provide a username and password.                                             |
| 27   | 400         | Too many append to response objects: The maximum number of remote calls is 20.        |
| 28   | 400         | Invalid timezone: Please consult the documentation for a valid timezone.              |
| 29   | 400         | You must confirm this action: Please provide a confirm=true parameter.                |
| 30   | 401         | Invalid username and/or password: You did not provide a valid login.                  |
| 31   | 401         | Account disabled: Your account is no longer active. Contact TMDB if this is an error. |
| 32   | 401         | Email not verified: Your email address has not been verified.                         |
| 33   | 401         | Invalid request token: The request token is either expired or invalid.                |
| 34   | 404         | The resource you requested could not be found.                                        |
| 35   | 401         | Invalid token.                                                                        |
| 36   | 401         | This token hasn't been granted write permission by the user.                          |
| 37   | 404         | The requested session could not be found.                                             |
| 38   | 401         | You don't have permission to edit this resource.                                      |
| 39   | 401         | This resource is private.                                                             |
| 41   | 422         | This request token hasn't been approved by the user.                                  |
| 42   | 405         | This request method is not supported for this resource.                               |
| 43   | 502         | Couldn't connect to the backend server.                                               |
| 44   | 500         | The ID is invalid.                                                                    |
| 45   | 403         | This user has been suspended.                                                         |
| 46   | 503         | The API is undergoing maintenance. Try again later.                                   |
| 47   | 400         | The input is not valid.                                                               |

## Rate Limiting

<Card icon="book" horizontal title="Legacy Rate Limits">
  As of December 16, 2019, the original API rate limit (40 requests every 10 seconds) has been disabled.
  For any questions, please visit our [API support forum](https://www.themoviedb.org/talk/category/5047958519c29526b50017d6).
</Card>

Although the legacy rate limits have been disabled, we still enforce upper limits to prevent excessive bulk scraping.
The current rate limit is 50 requests per second.
You may receive a `429` status code if you exceed or misuse the API.

<Warning>
  This limit is subject to change at any time. Please use the service responsibly.
</Warning>
