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

# Obtener un enrutamiento

> Devuelve la configuración activa actual de un enrutamiento, identificado por su routing_id.

Devuelve la configuración activa actual del enrutamiento, con la misma estructura que aceptan [Crear un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/create-routing.md) y [Actualizar un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/update-routing.md), de modo que puedes reenviar el resultado en un `PATCH`. En comparación con el cuerpo de una solicitud, la respuesta también incluye:

* `retry` en cada salida (`false` cuando no está definido).
* `group_id`, `group_name` y `decline_types` en las salidas `DECLINE_GROUP` y `MAC_CODE_GROUP`; `group_id` y `group_name` en las salidas `SUCCEEDED_GROUP`.
* `action` y `action_delay` en los pasos de acción, y `output: []` en ellos.
* `provider_type` y `timeout` en cada paso de proveedor, `network_token_enable` y `network_token_on` en los pasos de pago, `three_d_secure_exemptions` en los pasos de 3DS, `fraud` en los pasos de fraude y `smart_routing` en los pasos de enrutamiento inteligente.
* Los campos de programación y límite de las condiciones `TIME_PERIOD` y `VOLUME_PAYMENTS_LIMIT`.
* `start_split` cuando la entrada está dividida y `output[].next_split` cuando un respaldo está dividido; ambos se omiten en caso contrario.
* Los campos sin valor se devuelven como `null` (`next`, `decline_types`, `key`, `currency`); los ejemplos de abajo los omiten por brevedad.

Las partes de un enrutamiento que la API no puede expresar se omiten de la respuesta y se conservan intactas al actualizar. Consulta [Lo que la API no muestra](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#what-the-api-does-not-show).

### Parámetros de ruta

**routing\_id** `string` *required*

El id devuelto por [Crear un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/create-routing.md). Debe pertenecer a la cuenta a la que está asociada tu clave de API.

### Respuesta

**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. Consulta [Estructura del recurso de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md) para ver todos los campos de `steps[]` y `output[]`.

**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 no bloqueantes (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/8f2c1d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f' \
  -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": "7825fc5e-e50a-4248-9ae8-5d3786afb0be",
  "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": "APPROVED",       "next": 3, "retry": false },
          { "status": "DECLINE_GROUP",  "group_id": 1044, "group_name": "Soft declines",
            "decline_types": ["DECLINED_BY_BANK", "RESTRICTED_BY_BANK"], "next": 2, "retry": true },
          { "status": "MAC_CODE_GROUP", "group_id": 4542, "group_name": "Do not retry",
            "decline_types": ["NO_RETRY_POLICY", "NO_RETRY_SECURITY"], "retry": false },
          { "status": "DECLINED",       "next": 2, "retry": false },
          { "status": "INTERNAL_ERROR", "next": 2, "retry": false }
        ]
      },
      {
        "index": 2,
        "provider_id": "ADYEN",
        "connection_id": "b2c4d5e6-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
        "output": [
          { "status": "APPROVED",        "next": 3, "retry": false },
          { "status": "SUCCEEDED_GROUP", "group_id": 430, "group_name": "Pending review", "next": 4, "retry": false }
        ]
      },
      { "index": 3, "action": "CAPTURE", "action_delay": "PT5M", "output": [] },
      { "index": 4, "action": "HOLD_FOR_REVIEW", "output": [] }
    ]
  },
  "condition_sets": [
    {
      "sort_number": 1,
      "name": "Business hours via Adyen",
      "conditions": [
        { "condition_type": "TIME_PERIOD", "conditional": "EQUAL", "values": ["2026-10-01T00:00:00-03:00"],
          "time_period_repeat_amount": 1, "time_period_repeat_frequency": "WEEKLY",
          "time_period_repetition_days": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY"],
          "time_period_start_time": "09:00:00", "time_period_end_time": "18:00:00", "timezone": "-03:00" }
      ],
      "route": { "steps": [ { "index": 1, "provider_id": "ADYEN", "connection_id": "b2c4d5e6-...", "output": [{ "status": "APPROVED", "next": null, "decline_types": null, "retry": false }, { "status": "INTERNAL_ERROR", "next": null, "decline_types": null, "retry": false }] } ] }
    }
  ],
  "created_at": "2026-05-12T14:30:00Z",
  "updated_at": "2026-05-12T14:30:00Z"
}
```

```json 404 Not Found theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "ROUTING_NOT_FOUND",
  "messages": ["Routing '...' was not found"]
}
```

### Errores

| HTTP | `code` | Cuándo |
| - | - | - |
| `404` | `ROUTING_NOT_FOUND` | `routing_id` desconocido, o el id pertenece a otra cuenta. |
| `401` | `NOT_AUTHENTICATED` | Falta el encabezado `public-api-key` o `private-secret-key`. |
| `401` | `INVALID_CREDENTIALS` | Par de claves incorrecto, o se usó una **clave de API personalizada** del Dashboard. Usa una clave de cuenta o de organización en su lugar. |


## OpenAPI

````yaml openapi/es/organizations/routing/retrieve-routing.json GET /routing/{routing_id}
openapi: 3.1.0
info:
  title: Routing API - Retrieve
  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/{routing_id}:
    get:
      summary: Recuperar un enrutamiento
      description: Devuelve la configuración activa actual del enrutamiento.
      operationId: retrieve-routing
      parameters:
        - name: routing_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                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'
        '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
        '404':
          description: No encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ROUTING_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Routing '...' was not found
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.