> For the complete documentation index, see [llms.txt](https://docs.drops.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.drops.bot/api-reference/error-responses.md).

# Error Responses

#### 400 Bad Request - Invalid Address

```json
{
  "success": false,
  "error": "Invalid address format"
}
```

#### 401 Unauthorized - Missing/Invalid API Key

```json
{
  "success": false,
  "error": "API key required in header"
}
```

#### 402 Forbidden - Insufficient credits

```json
{
  "success": false,
  "error": "Insufficient credits"
}
```

#### 403 Forbidden - Insufficient Paid Endpoint Permission

```json
{
  "success": false,
  "error": "Paid endpoints require credit billing to be enabled"
}
```

#### 403 Forbidden - Insufficient API Key Permissions 

```json
{
  "success": false,
  "error": "API key not authorized for this endpoint"
}
```

#### 404 Not Found - Request path invalid

```json
{
  "success": false,
  "error": "Not found"
}
```

#### 404 Not Found - Unsupported Network

```json
{
  "success": false,
  "error": "Network not supported"
}
```

#### 429 Rate Limit Exceeded

```json
{
  "success": false,
  "error": "Rate limit exceeded"
}
```

#### 500 Internal Server Error - API Unavailable

```json
{
  "success": false,
  "error": "External service unavailable"
}
```