Reference

Error Codes

All API errors return standard HTTP status codes with a JSON body containing an error message and code field.

Error response shape

json

{ "error": "Resource not found", "code": 404 }

400Bad RequestMissing or invalid parameters. Check the error message for details.

401UnauthorizedMissing, invalid, or revoked API key.

404Not FoundThe requested resource does not exist or belongs to a different account.

429Too Many RequestsRate limit exceeded. See the Retry-After header.

500Internal Server ErrorUnexpected error on Callix's side. Retrying after a short delay is safe.

Rate limiting is planned but not yet enforced in v1. The limits below will apply once enforced:

Per-key (per minute)1,000 requests

Per-account (per day)10,000 requests

When limits are exceeded, the server returns 429 with a Retry-After header. Rate limit headers will be included on every response:

http

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1748001600000