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.