Error Codes
Complete reference of Talonic API error codes with HTTP status, retryable classification, and recommended handling for each error type.
Error codes returned by the Talonic API, grouped by whether they are retryable:
Permanent errors (do not retry)
Retryable errors (retry with backoff)
Recommended backoff strategy
For retryable errors, use exponential backoff with jitter:
Add random jitter (±20%) to avoid thundering herd. For 429 errors specifically, respect the X-RateLimit-Reset header instead of using fixed backoff — it tells you exactly when the window resets (ISO 8601 timestamp, midnight UTC).
The API does not send a
Retry-After header. For rate limits, use X-RateLimit-Reset to determine when to retry. For other retryable errors, use exponential backoff.