Skip to content

Errors

Every error has the same shape:

{ "error": { "type": "invalid_request_error", "code": "parameter_invalid", "message": "display_name: Too small",
"param": "display_name", "request_id": "req_...", "doc_url": "https://docs.rivecard.com/errors/#parameter_invalid" } }
type HTTP meaning
invalid_request_error 400 bad parameters (parameter_invalid, cursor_invalid, controls_invalid, …)
authentication_error 401 missing/invalid credential (api_key_invalid, token_invalid, code_invalid, …)
permission_error 403 role too low, csrf_token_invalid, origin_not_allowed, live_mode_disabled
not_found_error 404 resource_missing, route_not_found
conflict_error 409 card_closed, idempotency_in_progress, member_exists
idempotency_error 422 idempotency_key_reused — same key, different request
rate_limit_error 429 rate_limited — honour Retry-After
issuer_error 502/503 not_configured — the issuer isn’t set up yet
api_error 500 our fault; send us the request_id