> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar los QR Pix del PSP

> Lista los QR Pix que creó el PSP, filtrados por tipo y una ventana de registro (≤90 días). Devuelve los bloques static e immediate-dynamic; los QR composite / cobv / recurrence quedan fuera del alcance de este contexto y no se proyectan.



## OpenAPI

````yaml es/openapi/v3-current/pix.yaml GET /v1/qrcodes/list
openapi: 3.0.3
info:
  title: Plugin BR Pix Directo - API completa
  description: >
    API completa para el sistema de pagos instantáneos Pix de Brasil,

    que incluye operaciones del diccionario de claves Pix,
    generación/decodificación

    de códigos QR, transacciones y límites transaccionales.
  version: 1.0.0
servers:
  - url: https://plugin-pix-direct.api.lerian.net
  - url: https://plugin-pix-direct-qrcode.api.lerian.net
security:
  - bearerAuth: []
paths:
  /v1/qrcodes/list:
    get:
      tags:
        - QR Codes API
      summary: Listar los QR Pix del PSP
      description: >-
        Lista los QR Pix que creó el PSP, filtrados por tipo y una ventana de
        registro (≤90 días). Devuelve los bloques static e immediate-dynamic;
        los QR composite / cobv / recurrence quedan fuera del alcance de este
        contexto y no se proyectan.
      parameters:
        - description: >-
            tpQRCode filter (11=static, 12=immediate dynamic, 13=cobv,
            14-17=composite).
          explode: false
          in: query
          name: qrCodeType
          schema:
            description: >-
              Filtro tpQRCode (11=static, 12=immediate dynamic, 13=cobv,
              14-17=composite).
            format: int64
            type: integer
        - description: Window start (dtHrInicial; aaaa-mm-ddTHH:mm:ss.sssZ).
          explode: false
          in: query
          name: startDateTime
          schema:
            description: Inicio de la ventana (dtHrInicial; aaaa-mm-ddTHH:mm:ss.sssZ).
            type: string
        - description: Window end (dtHrFinal; aaaa-mm-ddTHH:mm:ss.sssZ; ≤90d from start).
          explode: false
          in: query
          name: endDateTime
          schema:
            description: >-
              Fin de la ventana (dtHrFinal; aaaa-mm-ddTHH:mm:ss.sssZ; ≤90 días
              desde el inicio).
            type: string
        - description: Page number (pagina; default 1).
          explode: false
          in: query
          name: page
          schema:
            description: Número de página (pagina; por defecto 1).
            format: int64
            type: integer
        - description: Page size (tamanhoPagina; default 50, max 100).
          explode: false
          in: query
          name: pageSize
          schema:
            description: Tamaño de página (tamanhoPagina; por defecto 50, máx. 100).
            format: int64
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListQRResponse'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
components:
  schemas:
    ListQRResponse:
      additionalProperties: false
      properties:
        consultedAt:
          description: >-
            La marca de tiempo de la consulta al upstream (marca de tiempo del
            upstream).
          type: string
        dynamicQrCodes:
          description: Los QR dinámicos inmediatos (qrCodeDinamico).
          items:
            $ref: '#/components/schemas/ListedDynamicQRResponse'
          type: array
          nullable: true
        staticQrCodes:
          description: Los QR estáticos (qrCodeEstatico).
          items:
            $ref: '#/components/schemas/ListedStaticQRResponse'
          type: array
          nullable: true
      required:
        - consultedAt
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Código de error de dominio estable y legible por máquina, acotado al
            servicio emisor (formato: <SERVICE>-NNNN).
          type: string
        detail:
          description: >-
            Una explicación legible para humanos específica de esta ocurrencia
            del problema.
          type: string
        errors:
          description: Lista opcional de detalles de error individuales
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
          nullable: true
        instance:
          description: >-
            Una referencia URI que identifica la ocurrencia específica del
            problema.
          format: uri
          type: string
        status:
          description: Código de estado HTTP
          format: int64
          type: integer
        title:
          description: >-
            Un resumen breve y legible para humanos del tipo de problema. Este
            valor no debería cambiar entre ocurrencias del error.
          type: string
        type:
          default: about:blank
          description: >-
            Una referencia URI a la documentación legible para humanos del
            error.
          format: uri
          type: string
      type: object
    ListedDynamicQRResponse:
      additionalProperties: false
      properties:
        amount:
          description: Monto original en reales (valorOriginal).
          format: double
          type: number
        categoryCode:
          description: Código de categoría del beneficiario (codigoCategoria).
          type: string
        city:
          description: Ciudad del beneficiario (cidade).
          type: string
        conciliationId:
          description: Id de conciliación (idConciliacaoRecebedor).
          type: string
        description:
          description: Entradas de datos adicionales (dadosAdicionais).
          items:
            $ref: '#/components/schemas/AdditionalDataBody'
          type: array
          nullable: true
        documentId:
          description: El GUID del cobro en el upstream (idDocumento).
          type: string
        expirationTime:
          description: Expiración del QR en segundos (expiracaoQR).
          format: int64
          type: integer
        format:
          description: Formato del upstream (0=image, 1=payload, 2=both).
          format: int64
          type: integer
        key:
          description: La clave Pix del beneficiario.
          type: string
        payloadUrl:
          description: URL del host JWS (urlPayloadJson).
          type: string
        recipientName:
          description: Nombre del beneficiario (nomeRecebedor).
          type: string
        status:
          description: Estado del cobro (0=Active..3=Removed by PSP).
          format: int64
          type: integer
        zipCode:
          description: Código postal del beneficiario (cep).
          type: string
      required:
        - documentId
        - format
        - key
        - recipientName
        - city
        - amount
        - status
      type: object
    ListedStaticQRResponse:
      additionalProperties: false
      properties:
        additionalData:
          description: Datos adicionales de texto libre (dadosAdicionais).
          type: string
        amount:
          description: Monto de la transacción en reales.
          format: double
          type: number
        bankIdFss:
          description: ISPB del facilitador de Pix Saque (ispbFss).
          type: string
        categoryCode:
          description: Código de categoría del beneficiario (codigoCategoria).
          type: string
        city:
          description: Ciudad del beneficiario (cidade).
          type: string
        conciliationId:
          description: Id de conciliación (idConciliacaoRecebedor).
          type: string
        format:
          description: Formato del upstream (0=image, 1=payload, 2=both).
          format: int64
          type: integer
        key:
          description: La clave Pix del beneficiario.
          type: string
        recipientName:
          description: Nombre del beneficiario (nomeRecebedor).
          type: string
        zipCode:
          description: Código postal del beneficiario (cep).
          type: string
      required:
        - format
        - key
        - amount
        - recipientName
        - city
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Dónde ocurrió el error, p. ej. 'body.items[3].tags' o
            'path.thing-id'
          type: string
        message:
          description: Texto del mensaje de error
          type: string
        value:
          description: El valor en la ubicación indicada
      type: object
    AdditionalDataBody:
      additionalProperties: false
      properties:
        name:
          description: El nombre de la entrada de datos adicionales.
          type: string
        value:
          description: El valor de la entrada de datos adicionales.
          type: string
      required:
        - name
        - value
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Autenticación con token JWT Bearer. Obtén el token desde el endpoint
        `/v1/login/oauth/access_token`

        usando credenciales de cliente (`clientId` y `clientSecret`).


        Incluye el token en el encabezado Authorization:

        `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`


        El token expira después de 3600 segundos (1 hora).

````