Errors from the API will always be in JSON format. Here are some possible errors and their associated HTTP status codes.


Error Code Example Response
403 {"error": "Authentication error, API token missing/invalid"}
404 {"error": "Requested endpoint not found"}
429 {"error": "Too many requests - throttled"}
500 {"error": "Server error, developers have been alerted"}

Transcripts that fail processing

When a transcript fails processing a GET  /transcripts/{id} will still return HTTP status code 200, but with empty text in the response body and an error key explaining the issue.