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

# Errors

> API error codes and how to handle them

The API uses standard HTTP status codes and returns errors in a consistent format.

## Error format

```json theme={null}
{
  "error": {
    "code": "not_found",
    "message": "Person 'abc123' not found",
    "status": 404
  }
}
```

## Error codes

| Status | Code | Description |
| - | - | - |
| 400 | `bad_request` | The request was malformed or a reserved parameter was used |
| 400 | `validation_error` | A query parameter has an invalid type or format |
| 400 | `invalid_cursor` | The pagination cursor is invalid or expired |
| 401 | `unauthorized` | Missing API key (X-API-Key header not provided) |
| 403 | `forbidden` | Invalid or revoked API key |
| 404 | `not_found` | The requested resource doesn't exist |
| 429 | `rate_limit_exceeded` | Rate limit exceeded — check `Retry-After` header |
| 500 | `internal_error` | Something went wrong on our end |

## Debugging

Every response includes an `X-Request-Id` header with a unique identifier. Include this ID when you email [support@trywildcard.ai](mailto:support@trywildcard.ai) — it helps us trace the exact request in our logs.

```bash theme={null}
curl -v -H "X-API-Key: mk_live_..." https://api-v1.maverickintelligence.co/v1/people

# Response headers:
# X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.