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

> Lista los checkouts personalizados de la cuenta (solo resúmenes): ids, nombres, estados y cuál es el predeterminado

> [!NOTE]
>
> Esta API está en **Beta**. Los endpoints y los esquemas pueden cambiar sin previo aviso.

Los resultados se ordenan con el predeterminado primero y luego por actualización más reciente, e incluyen los checkouts `ARCHIVED`. El `id` de cada elemento es el `checkout_code` que usan los endpoints [Obtener](https://docs.y.uno/es/reference/checkout-builder/fetch-checkout-configuration.md) y [Publicar](https://docs.y.uno/es/reference/checkout-builder/publish-checkout-configuration.md).

La paginación es opcional: sin `page` ni `size`, la respuesta es un arreglo simple con todos los checkouts que coinciden; si envías cualquiera de los dos, la respuesta pasa a un envoltorio paginado (`data` + `pagination`, donde `total` es el conteo completo filtrado).


## OpenAPI

````yaml openapi/es/checkout-builder/list-checkouts.json GET /checkouts
openapi: 3.1.0
info:
  title: checkout-builder
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - publicApiKey: []
    privateSecretKey: []
    accountCode: []
paths:
  /checkouts:
    get:
      summary: List Checkouts
      description: >-
        Lista los checkouts personalizados de la cuenta como resúmenes (sin
        configuración ni estilos), ordenados primero por el predeterminado y
        luego por la actualización más reciente. Incluye los checkouts ARCHIVED.
        Todos los filtros son opcionales y combinables (se aplican con AND). Sin
        page ni size, la respuesta es un arreglo simple con todos los checkouts
        que coinciden; si envías cualquiera de los dos, pasa a un envoltorio
        paginado.
      operationId: list-checkouts
      parameters:
        - name: name
          in: query
          description: >-
            Filtro de contiene, sin distinguir mayúsculas y minúsculas, sobre el
            nombre del checkout. Los metacaracteres de LIKE (% y _) coinciden de
            forma literal.
          schema:
            type: string
          required: false
        - name: id
          in: query
          description: >-
            Filtro de contiene, sin distinguir mayúsculas y minúsculas, sobre el
            identificador del checkout.
          schema:
            type: string
          required: false
        - name: status
          in: query
          description: >-
            Filtra por estado. Acepta uno o varios valores (OR): repite el
            parámetro o envía una lista separada por comas
            (status=PUBLISHED,ARCHIVED). Los valores no válidos se rechazan con
            400. Si se omite: todos los estados.
          schema:
            type: string
            enum:
              - PUBLISHED
              - NOT_PUBLISHED
              - ARCHIVED
          required: false
        - name: created_after
          in: query
          description: >-
            Límite inferior inclusivo de created_at (instante ISO-8601, p. ej.,
            2026-05-01T00:00:00Z).
          schema:
            type: string
            format: date-time
          required: false
        - name: created_before
          in: query
          description: Límite superior inclusivo de created_at (instante ISO-8601).
          schema:
            type: string
            format: date-time
          required: false
        - name: updated_after
          in: query
          description: Límite inferior inclusivo de updated_at (instante ISO-8601).
          schema:
            type: string
            format: date-time
          required: false
        - name: updated_before
          in: query
          description: Límite superior inclusivo de updated_at (instante ISO-8601).
          schema:
            type: string
            format: date-time
          required: false
        - name: page
          in: query
          description: >-
            Número de página (base 1). Paginación opcional: si envías page o
            size, la respuesta pasa al envoltorio paginado. Valor
            predeterminado: 1. Los valores no numéricos se rechazan con 400.
          schema:
            type: integer
            minimum: 1
            default: 1
          required: false
        - name: size
          in: query
          description: >-
            Tamaño de página. Paginación opcional: si envías page o size, la
            respuesta pasa al envoltorio paginado. Valor predeterminado: 25, con
            un máximo de 100. Los valores no numéricos se rechazan con 400.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          required: false
      responses:
        '200':
          description: >-
            Los checkouts de la cuenta. Un arreglo simple cuando page y size
            están ausentes; un envoltorio paginado (data + pagination) cuando
            está presente cualquiera de los dos. Los elementos incluyen los
            mismos 7 campos en ambos formatos. pagination.total es el conteo
            total filtrado, no el número de filas de la página.
          content:
            application/json:
              schema:
                oneOf:
                  - type: array
                    items:
                      $ref: '#/components/schemas/CheckoutSummary'
                    description: >-
                      Arreglo simple con todos los checkouts que coinciden (page
                      y size ausentes).
                    title: Sin paginación
                  - type: object
                    description: Envoltorio paginado (page o size presente).
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/CheckoutSummary'
                      pagination:
                        type: object
                        properties:
                          page:
                            type: integer
                            description: Página actual (base 1).
                          size:
                            type: integer
                            description: Tamaño de página.
                          total:
                            type: integer
                            description: >-
                              Conteo total filtrado, no el número de filas de la
                              página.
                    title: Con paginación
              examples:
                Without pagination:
                  value:
                    - id: 2a8d6472-3117-4e85-8b28-d51ba3abab77
                      name: Default
                      description: Default
                      status: PUBLISHED
                      is_default: true
                      created_at: '2026-05-02T18:11:04.120Z'
                      updated_at: '2026-07-01T09:30:12.001Z'
                    - id: 0b28ff66-15f1-44c1-8d1e-bd1fefbc0a19
                      name: Promo Checkout
                      description: Seasonal promo
                      status: ARCHIVED
                      is_default: false
                      created_at: '2026-04-11T10:02:33.000Z'
                      updated_at: '2026-06-20T15:45:00.000Z'
                With pagination:
                  value:
                    data:
                      - id: 2a8d6472-3117-4e85-8b28-d51ba3abab77
                        name: Default
                        description: Default
                        status: PUBLISHED
                        is_default: true
                        created_at: '2026-05-02T18:11:04.120Z'
                        updated_at: '2026-07-01T09:30:12.001Z'
                    pagination:
                      page: 1
                      size: 25
                      total: 3
        '400':
          description: Valores de page/size no válidos o un valor de status no válido.
          content:
            application/json:
              examples:
                Invalid pagination:
                  value:
                    code: ILLEGAL_ARGUMENT
                    messages:
                      - page must be a positive integer
        '401':
          description: >-
            Credenciales ausentes o no válidas, o la cuenta no está en la lista
            de acceso permitido de la beta.
components:
  schemas:
    CheckoutSummary:
      type: object
      properties:
        id:
          type: string
          description: >-
            Identificador del checkout (UUID). Úsalo como checkout_code en los
            endpoints de consulta y publicación.
        name:
          type: string
          description: Nombre del checkout.
        description:
          type: string
          description: Descripción del checkout.
        status:
          type: string
          enum:
            - PUBLISHED
            - NOT_PUBLISHED
            - ARCHIVED
          description: Estado del checkout.
        is_default:
          type: boolean
          description: Indica si este checkout es el predeterminado de la cuenta.
        created_at:
          type: string
          format: date-time
          description: Marca de tiempo de creación (ISO-8601).
        updated_at:
          type: string
          format: date-time
          description: Marca de tiempo de la última actualización (ISO-8601).
  securitySchemes:
    publicApiKey:
      type: apiKey
      in: header
      name: PUBLIC-API-KEY
      description: >-
        Clave de API pública del comercio. Se encuentra en el Dashboard de Yuno
        → Settings → API Keys.
    privateSecretKey:
      type: apiKey
      in: header
      name: PRIVATE-SECRET-KEY
      description: >-
        Clave secreta privada del comercio, asociada a la clave pública. Nunca
        la incluyas en código del lado del cliente.
    accountCode:
      type: apiKey
      in: header
      name: X-Account-Code
      description: >-
        UUID del ámbito de la cuenta del comercio para la solicitud. El tenant
        se resuelve únicamente a partir de este encabezado.

````

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