Error Reference

400 Bad Request

Invalid chart specification. Check the request body against the schema. Common causes:

• Missing required fields (type, data)
• Invalid chart type or format
• Dimensions outside 100–4000 px
• Too many labels, data points, or datasets

{
  "error": "Invalid chart specification",
  "details": [{ "path": "data.labels", "message": "At least 1 label is required" }]
}

401 Unauthorized

Missing or invalid authentication. Include Authorization: Bearer YOUR_API_KEY.

402 Payment Required

Usage quota exceeded for your plan. Upgrade or wait for the next billing period.

{
  "error": "Quota exceeded",
  "currentUsage": 50000,
  "limit": 50000,
  "plan": "pro"
}

429 Too Many Requests

Rate limit exceeded. Default: 100 requests per 15 minutes per API key or IP. Check Retry-After header.

{
  "error": "Rate limit exceeded",
  "retryAfter": 120
}

500 Internal Server Error

Server error during rendering. Include X-Request-Id when reporting issues.