Reference

Errors

Consistent shape across every endpoint.

Error shape

json

{
  "error": "invalid_amount",
  "message": "amount_minor must be a positive integer"
}

Status codes

200OKSuccessful request

400Bad requestInvalid payload or parameter

401UnauthorizedMissing or invalid API key

403ForbiddenKey lacks permission for this resource

404Not foundResource does not exist or is not visible to your account

409ConflictIdempotency key reused with a different payload

422UnprocessableRequest is well-formed but semantically invalid

429Too many requestsRate limit exceeded, retry with backoff

500Server errorSomething went wrong on our side. Safe to retry.

Idempotency

All mutating endpoints accept Idempotency-Key. Same key + same payload replays the original response for 24 hours. Same key + different payload returns 409 conflict.

Rate limits

Default: 100 requests per second per key, burst 200. On 429, the retry-after header tells you when to try again.