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	Entry not found: 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

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.

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.

This limit is subject to change at any time. Please use the service responsibly.