Getting started

Errors

Errors use conventional status codes and always carry a JSON body with a message. Validation errors add an errors object keyed by field.

401 Missing or invalid API key.
404 No such object for this account. Other accounts' objects are never revealed.
409 The action is not allowed in the object's current state, e.g. cancelling a paid charge. Also when an Idempotency-Key is reused for a different request, or while the first request carrying it is still being worked on.
422 Validation failed; see errors.
429 Rate limit exceeded; retry after the Retry-After header.
HTTP/1.1 422 Unprocessable Content
{
  "message": "The selected asset is invalid. (and 1 more error)",
  "errors": {
    "asset": ["The selected asset is invalid."],
    "amount": ["The amount field is required."]
  }
}