> ## 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 cobros de Pix Automático por autorización

> Lista los cobros que pertenecen a una autorización, limitados al pagador autenticado: los cobros de otro pagador nunca se devuelven. Admite paginación por página/límite además de filtros por estado y por rango de fechas de createdAt. Cada elemento incluye el arreglo de intentos saneado; el código de resultado del débito interno nunca se expone.



## OpenAPI

````yaml es/openapi/v3-current/indirect-pix.yaml GET /v1/recurrences/payer/authorizations/{authorizationId}/charges
openapi: 3.0.3
info:
  title: Plugin BR Pix Indirect - 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.7.6
servers:
  - url: https://plugin-pix-indirect.api.lerian.net
security:
  - bearerAuth: []
paths:
  /v1/recurrences/payer/authorizations/{authorizationId}/charges:
    get:
      tags:
        - Pix Automático API
      summary: Listar cobros de Pix Automático por autorización
      description: >-
        Lista los cobros que pertenecen a una autorización, limitados al pagador
        autenticado: los cobros de otro pagador nunca se devuelven. Admite
        paginación por página/límite además de filtros por estado y por rango de
        fechas de createdAt. Cada elemento incluye el arreglo de intentos
        saneado; el código de resultado del débito interno nunca se expone.
      parameters:
        - $ref: '#/components/parameters/XAccountId'
        - name: authorizationId
          in: path
          description: ID de la autorización (formato UUID)
          required: true
          schema:
            type: string
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Page'
        - name: status
          in: query
          description: Filtra por estado
          schema:
            type: string
            enum:
              - RECEIVED
              - SCHEDULED
              - EXECUTED
              - FAILED
              - CANCELLED
        - name: start_date
          in: query
          description: Límite inferior ISO 8601 UTC sobre createdAt
          schema:
            format: date-time
            type: string
        - name: end_date
          in: query
          description: Límite superior ISO 8601 UTC sobre createdAt
          schema:
            format: date-time
            type: string
        - $ref: '#/components/parameters/SortOrder'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListChargesByAuthorizationOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
      security:
        - bearerAuth: []
components:
  parameters:
    XAccountId:
      name: X-Account-Id
      in: header
      description: Identificador único de la cuenta del Ledger de Midaz (formato UUID).
      required: true
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
    Limit:
      name: limit
      in: query
      description: Número máximo de elementos por página.
      required: false
      example: 10
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 10
    Page:
      name: page
      in: query
      description: Número de página para la paginación.
      required: false
      example: 1
      schema:
        type: integer
        minimum: 1
        default: 1
    SortOrder:
      name: sort_order
      in: query
      description: 'Dirección de ordenamiento: asc o desc.'
      required: false
      example: asc
      schema:
        type: string
        enum:
          - asc
          - desc
        default: asc
  schemas:
    ListChargesByAuthorizationOutput:
      properties:
        items:
          items:
            $ref: '#/components/schemas/ChargeOutput'
          type: array
        limit:
          type: integer
          example: 10
        page:
          type: integer
          example: 1
        total:
          type: integer
          example: 42
      type: object
    ErrorFormat:
      type: object
      description: El mensaje de error de la respuesta.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Un identificador único y estable para el error.
        title:
          type: string
          description: Un breve resumen del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
    ChargeOutput:
      properties:
        accountId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        amount:
          example: '29.90'
          type: string
        attemptCount:
          type: integer
          example: 1
        attempts:
          items:
            $ref: '#/components/schemas/ChargeAttemptOutput'
          type: array
        authorizationId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        authorizationRequestId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        cancelledAt:
          format: date-time
          type: string
        createdAt:
          format: date-time
          type: string
        currentDayIndex:
          type: integer
          example: 0
        currentScheduleId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        dueDate:
          example: '2026-04-25'
          format: date
          type: string
        executedAt:
          format: date-time
          type: string
        externalChargeId:
          example: 90d0b9e1551447f695985409bf9b7fb5
          type: string
        failedAt:
          format: date-time
          type: string
        failureCode:
          description: >-
            FailureCode es el código genérico que preserva la privacidad,
            reportado al receptor para el resultado actual del cobro (p. ej.
            CHARGE_REJECTED, OVER_LIMIT, ACCEPTED, DEBIT_FAILED). Es el ÚNICO
            código expuesto en la API de lectura y en el payload saliente; el
            motivo financiero interno nunca se incluye aquí.
          example: CHARGE_REJECTED
          type: string
        id:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        journey:
          enum:
            - J1
            - J2
            - J3
            - J4
          example: J4
          type: string
        maxAttempts:
          example: 4
          type: integer
        recurrenceId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        status:
          enum:
            - RECEIVED
            - SCHEDULED
            - EXECUTED
            - FAILED
            - CANCELLED
          example: SCHEDULED
          type: string
        updatedAt:
          format: date-time
          type: string
      type: object
    ChargeAttemptOutput:
      properties:
        attemptedAt:
          description: >-
            AttemptedAt es el instante en que se observó el resultado del
            intento: el instante canónico del intento, en ISO 8601 UTC. Se omite
            mientras el intento sigue abierto (aún no se observó un resultado
            terminal). Distinto de ScheduledFor, el instante de disparo
            planificado.
          format: date-time
          type: string
        dayIndex:
          type: integer
          example: 0
        endToEndId:
          description: >-
            EndToEndID es el id end-to-end del cashout generado para este
            intento, usado para conciliar la liquidación. Se omite para un
            intento heredado que no lo tiene.
          example: E30306294202606241200abcdef00001
          type: string
        failureCode:
          description: >-
            FailureCode es el código que preserva la privacidad ya reportado al
            receptor para este intento (p. ej. DEBIT_FAILED). Vacío cuando aún
            no se reportó nada. El motivo financiero interno nunca se incluye
            aquí.
          example: DEBIT_FAILED
          type: string
        failureMessage:
          description: >-
            FailureMessage es una descripción general y segura para el canal del
            resultado. Nunca revela el código de resultado interno.
          example: The debit attempt could not be completed.
          type: string
        outcome:
          enum:
            - EXECUTED
            - FAILED
            - CANCELLED
          example: EXECUTED
          type: string
        scheduleId:
          example: 019cf6ef-e418-7ced-80c0-7b9816faa798
          type: string
        scheduledFor:
          example: '2026-04-24T03:00:00Z'
          format: date-time
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````