> ## 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 grupos de exitosos

> Lista los grupos de exitosos de una cuenta, para referenciarlos por group_id desde las salidas SUCCEEDED_GROUP del enrutamiento.

Lista los grupos de exitosos guardados en una cuenta: grupos de subestados de éxito que referencias con `status: "SUCCEEDED_GROUP"` en una salida de enrutamiento, para reaccionar de forma distinta ante una autorización que el proveedor retiene para revisión (`PENDING_IN_REVIEW`) que ante una aprobación simple. Usa el `id` de un grupo como `group_id`: consulta [Grupos de resultados](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#outcome-groups).

El endpoint es de solo lectura. Los grupos de exitosos se crean en el dashboard.

### Parámetros de consulta

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

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

### Respuesta

Un arreglo con los grupos de la cuenta, o un arreglo vacío si no tiene ninguno. Cada grupo contiene:

**id** `integer`

El valor que se envía como `group_id`.

**name** `string`

El nombre del grupo, tal como se muestra en el dashboard y se devuelve como `group_name` en las salidas de enrutamiento.

**type** `enum`

Siempre `SUCCEEDED_GROUP`, el `status` de salida con el que se usa el grupo.

**succeeded\_types** `string[]`

Los miembros del grupo. Hoy el único subestado de éxito que se puede agrupar es `PENDING_IN_REVIEW`. Consulta [Códigos de transacción](https://docs.y.uno/es/reference/payments/status-and-response-codes/transaction.md#succeeded-status).

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl -X GET 'https://api.y.uno/v1/routing/succeeded-groups?account_id=7825fc5e-e50a-4248-9ae8-5d3786afb0be' \
  -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": 430,
    "name": "Pending review",
    "type": "SUCCEEDED_GROUP",
    "succeeded_types": ["PENDING_IN_REVIEW"]
  }
]
```

```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."]
}
```

### 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 **clave de API personalizada** del Dashboard. Usa una clave de cuenta o de organización en su lugar. |
| `502` | `ROUTING_UPSTREAM_ERROR` | No se pudo establecer conexión con el servicio de enrutamiento. Reintenta la solicitud. |


## OpenAPI

````yaml openapi/es/organizations/routing/list-succeeded-groups.json GET /routing/succeeded-groups
openapi: 3.1.0
info:
  title: Routing API - List Succeeded Groups
  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/succeeded-groups:
    get:
      summary: Listar grupos de éxitos
      description: >-
        Lista los grupos de éxitos de una cuenta, para referenciarlos por
        group_id desde las salidas de enrutamiento SUCCEEDED_GROUP. Solo
        lectura.
      operationId: list-succeeded-groups
      parameters:
        - name: account_id
          in: query
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            Cuenta de la que se listarán los grupos. Debe pertenecer a la
            organización de tus credenciales de API.
      responses:
        '200':
          description: Los grupos de la cuenta, o un arreglo vacío si no tiene ninguno.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      example: 430
                      description: >-
                        El valor que se debe enviar como group_id en una salida
                        de enrutamiento.
                    name:
                      type: string
                      example: Pending review
                    type:
                      type: string
                      enum:
                        - SUCCEEDED_GROUP
                      description: >-
                        Siempre SUCCEEDED_GROUP, el estado de salida con el que
                        se usa el grupo.
                    succeeded_types:
                      type: array
                      items:
                        type: string
                      example:
                        - PENDING_IN_REVIEW
                      description: >-
                        Miembros del grupo. Hoy el único subestado de éxito que
                        se puede agrupar es PENDING_IN_REVIEW.
        '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
        '502':
          description: Bad Gateway
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ROUTING_UPSTREAM_ERROR
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - routing service unavailable.
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.