RobinReturn
Partner API

Rate limits

How RobinReturn Partner API rate limits work and how to back off when you hit them.

Per-company rate limits apply across the Partner API. When you exceed a limit, the API responds 429 with a Retry-After header.

Backing off

  • Read the Retry-After header (seconds) and wait at least that long before retrying.
  • Prefer batching over many small calls — POST /api/v1/cases accepts up to 100 cases per request, which is far more efficient than 100 single-case calls.
  • Use exponential back-off with jitter for repeated 429s.

Because case creation is idempotent, a backed-off retry is always safe.

Idempotency

Make Partner API case creation safe to retry with the Idempotency-Key header and the per-invoice duplicate guard.

Errors

The RobinReturn Partner API error model, HTTP statuses, and the per-case rejection codes returned when creating cases.

On this page

Backing off