Skip to main content
Below is a comprehensive list of all possible error codes you might encounter when using the Supadata API. Each error includes a description, HTTP status code, and a link to detailed documentation about how to handle it.

​
Error Reference Table

Error CodeDescriptionHTTP Status
Invalid RequestThe request is invalid or malformed400
UnauthorizedThe request is unauthorized. Please check your API key401
Upgrade RequiredThis feature is not available on your current plan402
Not FoundThe requested item could not be found404
Limit ExceededYou have exceeded the allowed request rate or quota limits429
Transcript UnavailableNo transcript is available for this video206
Internal ErrorAn internal server error occurred500

​
Error Response Format

All errors follow a consistent JSON response format: 
{
  "error": "error-code",
  "message": "Human readable error message",
  "details": "Detailed explanation of the error",
  "documentationUrl": "https://supadata.ai/errors/error-code"
}