> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

# List Routings

> Lists all routings of an account, optionally filtered by payment method.

Lists the routings configured on an account. Each item returns the routing's current live configuration, with the same shape as [Retrieve a Routing](/reference/organizations/routing/retrieve-routing).

Pass `payment_method` to list only the routings for that payment method, and omit it to list all of them.

### Query Parameters

<ParamField query="account_id" type="string" required>
  The account to list routings for. Must belong to the organization your API credentials are scoped to.
</ParamField>

<ParamField query="payment_method" type="enum">
  Optional filter by payment method (e.g., `CARD`, `PIX`). Same values as the `payment_method` field in routing responses.
</ParamField>

### Response

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

<ResponseField name="id" type="string">
  Unique identifier for the routing.
</ResponseField>

<ResponseField name="account_id" type="string">
  Unique identifier for the account.
</ResponseField>

<ResponseField name="payment_method" type="enum">
  The payment method this routing applies to (e.g., `CARD`).
</ResponseField>

<ResponseField name="name" type="string">
  Label for the routing.
</ResponseField>

<ResponseField name="default_route" type="object">
  The default routing logic.
</ResponseField>

<ResponseField name="condition_sets" type="object[]">
  Optional conditional logic.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp.
</ResponseField>

<ResponseField name="warnings" type="string[]">
  Optional list of non-blocking orchestration warnings (e.g., `MONITOR_REDISTRIBUTION_DEFERRED`).
</ResponseField>

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
  curl -X GET 'https://api.y.uno/v1/routing?account_id=7825fc5e-e50a-4248-9ae8-5d3786afb0be&payment_method=CARD' \
    -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
    -H 'private-secret-key: <YOUR_SECRET_KEY>'
  ```

  ```json 200 OK theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
  [
    {
      "id": "r_8f2c1d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "account_id": "acc-uuid",
      "payment_method": "CARD",
      "name": "Card routing — Stripe primary, Adyen fallback",
      "default_route": {
        "steps": [
          {
            "index": 1,
            "provider_id": "STRIPE",
            "connection_id": "f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e",
            "output": [
              { "status": "DECLINE_GROUP", "next": 2 },
              { "status": "TIMEOUT",        "next": 2 }
            ]
          },
          { "index": 2, "provider_id": "ADYEN", "connection_id": "b2c4d5e6-..." }
        ]
      },
      "created_at": "2026-05-12T14:30:00Z",
      "updated_at": "2026-05-12T14:30:00Z"
    }
  ]
  ```

  ```json 400 Bad Request theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
  {
    "type": "invalid_request",
    "code": "ROUTING_VALIDATION_FAILED",
    "message": "account_id is required."
  }
  ```
</CodeGroup>

### Errors

<div className="code-nowrap-table dense-table">
  | HTTP  | `code`                      | When                                                                                 |
  | ----- | --------------------------- | ------------------------------------------------------------------------------------ |
  | `400` | `ROUTING_VALIDATION_FAILED` | Missing `account_id` query parameter.                                                |
  | `403` | `INSUFFICIENT_SCOPE`        | API key missing `routing:read`, or `account_id` belongs to a different organization. |
</div>


## OpenAPI

````yaml openapi/organizations/routing/list-routings.json GET /routing
openapi: 3.1.0
info:
  title: Routing API - List
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
security:
  - sec0: []
    sec1: []
paths:
  /routing:
    get:
      summary: List Routings
      description: >-
        Lists all routings of an account, optionally filtered by payment method.
        Each item has the same shape as Retrieve a Routing.
      operationId: list-routings
      parameters:
        - name: account_id
          in: query
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            Account to list routings for. Must belong to the organization of
            your API credentials.
        - name: payment_method
          in: query
          required: false
          schema:
            type: string
            example: CARD
          description: Filter by payment method (e.g., CARD, PIX).
      responses:
        '200':
          description: >-
            The routings configured on the account, or an empty array if it has
            none.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: r_8f2c1d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f
                    account_id:
                      type: string
                      example: acc-uuid
                    payment_method:
                      type: string
                      example: CARD
                    name:
                      type: string
                      example: Card routing — Stripe primary, Adyen fallback
                    default_route:
                      type: object
                      properties:
                        steps:
                          type: array
                          items:
                            type: object
                            properties:
                              index:
                                type: integer
                                example: 1
                              provider_id:
                                type: string
                                example: STRIPE
                              connection_id:
                                type: string
                                example: f1a3c4d5-...
                    condition_sets:
                      type: array
                      items:
                        type: object
                        properties:
                          sort_number:
                            type: integer
                            example: 1
                          name:
                            type: string
                            example: High Value US
                          conditions:
                            type: array
                            items:
                              type: object
                          route:
                            type: object
                    created_at:
                      type: string
                      format: date-time
                      example: '2026-05-12T14:30:00Z'
                    updated_at:
                      type: string
                      format: date-time
                      example: '2026-05-12T14:30:00Z'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: invalid_request
                  code:
                    type: string
                    example: ROUTING_VALIDATION_FAILED
                  message:
                    type: string
                    example: account_id is required.
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: PUBLIC-API-KEY
      x-default: <Your PUBLIC-API-KEY>
    sec1:
      type: apiKey
      in: header
      name: PRIVATE-SECRET-KEY
      x-default: <Your PRIVATE-SECRET-KEY>

````