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

> Returns the merchant's payments paired with the bank transactions that settled them, newest first by default.



## OpenAPI

````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/reconciliation/matches
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/matches:
    get:
      tags:
        - Reconciliation
      summary: List reconciliation matches
      description: >-
        Returns the merchant's payments paired with the bank transactions that
        settled them, newest first by default.
      operationId: findAllReconciliationMatches
      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 matches made (`createdAt`) on or after this date.
            type:
              - string
            example: '2026-09-01'
        - name: endDate
          in: query
          schema:
            description: Only matches made (`createdAt`) on or before this date.
            type:
              - string
            example: '2026-09-30'
        - name: sort
          in: query
          schema:
            description: >-
              Determines whether the page of items are sorted in ascending or
              descending order.
            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:
                        id:
                          type:
                            - string
                          format: uuid
                          maxLength: 36
                          description: The ID of a reconciliation match.
                          example: 3b9d6f2a-8c1e-4a7d-9f5b-2e0c4a6d8b13
                        payment:
                          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.
                        transaction:
                          type:
                            - object
                          properties:
                            id:
                              type:
                                - string
                              format: uuid
                              maxLength: 36
                              description: >-
                                The ID of a reconciliation transaction: one line
                                of the merchant's connected bank account
                                statement.
                              example: e7bf0d9e-af9e-4ac0-a5ed-0d6c6cec809d
                            status:
                              type:
                                - string
                              enum:
                                - MATCHED
                                - UNMATCHED
                              description: >-
                                MATCHED once the payment and a bank transaction
                                have been paired, automatically or by hand.
                              example: UNMATCHED
                            direction:
                              type:
                                - string
                              enum:
                                - CREDIT
                                - DEBIT
                              description: >-
                                CREDIT paid into the account; DEBIT paid out of
                                it.
                              example: CREDIT
                            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:
                                    - AED
                                    - AFN
                                    - ALL
                                    - AMD
                                    - ANG
                                    - AOA
                                    - ARS
                                    - AUD
                                    - AWG
                                    - AZN
                                    - BAM
                                    - BBD
                                    - BDT
                                    - BGN
                                    - BHD
                                    - BIF
                                    - BMD
                                    - BND
                                    - BOB
                                    - BOV
                                    - BRL
                                    - BSD
                                    - BTN
                                    - BWP
                                    - BYN
                                    - BZD
                                    - CAD
                                    - CDF
                                    - CHF
                                    - CLP
                                    - CNY
                                    - COP
                                    - CRC
                                    - CUC
                                    - CUP
                                    - CVE
                                    - CZK
                                    - DJF
                                    - DKK
                                    - DOP
                                    - DZD
                                    - EGP
                                    - ERN
                                    - ETB
                                    - EUR
                                    - FJD
                                    - FKP
                                    - GBP
                                    - GEL
                                    - GHS
                                    - GIP
                                    - GMD
                                    - GNF
                                    - GTQ
                                    - GYD
                                    - HKD
                                    - HNL
                                    - HTG
                                    - HUF
                                    - IDR
                                    - ILS
                                    - INR
                                    - IQD
                                    - IRR
                                    - ISK
                                    - JMD
                                    - JOD
                                    - JPY
                                    - KES
                                    - KGS
                                    - KHR
                                    - KMF
                                    - KPW
                                    - KRW
                                    - KWD
                                    - KYD
                                    - KZT
                                    - LAK
                                    - LBP
                                    - LKR
                                    - LRD
                                    - LSL
                                    - LYD
                                    - MAD
                                    - MDL
                                    - MGA
                                    - MKD
                                    - MMK
                                    - MNT
                                    - MOP
                                    - MUR
                                    - MVR
                                    - MWK
                                    - MXN
                                    - MYR
                                    - MZN
                                    - NAD
                                    - NGN
                                    - NIO
                                    - NOK
                                    - NPR
                                    - NZD
                                    - OMR
                                    - PAB
                                    - PEN
                                    - PGK
                                    - PHP
                                    - PKR
                                    - PLN
                                    - PYG
                                    - QAR
                                    - RON
                                    - RSD
                                    - RUB
                                    - RWF
                                    - SAR
                                    - SBD
                                    - SCR
                                    - SEK
                                    - SGD
                                    - SOS
                                    - SRD
                                    - SSP
                                    - STN
                                    - SYP
                                    - SZL
                                    - THB
                                    - TJS
                                    - TMT
                                    - TND
                                    - TOP
                                    - TRY
                                    - TTD
                                    - TWD
                                    - TZS
                                    - UAH
                                    - UGX
                                    - USD
                                    - UYU
                                    - UZS
                                    - VND
                                    - VUV
                                    - WST
                                    - XAF
                                    - XCD
                                    - XOF
                                    - XPF
                                    - YER
                                    - ZAR
                                    - ZMW
                                  description: >-
                                    ISO-4217 code of a currency payments
                                    currently accept.
                                  example: USD
                              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 Roqqett reference found in the transaction
                                description, which reconciliation matches on.
                                `null` when it has none.
                              example: RQ123456
                            description:
                              type:
                                - string
                              maxLength: 255
                              description: >-
                                The transaction description as the bank reported
                                it.
                              example: MyRef RQ123456 MyRef2
                            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 connected bank account the
                                transaction is on.
                            paymentId:
                              type:
                                - string
                                - 'null'
                              format: uuid
                              maxLength: 36
                              description: >-
                                The payment the transaction is matched to.
                                `null` while UNMATCHED.
                              example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                            bookedAt:
                              type:
                                - string
                                - 'null'
                              format: date-time
                              description: >-
                                When the bank confirmed the transaction. `null`
                                when the bank reported no confirmation time.
                              example: '2026-10-02T12:00:05Z'
                            receivedAt:
                              type:
                                - string
                                - 'null'
                              format: date-time
                              description: >-
                                When Roqqett received the transaction from the
                                bank. `null` when none was recorded.
                              example: '2026-10-02T12:10:00Z'
                            createdAt:
                              type:
                                - string
                              format: date-time
                              description: >-
                                The date the Resource was initially created. ISO
                                8601 format without milliseconds.
                          required:
                            - id
                            - status
                            - direction
                            - amount
                            - reference
                            - description
                            - bankDetails
                            - paymentId
                            - bookedAt
                            - receivedAt
                            - createdAt
                          description: >-
                            One line of the merchant's connected bank account
                            statement, as reconciliation sees it.
                        createdAt:
                          type:
                            - string
                          format: date-time
                          description: >-
                            The date the Resource was initially created. ISO
                            8601 format without milliseconds.
                      required:
                        - id
                        - payment
                        - transaction
                        - createdAt
                required:
                  - count
                  - rows
                example:
                  limit: 200
                  offset: 100
                  count: 67
                  rows:
                    - id: 3b9d6f2a-8c1e-4a7d-9f5b-2e0c4a6d8b13
                      payment:
                        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'
                      transaction:
                        id: e7bf0d9e-af9e-4ac0-a5ed-0d6c6cec809d
                        status: UNMATCHED
                        direction: CREDIT
                        amount:
                          amount: '10000.00'
                          currencyCode: USD
                        reference: RQ123456
                        description: MyRef RQ123456 MyRef2
                        bankDetails:
                          type: SORT_CODE
                          sortCode: '040004'
                          accountNumberLastFour: '5678'
                        paymentId: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                        bookedAt: '2026-10-02T12:00:05Z'
                        receivedAt: '2026-10-02T12:10:00Z'
                        createdAt: '2019-08-24T14:15:22Z'
                      createdAt: '2019-08-24T14:15:22Z'
        '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/matches?accountId={{accountId}}' \
              --header 'Authorization: <api-key>'
components:
  securitySchemes:
    CommonAuth:
      type: apiKey
      in: header
      name: Authorization

````