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

# List reconciliation payments

> Returns the merchant's completed payments and refunds with whether each is matched to a bank transaction, newest completed first by default.



## OpenAPI

````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/reconciliation/payments
openapi: 3.1.0
info:
  title: Roqqett API
  version: 2.0.0
  description: Version 2
  license:
    name: UNLICENSED
    url: https://docs.equalsmoney.com
servers:
  - url: https://api.equalsmoney.com/v2
    description: Production
security: []
paths:
  /roqqett/reconciliation/payments:
    get:
      tags:
        - Reconciliation
      summary: List reconciliation payments
      description: >-
        Returns the merchant's completed payments and refunds with whether each
        is matched to a bank transaction, newest completed first by default.
      operationId: findAllReconciliationPayments
      parameters:
        - name: limit
          in: query
          schema:
            description: The maximum number of results to return.
            default: 100
            type:
              - integer
            minimum: 1
            maximum: 1000
            example: 200
        - name: offset
          in: query
          schema:
            description: The number of items to skip before returning results.
            default: 0
            type:
              - integer
            minimum: 0
            example: 100
        - name: accountId
          in: query
          schema:
            description: The ID of the account to work with.
            type:
              - string
            example: F50091
          required: true
        - name: startDate
          in: query
          schema:
            description: >-
              Only payments completed (`completedAt`) on or after this date.
              Leaves out payments whose `completedAt` is `null`.
            type:
              - string
            example: '2026-09-01'
        - name: endDate
          in: query
          schema:
            description: >-
              Only payments completed (`completedAt`) on or before this date.
              Leaves out payments whose `completedAt` is `null`.
            type:
              - string
            example: '2026-09-30'
        - name: status
          in: query
          schema:
            type:
              - string
            enum:
              - MATCHED
              - UNMATCHED
            description: >-
              MATCHED once the payment and a bank transaction have been paired,
              automatically or by hand.
            example: UNMATCHED
        - name: sort
          in: query
          schema:
            description: >-
              Sorts by `completedAt`. Payments whose `completedAt` is `null`
              sort first ascending and last descending.
            type:
              - string
            enum:
              - asc
              - desc
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  limit:
                    description: The maximum number of results to return.
                    default: 100
                    type:
                      - integer
                    minimum: 1
                    maximum: 1000
                    example: 200
                  offset:
                    description: The number of items to skip before returning results.
                    default: 0
                    type:
                      - integer
                    minimum: 0
                    example: 100
                  count:
                    type:
                      - integer
                    description: >-
                      The total amount of records matching the querying when
                      "limit" is ignored.
                    example: 67
                  rows:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        paymentId:
                          type:
                            - string
                          format: uuid
                          maxLength: 36
                          description: The ID of a Roqqett payment or refund record.
                          example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                        type:
                          description: >-
                            PAYMENT moves money from the payer; REFUND moves it
                            back.
                          type:
                            - string
                          enum:
                            - PAYMENT
                            - REFUND
                          example: PAYMENT
                        status:
                          type:
                            - string
                          enum:
                            - MATCHED
                            - UNMATCHED
                          description: >-
                            MATCHED once the payment and a bank transaction have
                            been paired, automatically or by hand.
                          example: UNMATCHED
                        amount:
                          type:
                            - object
                          properties:
                            amount:
                              type:
                                - string
                              maxLength: 32
                              pattern: ^[0-9]+(\.[0-9]+)?$
                              description: >-
                                Decimal amount in major units, as a string.
                                Never a float.
                              example: '10000.00'
                            currencyCode:
                              type:
                                - string
                              enum:
                                - GBP
                                - EUR
                              description: >-
                                ISO-4217 code of a currency Roqqett can take
                                payments in: GBP over Faster Payments, EUR over
                                SEPA Instant.
                              example: GBP
                          required:
                            - amount
                            - currencyCode
                          description: >-
                            A money value: a decimal amount as a string plus an
                            ISO-4217 currency code.
                        reference:
                          type:
                            - string
                            - 'null'
                          minLength: 1
                          maxLength: 255
                          description: >-
                            The reference the payment carried to the merchant's
                            bank, which reconciliation matches on. `null` when
                            there was none.
                          example: RQ123456
                        merchantReference:
                          type:
                            - string
                            - 'null'
                          minLength: 1
                          maxLength: 128
                          description: >-
                            The merchant's own reference for this checkout
                            session, such as its order or basket ID. Shown to
                            the merchant, never to the payer's bank.
                          example: ORDER-10421
                        checkoutName:
                          type:
                            - string
                            - 'null'
                          maxLength: 255
                          description: >-
                            Name of the checkout the payment was taken on.
                            `null` when it was not taken on a named checkout.
                          example: Example Shop checkout
                        bankDetails:
                          discriminator:
                            propertyName: type
                          oneOf:
                            - type:
                                - object
                              properties:
                                type:
                                  type:
                                    - string
                                  enum:
                                    - SORT_CODE
                                sortCode:
                                  type:
                                    - string
                                  maxLength: 6
                                  description: UK sort code.
                                  example: '040004'
                                accountNumberLastFour:
                                  type:
                                    - string
                                  minLength: 4
                                  maxLength: 4
                                  description: Last four digits of the account number.
                                  example: '5678'
                              required:
                                - type
                                - sortCode
                                - accountNumberLastFour
                            - type:
                                - object
                              properties:
                                type:
                                  type:
                                    - string
                                  enum:
                                    - IBAN
                                ibanLastFour:
                                  type:
                                    - string
                                  minLength: 4
                                  maxLength: 4
                                  description: Last four characters of the IBAN.
                                  example: '3000'
                                bic:
                                  type:
                                    - string
                                  maxLength: 11
                                  description: BIC of the payee's bank.
                                  example: COBADEFFXXX
                              required:
                                - type
                                - ibanLastFour
                                - bic
                          description: >-
                            The merchant's bank account the payment paid into,
                            or a refund was paid from.
                        transactionId:
                          type:
                            - string
                            - 'null'
                          format: uuid
                          maxLength: 36
                          description: >-
                            The bank transaction the payment is matched to.
                            `null` while UNMATCHED.
                          example: e7bf0d9e-af9e-4ac0-a5ed-0d6c6cec809d
                        completedAt:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          description: >-
                            When the payment completed. `null` when none was
                            recorded.
                          example: '2026-10-02T12:00:05Z'
                      required:
                        - paymentId
                        - type
                        - status
                        - amount
                        - reference
                        - merchantReference
                        - checkoutName
                        - bankDetails
                        - transactionId
                        - completedAt
                      description: A completed payment or refund as reconciliation sees it.
                required:
                  - count
                  - rows
                example:
                  limit: 200
                  offset: 100
                  count: 67
                  rows:
                    - paymentId: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                      type: PAYMENT
                      status: UNMATCHED
                      amount:
                        amount: '10000.00'
                        currencyCode: GBP
                      reference: RQ123456
                      merchantReference: ORDER-10421
                      checkoutName: Example Shop checkout
                      bankDetails:
                        type: SORT_CODE
                        sortCode: '040004'
                        accountNumberLastFour: '5678'
                      transactionId: e7bf0d9e-af9e-4ac0-a5ed-0d6c6cec809d
                      completedAt: '2026-10-02T12:00:05Z'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
      security:
        - CommonAuth:
            - roqqett:recon:read:any
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.equalsmoney.com/v2/roqqett/reconciliation/payments?accountId={{accountId}}' \
              --header 'Authorization: <api-key>'
components:
  securitySchemes:
    CommonAuth:
      type: apiKey
      in: header
      name: Authorization

````