Use error codes to troubleshoot issues with your API requests. Here’s a list of all available error codes and messages.
Bad Request
The client SHOULD NOT repeat the request without modifications.
{
"error": {
"message": "Bad Request",
"code": "BAD_REQUEST",
"statusCode": 400
}
}
Forbidden
The client does not have permission to access the requested resource.
{
"error": {
"message": "Forbidden",
"code": "FORBIDDEN",
"statusCode": 403
}
}
Balance exhausted
The client’s balance is exhausted.
{
"error": {
"message": "Balance exhausted. Please add funds to continue.",
"code": "BALANCE_EXHAUSTED",
"statusCode": 403
}
}
Token has been revoked
The client’s token has been revoked.
{
"error": {
"message": "Token has been revoked. Please contact token owner.",
"code": "TOKEN_REVOKED",
"statusCode": 403
}
}
Token has been deleted
The client’s token has been deleted.
{
"error": {
"message": "Token has been deleted. Create a new token to continue.",
"code": "TOKEN_DELETED",
"statusCode": 403
}
}
Too many requests
The client has sent too many requests in a given amount of time.
{
"error": {
"message": "Too many requests, please try again later.",
"code": "TOO_MANY_REQUESTS",
"statusCode": 429
}
}
Video not found
The requested video does not exist, is private, or has been removed by the user.
{
"error": {
"message": "Video does not exist, is private, or has been removed by the user.",
"code": "VIDEO_NOT_FOUND",
"statusCode": 404
}
}
Captions not found
The requested captions do not exist.
{
"error": {
"message": "No captions found for the specified video.",
"code": "NO_CAPTIONS_FOUND_FOR_VIDEO",
"statusCode": 404
}
}
Captions are disabled
The requested captions are disabled for the specified video.
{
"error": {
"message": "Captions are disabled for this video by the owner.",
"code": "CAPTIONS_DISABLED_FOR_VIDEO",
"statusCode": 403
}
}
Audio files not found
The requested audio files do not exist.
{
"error": {
"message": "No audio files found for the specified video.",
"code": "NO_AUDIO_FILES_FOUND_FOR_VIDEO",
"statusCode": 404
}
}
Video files not found
The requested video files do not exist.
{
"error": {
"message": "No video files found for the specified video.",
"code": "NO_VIDEO_FILES_FOUND_FOR_VIDEO",
"statusCode": 404
}
}
Video is harmful
The requested video is harmful or not available.
{
"error": {
"message": "Video is harmful or not available.",
"code": "VIDEO_IS_HARMFUL_OR_NOT_AVAILABLE",
"statusCode": 403
}
}
Video does not available
Video is available for specific groups only.
{
"error": {
"message": "Video is available for specific groups only.",
"code": "VIDEO_AVAILABLE_FOR_SPECIFIC_GROUPS_ONLY",
"statusCode": 403
}
}
Schema error
The request params or body does not match the schema.
{
success: boolean;
error: {
name: 'ZodError';
issues: {
code: string;
maximum: number;
type: string;,
inclusive: boolean;
exact: boolean;
message: string;
path: string[];
}[];
};
};
