Error Handling

The API uses standard HTTP status codes to indicate success or failure of requests.

Common Status Codes

Code	Description
200	Success
400	Bad Request - Invalid input parameters
401	Unauthorized - Missing or invalid API key
403	Forbidden - Insufficient scope for requested operation
422	Validation Error - Request data failed validation
500	Internal Server Error

Error Response Format

{
  "error": "Error message describing the issue"
}

For bulk requests, errors may be included in the response's errors array:

{
  "status": 200,
  "items": [...],
  "errors": [
    {
      "identifier": "invalid address",
      "error": "Address not found",
      "error_type": "NotFoundError",
      "index": 1
    }
  ],
  "metadata": {
    "total_requested": 3,
    "successful": 2,
    "failed": 1
  }
}