Status & Error Codes

The Teachable API uses HTTP status codes to indicate if an error has occurred when processing a request. Errors might occur if your request was not formatted correctly, you didn’t include proper authentication, or if there was any other error in processing the request.

Common error codes include:

Status Code	Reason	Description
400	Bad request	The request has an error. Invalid JSON, a parameter of the wrong type, an unknown query filter, or a missing required parameter.
402	Payment required	Your school's plan does not include access to this API. Upgrade the plan to continue.
403	Forbidden	The API key is missing, invalid, revoked, or expired; the school is blocked; API v2 is not enabled for the school; or the key lacks a scope this endpoint requires.
404	Not found	The resource does not exist, or is not visible to your school.
409	Conflict	The request conflicts with the current state of the resource.
422	Validation failed	The request was well-formed, but violates a business rule.
429	Too many requests	You have exceeded the rate limit. Back off and retry.
500	Internal server error	The server encountered an unexpected condition that prevented it from fulfilling the request.
502	Bad gateway	A downstream service failed while handling the request. Safe to retry.