← Docs API Reference

Errors.

All errors return a consistent JSON structure with a machine-readable code, a human-readable message, and optional field-level details.

Error Format

Error Response

{
  "error": "validation_failed",
  "message": "Missing required field: effective_date",
  "details": {
    "field": "effective_date",
    "rule": "required"
  }
}

HTTP Status Codes

200 Success

201 Created

400 Bad Request (validation failed)

401 Unauthorized (missing or invalid token)

403 Forbidden (insufficient role)

404 Not Found

409 Conflict (idempotency key collision)

422 Unprocessable (business rule violation)

429 Rate Limited

500 Internal Server Error

Rate Limiting

Sandbox: 100 requests/minute. Production: 1,000 requests/minute (configurable per plan). Rate limit headers are included in every response: X-RateLimit-Remaining, X-RateLimit-Reset.