> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poix.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> List of error codes and messages

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.

```json theme={null}
{
  "error": {
    "message": "Bad Request",
    "code": "BAD_REQUEST",
    "statusCode": 400
  }
}
```

### Forbidden

The client does not have permission to access the requested resource.

```json theme={null}
{
  "error": {
    "message": "Forbidden",
    "code": "FORBIDDEN",
    "statusCode": 403
  }
}
```

### Balance exhausted

The client's balance is exhausted.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```typescript theme={null}
{
  success: boolean;
  error: {
    name: 'ZodError';
    issues: {
        code: string;
        maximum: number;
        type: string;,
        inclusive: boolean;
        exact: boolean;
        message: string;
        path: string[];
    }[];
  };
};
```