Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Access token from POST /v1/auth/token, sent as Authorization: Bearer <token>. Treat it as opaque.

Headers

If-None-Match
string | null

An ETag from an earlier response; answers 304 when current.

Query Parameters

outlet_id
string<uuid> | null

Outlet to list currencies for. Defaults to your DEFAULT outlet. A malformed UUID is rejected with 400.

Response

Successful Response

Standard success envelope. Every successful response has this shape, with the operation's own payload under data.

data
MerchantCurrencyListResponse · object | null

The operation's result. Its shape is documented per operation; omitted on responses that carry no payload.

message
string | null

Optional human-readable note. Omitted from the response when not set, which is the case for every payment operation today. Never parse it.

request_id
string | null

Correlation ID for this HTTP request, for logs and support. Send your own in the X-Request-Id header (letters, digits and hyphens, up to 36 characters -- other characters are stripped) or the gateway generates one. This is NOT the request_id idempotency key you send in a transaction body; the two are unrelated.

status
string
default:ok

Always ok on a successful (2xx) response. Errors use a different body shape entirely (RFC 9457 problem details), so branch on the HTTP status code, not on this field.