Skip to main content
GET
List Routings
Lists the routings configured on an account. Each item returns the routing’s current live configuration, with the same shape as Retrieve a Routing. Pass payment_method to list only the routings for that payment method, and omit it to list all of them.

Query Parameters

account_id
string
required
The account to list routings for. Must belong to the organization your API credentials are scoped to.
payment_method
enum
Optional filter by payment method (e.g., CARD, PIX). Same values as the payment_method field in routing responses.

Response

The routings configured on the account, or an empty array if it has none. Each routing contains:
id
string
Unique identifier for the routing.
account_id
string
Unique identifier for the account.
payment_method
enum
The payment method this routing applies to (e.g., CARD).
name
string
Label for the routing.
default_route
object
The default routing logic.
condition_sets
object[]
Optional conditional logic.
created_at
string
ISO 8601 timestamp.
updated_at
string
ISO 8601 timestamp.
warnings
string[]
Optional list of non-blocking orchestration warnings (e.g., MONITOR_REDISTRIBUTION_DEFERRED).

Errors

Authorizations

PUBLIC-API-KEY
string
header
default:<Your PUBLIC-API-KEY>
required
PRIVATE-SECRET-KEY
string
header
default:<Your PRIVATE-SECRET-KEY>
required

Query Parameters

account_id
string<uuid>
required

Account to list routings for. Must belong to the organization of your API credentials.

payment_method
string

Filter by payment method (e.g., CARD, PIX).

Example:

"CARD"

Response

The routings configured on the account, or an empty array if it has none.

id
string
Example:

"r_8f2c1d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"

account_id
string
Example:

"acc-uuid"

payment_method
string
Example:

"CARD"

name
string
Example:

"Card routing — Stripe primary, Adyen fallback"

default_route
object
condition_sets
object[]
created_at
string<date-time>
Example:

"2026-05-12T14:30:00Z"

updated_at
string<date-time>
Example:

"2026-05-12T14:30:00Z"