Understanding error responses and status codes in the Alladdin API.

🔢 HTTP status codes 📋 JSON error format ⏱️ Rate limiting

Overview

The Alladdin API uses standard HTTP status codes and returns error details in a consistent JSON format.

Error format

All error responses follow this structure:

{
  "type": "https://api.alladdin.com/problems/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested invoice was not found."
}

Status codes

400

Bad Request · Invalid parameters or malformed request body

401

Unauthorized · Missing or invalid API key

403

Forbidden · Valid API key but insufficient permissions

404

Not Found · The requested resource does not exist

422

Unprocessable Entity · Valid JSON but semantic validation failed

429

Too Many Requests · Rate limit exceeded. Wait and retry.

500

Internal Server Error · Something went wrong on our end

Rate limiting

The API allows 100 requests per minute per API key. When you exceed this limit, you'll receive a 429 response. Wait for the rate limit window to reset before retrying.