> ## 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.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Listar enrutamientos

> Lista todos los enrutamientos de una cuenta, con filtro opcional por método de pago.

Lista los enrutamientos configurados en una cuenta. Cada elemento devuelve la configuración activa actual del enrutamiento, con la misma forma que [Obtener un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/retrieve-routing.md).

Pasa `payment_method` para listar solo los enrutamientos de ese método de pago, y omítelo para listarlos todos.

### Parámetros de consulta

**account\_id** `string` *required*

La cuenta de la que se listan los enrutamientos. Debe pertenecer a la organización a la que están asociadas tus credenciales de API.

**payment\_method** `enum`

Filtro opcional por método de pago (por ejemplo, `CARD`, `PIX`). Mismos valores que el campo `payment_method` en las respuestas de enrutamiento.

### Respuesta

Los enrutamientos configurados en la cuenta, o un arreglo vacío si no tiene ninguno. Cada enrutamiento contiene:

**id** `string`

Identificador único del enrutamiento.

**account\_id** `string`

Identificador único de la cuenta.

**payment\_method** `enum`

El método de pago al que se aplica este enrutamiento (por ejemplo, `CARD`).

**name** `string`

Etiqueta del enrutamiento.

**default\_route** `object`

La lógica de enrutamiento predeterminada.

**condition\_sets** `object[]`

Lógica condicional opcional.

**created\_at** `string`

Marca de tiempo ISO 8601.

**updated\_at** `string`

Marca de tiempo ISO 8601.

**warnings** `string[]`

Lista opcional de advertencias de orquestación que no bloquean (por ejemplo, `MONITOR_REDISTRIBUTION_DEFERRED`).

```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": "8f2c1d3e-4b5a-4c7d-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 — Missing account_id theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "ROUTING_VALIDATION_FAILED",
  "messages": ["account_id is required."]
}
```

```json 400 Bad Request — Invalid account_id theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "INVALID_ACCOUNT_ID",
  "messages": ["account_id 'acc-uuid' does not belong to your organization."]
}
```

### Errores

| HTTP | `code` | Cuándo |
| - | - | - |
| `400` | `ROUTING_VALIDATION_FAILED` | Falta el parámetro de consulta `account_id`. |
| `400` | `INVALID_ACCOUNT_ID` | `account_id` pertenece a una organización que tu clave de API no posee. |
| `401` | `NOT_AUTHENTICATED` | Falta el encabezado `public-api-key` o `private-secret-key`. |
| `401` | `INVALID_CREDENTIALS` | Par de claves incorrecto, o se usó una **Customized API key** del Dashboard. Usa una clave de cuenta o una clave de organización. |


## OpenAPI

