Skip to main content

​
Errors

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

​
Error format

{
  "error": {
    "code": "not_found",
    "message": "Person 'abc123' not found",
    "status": 404
  }
}

​
Error codes

StatusCodeDescription
400bad_requestThe request was malformed or a reserved parameter was used
400validation_errorA query parameter has an invalid type or format
400invalid_cursorThe pagination cursor is invalid or expired
401unauthorizedMissing API key (X-API-Key header not provided)
403forbiddenInvalid or revoked API key
404not_foundThe requested resource doesn’t exist
429rate_limit_exceededRate limit exceeded — check Retry-After header
500internal_errorSomething went wrong on our end

​
Debugging

Every response includes an X-Request-Id header with a unique identifier. Include this ID when contacting support — it helps us trace the exact request in our logs. 
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