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

# List payments

> List payments with cursor-based pagination.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/payment
openapi: 3.1.0
info:
  title: Nuvera API
  description: Nuvera Payment Platform REST API
  version: '1.0'
  contact: {}
servers:
  - url: http://localhost:45000
security: []
tags: []
paths:
  /api/v1/payment:
    get:
      tags:
        - Payments
      summary: List payments
      description: List payments with cursor-based pagination.
      operationId: PaymentController_list
      parameters:
        - name: status
          required: false
          in: query
          schema:
            type: string
            enum:
              - PENDING_REVIEW
              - CORRECTION_NEEDED
              - APPROVED
              - PROCESSING
              - COMPLETED
              - REJECTED
              - CANCELLED
        - name: customerId
          required: false
          in: query
          schema:
            type: string
        - name: beneficiaryId
          required: false
          in: query
          schema:
            type: string
        - name: dateFrom
          required: false
          in: query
          schema:
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            type: string
        - name: dateTo
          required: false
          in: query
          schema:
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            type: string
        - name: cursor
          required: false
          in: query
          schema:
            type: string
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 20
            type: integer
      responses:
        default:
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentListOutputDto_Output'
      security:
        - x-api-key: []
          signed-request: []
components:
  schemas:
    PaymentListOutputDto_Output:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              customerId:
                type: string
              beneficiaryId:
                type: string
              amount:
                type: string
              currencyCode:
                type: string
              internalReference:
                anyOf:
                  - type: string
                  - type: 'null'
              invoiceNumber:
                anyOf:
                  - type: string
                  - type: 'null'
              purposeOfPayment:
                type: string
              memo:
                anyOf:
                  - type: string
                  - type: 'null'
              paymentToken:
                anyOf:
                  - type: string
                  - type: 'null'
              paymentNetwork:
                anyOf:
                  - type: string
                  - type: 'null'
              paymentQuoteId:
                anyOf:
                  - type: string
                  - type: 'null'
              status:
                type: string
              createdAt:
                type: string
              updatedAt:
                type: string
              customer:
                type: object
                properties:
                  companyName:
                    type: string
                  status:
                    type: string
                  orgId:
                    type: string
                required:
                  - companyName
                  - status
                additionalProperties: false
              beneficiary:
                type: object
                properties:
                  companyName:
                    type: string
                  bankBic:
                    type: string
                  status:
                    type: string
                required:
                  - companyName
                  - bankBic
                  - status
                additionalProperties: false
              sourceFunding:
                anyOf:
                  - oneOf:
                      - type: object
                        properties:
                          type:
                            type: string
                            const: BANK_ACCOUNT
                          bankAccountId:
                            type: string
                          bankName:
                            type: string
                          countryCode:
                            type: string
                          currencyCode:
                            type: string
                          accountNumber:
                            anyOf:
                              - type: string
                              - type: 'null'
                          iban:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - type
                          - bankAccountId
                          - bankName
                          - countryCode
                          - currencyCode
                          - accountNumber
                          - iban
                        additionalProperties: false
                      - type: object
                        properties:
                          type:
                            type: string
                            const: CRYPTO
                          symbol:
                            type: string
                          network:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fundingStatus:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - type
                          - symbol
                          - network
                          - fundingStatus
                        additionalProperties: false
                  - type: 'null'
              rail:
                anyOf:
                  - type: object
                    properties:
                      method:
                        type: string
                      countryCode:
                        type: string
                    required:
                      - method
                      - countryCode
                    additionalProperties: false
                  - type: 'null'
              receiptUrl:
                anyOf:
                  - type: string
                  - type: 'null'
            required:
              - id
              - customerId
              - beneficiaryId
              - amount
              - currencyCode
              - internalReference
              - invoiceNumber
              - purposeOfPayment
              - memo
              - paymentToken
              - paymentNetwork
              - paymentQuoteId
              - status
              - createdAt
              - updatedAt
            additionalProperties: false
        nextCursor:
          anyOf:
            - type: string
            - type: 'null'
        hasMore:
          type: boolean
      required:
        - items
        - nextCursor
        - hasMore
      additionalProperties: false
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: Nuvera API application secret key
    signed-request:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: RS256 per-request signed JWT

````