````yaml openapi/es/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
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /routing:
    get:
      summary: Listar enrutamientos
      description: >-
        Lista todos los enrutamientos de una cuenta, con filtro opcional por
        método de pago. Cada elemento tiene la misma estructura que Retrieve a
        Routing.
      operationId: list-routings
      parameters:
        - name: account_id
          in: query
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            Cuenta de la que se listarán los enrutamientos. Debe pertenecer a la
            organización de tus credenciales de API.
        - name: payment_method
          in: query
          required: false
          schema:
            type: string
            example: CARD
          description: Filtra por método de pago (por ejemplo, CARD, PIX).
      responses:
        '200':
          description: >-
            Los enrutamientos configurados en la cuenta, o un arreglo vacío si
            no tiene ninguno.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: 8f2c1d3e-4b5a-4c7d-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:
                        start_split:
                          type: array
                          description: >-
                            Divide la entrada de la ruta entre varios pasos
                            según porcentajes. Omítelo para iniciar todos los
                            pagos en el paso 1. Las entradas deben sumar 100; se
                            devuelve solo cuando la ruta tiene una entrada
                            dividida.
                          items:
                            type: object
                            required:
                              - index
                              - percentage
                            properties:
                              index:
                                type: integer
                                example: 1
                              percentage:
                                type: integer
                                example: 45
                        steps:
                          type: array
                          items:
                            type: object
                            properties:
                              index:
                                type: integer
                                example: 1
                              provider_id:
                                type: string
                                example: STRIPE
                                description: >-
                                  Obligatorio en los pasos de proveedor; ausente
                                  en los pasos de acción. Debe coincidir con el
                                  proveedor de la conexión.
                              connection_id:
                                type: string
                                example: f1a3c4d5-...
                                description: >-
                                  Obligatorio en los pasos de proveedor; ausente
                                  en los pasos de acción y de enrutamiento
                                  inteligente. Debe estar ACTIVE y admitir el
                                  payment_method.
                              provider_type:
                                type: string
                                enum:
                                  - PAYMENT
                                  - FRAUD
                                  - THREE_D_SECURE
                                  - AUTHENTICATION
                                description: >-
                                  El tipo al que se resuelve el proveedor. Solo
                                  en la respuesta.
                              timeout:
                                type: integer
                                example: 60
                                description: >-
                                  Pasos de proveedor. Tiempo de espera del
                                  proveedor en segundos, tomado del catálogo de
                                  proveedores. Solo en la respuesta.
                              network_token_enable:
                                type: boolean
                                description: >-
                                  Pasos de pago. Indica si network_token_on
                                  puede ser true en este paso: la organización
                                  está habilitada para tokens de red y el
                                  proveedor los admite. Solo en la respuesta.
                              network_token_on:
                                type: boolean
                                description: >-
                                  Pasos de pago. Indica si el paso paga con el
                                  token de red de la tarjeta cuando hay uno
                                  disponible.
                              three_d_secure_exemptions:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - LOW_VALUE
                                    - TRANSACTION_RISK_ANALYSIS
                                    - SECURE_CORPORATE
                                    - TRUSTED_BENEFICIARY
                                    - RECURRING_PAYMENT
                                    - STRONG_CUSTOMER_AUTHENTICATION
                                    - OUT_OF_SCOPE
                                description: >-
                                  Pasos 3DS. Las exenciones de SCA que el paso
                                  puede aplicar; un arreglo vacío cuando no hay
                                  ninguna.
                              action:
                                type: string
                                enum:
                                  - CANCEL
                                  - CAPTURE
                                  - HOLD_FOR_REVIEW
                                  - REVERT
                                description: >-
                                  Convierte el paso en un paso de acción que
                                  termina la ruta: CANCEL rechaza el pago,
                                  CAPTURE captura la autorización después de
                                  action_delay, HOLD_FOR_REVIEW lo deja
                                  pendiente de revisión manual, REVERT lo
                                  revierte después de una evaluación de fraude
                                  posterior al pago. CAPTURE y HOLD_FOR_REVIEW
                                  siguen a una salida APPROVED o SUCCEEDED_GROUP
                                  de un paso de pago o de enrutamiento
                                  inteligente, REVERT sigue a las salidas de un
                                  paso de fraude que se ejecuta después del
                                  pago, CANCEL nunca sigue a una aprobación. Un
                                  paso de acción no tiene provider_id,
                                  connection_id ni output.
                              action_delay:
                                type: string
                                example: PT5M
                                description: >-
                                  Solo con action = CAPTURE. Duración ISO-8601
                                  entre la aprobación y la captura, de al menos
                                  PT1M y como máximo P7D. Omítelo para capturar
                                  en cuanto se procese la aprobación.
                              output:
                                type: array
                                items:
                                  type: object
                                  required:
                                    - status
                                  properties:
                                    status:
                                      type: string
                                      example: DECLINED
                                      description: >-
                                        APPROVED, DECLINED, DECLINE_GROUP,
                                        MAC_CODE_GROUP, SUCCEEDED_GROUP, PENDING
                                        (solo en pasos de fraude, 3DS y
                                        autenticación) o INTERNAL_ERROR.
                                    decline_types:
                                      type: array
                                      items:
                                        type: string
                                      description: >-
                                        Miembros del grupo en las salidas
                                        DECLINE_GROUP (subestados de rechazo) y
                                        MAC_CODE_GROUP (Merchant Advice Codes).
                                    group_id:
                                      type: integer
                                      example: 1044
                                      description: >-
                                        Id del grupo detrás de una salida
                                        DECLINE_GROUP, MAC_CODE_GROUP o
                                        SUCCEEDED_GROUP.
                                    group_name:
                                      type: string
                                      example: Soft declines
                                      description: >-
                                        Nombre del grupo detrás de group_id. Se
                                        ignora al escribir.
                                    retry:
                                      type: boolean
                                      example: false
                                      description: >-
                                        Indica si esta salida reintenta una vez
                                        con el mismo proveedor antes de seguir
                                        next. Siempre se devuelve.
                                    next:
                                      type: integer
                                      example: 2
                                    next_split:
                                      type: array
                                      description: >-
                                        Divide el respaldo (fallback) entre
                                        varios pasos según porcentajes: al menos
                                        2 entradas cuyos porcentajes sumen 100.
                                        Se devuelve junto con next = primera
                                        entrada.
                                      items:
                                        type: object
                                        required:
                                          - index
                                          - percentage
                                        properties:
                                          index:
                                            type: integer
                                            example: 2
                                          percentage:
                                            type: integer
                                            example: 70
                                description: >-
                                  Manejadores por resultado. Se devuelve como un
                                  arreglo vacío en los pasos de acción.
                              fraud:
                                type: object
                                description: >-
                                  Configuración de un paso de proveedor de
                                  fraude, devuelta en los pasos FRAUD.
                                properties:
                                  rules:
                                    type: string
                                    example: rule-a,rule-b
                                  blocklists:
                                    type: string
                                  allowlists:
                                    type: string
                                  reviewlists:
                                    type: string
                                  preset:
                                    type: string
                                  report_only:
                                    type: boolean
                                    description: >-
                                      Evalúa el puntaje sin actuar sobre el
                                      resultado. Solo en un paso de fraude al
                                      que se llega desde salidas rechazadas de
                                      un paso de pago.
                              smart_routing:
                                type: object
                                description: >-
                                  Se devuelve en los pasos de enrutamiento
                                  inteligente.
                                properties:
                                  type:
                                    type: string
                                    enum:
                                      - COSTS
                                      - LATENCY
                                    example: LATENCY
                                  providers:
                                    type: array
                                    minItems: 2
                                    maxItems: 4
                                    items:
                                      type: object
                                      required:
                                        - provider_id
                                        - connection_id
                                      properties:
                                        provider_id:
                                          type: string
                                          example: ADYEN
                                        connection_id:
                                          type: string
                                          format: uuid
                                        network_token_on:
                                          type: boolean
                                  no_retry_decline_types:
                                    type: array
                                    items:
                                      type: string
                                    description: >-
                                      Subestados de rechazo después de los
                                      cuales no se prueba el siguiente proveedor
                                      del conjunto.
                                  no_retry_failure_causes:
                                    type: array
                                    items:
                                      type: string
                                    description: >-
                                      Causas de falla (por ejemplo,
                                      PROVIDER_TIMEOUT) después de las cuales no
                                      se prueba el siguiente proveedor del
                                      conjunto.
                    condition_sets:
                      type: array
                      items:
                        type: object
                        properties:
                          sort_number:
                            type: integer
                            example: 1
                          name:
                            type: string
                            example: High Value US
                          description:
                            type: string
                          conditions:
                            type: array
                            items:
                              type: object
                              properties:
                                condition_type:
                                  type: string
                                  example: COUNTRY
                                  description: >-
                                    Consulta Condiciones de enrutamiento para
                                    ver el catálogo: COUNTRY,
                                    CARD_ISSUER_COUNTRY, AMOUNT, CURRENCY,
                                    CARD_TYPE, CARD_BRAND, CARD_BIN,
                                    TRANSACTION_TYPE, METADATA,
                                    ADDITIONAL_FIELD, ORDER_ITEMS_AMOUNT,
                                    TIME_PERIOD, VOLUME_PAYMENTS_LIMIT,
                                    SUBSCRIPTION_RETRY,
                                    SUBSCRIPTION_RETRY_COUNT.
                                conditional:
                                  type: string
                                  example: ONE_OF
                                values:
                                  type: array
                                  items:
                                    type: string
                                  example:
                                    - US
                                    - CA
                                  description: >-
                                    En CURRENCY, códigos ISO 4217 en mayúsculas
                                    (no XXX, sin repetidos): exactamente 1 con
                                    EQUAL o NOT_EQUAL, 1 o más con ONE_OF o
                                    NOT_ONE_OF. Vacío solo en una condición
                                    AMOUNT con currency, que entonces coincide
                                    con cualquier monto en esa moneda. En
                                    ORDER_ITEMS_AMOUNT, el umbral numérico para
                                    la suma de los ítems: 1 valor, 2 con
                                    BETWEEN.
                                key:
                                  type: string
                                  description: >-
                                    METADATA: la clave de metadata.
                                    ADDITIONAL_FIELD: el nombre del campo
                                    compatible. ORDER_ITEMS_AMOUNT: el campo del
                                    ítem de la orden contra el que se compara
                                    item_values, sku_code (por defecto),
                                    category o brand.
                                item_values:
                                  type: array
                                  items:
                                    type: string
                                  example:
                                    - GC-50
                                    - GC-100
                                    - GC-200
                                  description: >-
                                    Solo para ORDER_ITEMS_AMOUNT, y obligatorio
                                    en ella: lista no vacía de valores de ítems
                                    de la orden (exactos, sensibles a
                                    mayúsculas) cuya cantidad × unit_amount se
                                    suma. Se rechaza en cualquier otro
                                    condition_type.
                                currency:
                                  type: string
                                  example: USD
                                  description: >-
                                    ISO 4217. Obligatorio en AMOUNT, en
                                    ORDER_ITEMS_AMOUNT y en
                                    VOLUME_PAYMENTS_LIMIT con limit_by = VOLUME.
                                    No se envía en CURRENCY, cuyas monedas van
                                    en values.
                                time_period_repeat_amount:
                                  type: integer
                                  example: 1
                                  description: >-
                                    TIME_PERIOD y VOLUME_PAYMENTS_LIMIT: cada
                                    cuántas unidades de tiempo de
                                    time_period_repeat_frequency (programación),
                                    o la duración de una ventana DAILY en días,
                                    de 1 a 90 (limit).
                                time_period_repeat_frequency:
                                  type: string
                                  enum:
                                    - DAILY
                                    - WEEKLY
                                    - MONTHLY
                                    - QUARTERLY
                                    - YEARLY
                                  description: >-
                                    TIME_PERIOD: unidad de recurrencia.
                                    VOLUME_PAYMENTS_LIMIT: período del límite,
                                    DAILY, MONTHLY o QUARTERLY.
                                time_period_repetition_days:
                                  type: array
                                  items:
                                    type: string
                                    enum:
                                      - MONDAY
                                      - TUESDAY
                                      - WEDNESDAY
                                      - THURSDAY
                                      - FRIDAY
                                      - SATURDAY
                                      - SUNDAY
                                  description: >-
                                    Solo TIME_PERIOD. Días de la semana a los
                                    que se aplica la programación; requiere una
                                    frecuencia.
                                time_period_start_time:
                                  type: string
                                  example: '09:00:00'
                                  description: >-
                                    Solo TIME_PERIOD. Inicio de la ventana
                                    horaria diaria (HH:mm:ss), junto con
                                    time_period_end_time.
                                time_period_end_time:
                                  type: string
                                  example: '18:00:00'
                                  description: >-
                                    Solo TIME_PERIOD. Fin de la ventana horaria
                                    diaria (HH:mm:ss), inclusive.
                                timezone:
                                  type: string
                                  example: '-03:00'
                                  description: >-
                                    Desfase UTC. TIME_PERIOD: desfase con el que
                                    se lee la programación (por defecto, el
                                    desfase de values[0]).
                                    VOLUME_PAYMENTS_LIMIT: desfase en horas
                                    completas donde comienzan los períodos (por
                                    defecto, +00:00).
                                limit_by:
                                  type: string
                                  enum:
                                    - PAYMENTS
                                    - VOLUME
                                  description: >-
                                    Solo VOLUME_PAYMENTS_LIMIT. Cuenta pagos
                                    (predeterminado) o suma montos en la moneda.
                                payments_count:
                                  type: string
                                  enum:
                                    - ALL
                                    - SUCCEEDED
                                  description: >-
                                    Solo VOLUME_PAYMENTS_LIMIT. Qué pagos
                                    cuentan para el límite. El valor
                                    predeterminado es ALL.
                            description: >-
                              Condiciones combinadas con AND lógico. Consulta
                              Routing Conditions.
                          route:
                            type: object
                            description: >-
                              Misma estructura que default_route, incluidos
                              start_split, output[].next_split y los pasos de
                              acción.
                    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: >-
            Solicitud incorrecta. `ROUTING_VALIDATION_FAILED` cuando falta
            `account_id`, `INVALID_ACCOUNT_ID` cuando pertenece a otra
            organización.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ROUTING_VALIDATION_FAILED
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - account_id is required.
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: NOT_AUTHENTICATED
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Not authenticated
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>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.