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[];
    }[];
  };
};
TopicsGet search results