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

# Retrieve a Routing

> Returns the routing's current live configuration.

Returns the routing's current live configuration.

### Path Parameters

<ParamField path="routing_id" type="string" required>
  The id returned by [Create a Routing](/reference/organizations/routing/create-routing). Must belong to the account your API key is scoped to.
</ParamField>

### Response

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

<ResponseField name="account_code" type="string">
  Unique code 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/r_8f2c1d3e-4b5a-6c7d-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": "r_8f2c1d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
    "account_code": "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 404 Not Found theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
  {
    "type": "not_found",
    "code": "ROUTING_NOT_FOUND",
    "message": "Routing '...' was not found",
    "details": { "routing_id": "..." }
  }
  ```
</CodeGroup>

### Errors

| HTTP  | `code`               | When                                                        |
| ----- | -------------------- | ----------------------------------------------------------- |
| `404` | `ROUTING_NOT_FOUND`  | Unknown `routing_id`, or id belongs to a different account. |
| `403` | `INSUFFICIENT_SCOPE` | API key missing `routing:read`.                             |


## OpenAPI

````yaml openapi/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
security:
  - sec0: []
    sec1: []
paths:
  /routing/{routing_id}:
    get:
      summary: Retrieve a Routing
      description: Returns the routing's current live configuration.
      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: r_8f2c1d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f
                  account_code:
                    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'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: not_found
                  code:
                    type: string
                    example: ROUTING_NOT_FOUND
                  message:
                    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>

````