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

# Get Reconciliation items

> Retrieve a list of Reconciliation items with pagination support. Use query parameters `startingAfter` and `limit` to navigate results.



## OpenAPI

````yaml https://sandbox-api.borderless.xyz/v1/api-json get /v1/reconciliation/items
openapi: 3.0.0
info:
  title: Borderless API
  description: The Borderless API documentation.
  version: '1.0'
  contact: {}
servers:
  - url: https://sandbox-api.borderless.xyz
security: []
tags: []
paths:
  /v1/reconciliation/items:
    get:
      tags:
        - Reconciliation
      summary: Get Reconciliation items
      description: >-
        Retrieve a list of Reconciliation items with pagination support. Use
        query parameters `startingAfter` and `limit` to navigate results.
      operationId: ReconciliationController_getItems
      parameters:
        - name: status
          required: false
          in: query
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ReconciliationStatus'
        - name: pfiName
          required: false
          in: query
          schema:
            $ref: '#/components/schemas/PFIName'
        - name: type
          required: false
          in: query
          schema:
            $ref: '#/components/schemas/ReconciliationRunType'
        - name: cadence
          required: false
          in: query
          schema:
            $ref: '#/components/schemas/ReconciliationCadence'
        - name: runId
          required: false
          in: query
          schema:
            type: string
        - name: from
          required: false
          in: query
          schema:
            format: date-time
            type: string
        - name: to
          required: false
          in: query
          schema:
            format: date-time
            type: string
        - name: startingAfter
          required: false
          in: query
          description: Id used to retrieve results that come after the specified item.
          schema:
            type: string
        - name: limit
          required: false
          in: query
          description: Response page limit. Min 1, Max 100, Default value is 10.
          schema:
            type: number
      responses:
        '200':
          description: List of Reconciliation items and `hasMore` flag.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedReconciliationItemEntity'
      security:
        - bearer: []
components:
  schemas:
    ReconciliationStatus:
      type: string
      enum:
        - Matched
        - Mismatched
        - Missing
        - PfiError
    PFIName:
      type: string
      enum:
        - Bridge
        - Koywe
        - Kotanipay
        - Hercle
        - Bitso
        - Yellowcard
        - TraceFinance
        - HoneyCoin
        - BlindPay
        - Finity
        - Infinia
        - Walapay
        - Abra
        - Yativo
        - Capa
        - Bivo
        - Cobre
        - Avenia
        - Brale
        - BVNK
        - CoinsPH
        - Iron
        - Enigma
        - Kira
        - TripleAStablecoin
        - TripleALocalCurrencyPayout
        - Onmeta
        - Alfred
        - Tazapay
        - Demo
        - CrissCross
        - Pockyt
    ReconciliationRunType:
      type: string
      enum:
        - Daily
        - Weekly
        - Monthly
        - Quarterly
        - Manual
        - Import
    ReconciliationCadence:
      type: string
      enum:
        - Daily
        - Weekly
        - Monthly
        - Manual
        - Import
    PaginatedReconciliationItemEntity:
      type: object
      properties:
        hasMore:
          type: boolean
        data:
          type: array
          items:
            $ref: '#/components/schemas/ReconciliationItemEntity'
      required:
        - hasMore
        - data
    ReconciliationItemEntity:
      type: object
      properties:
        id:
          type: string
        status:
          allOf:
            - $ref: '#/components/schemas/ReconciliationStatus'
        discrepancyType:
          allOf:
            - $ref: '#/components/schemas/DiscrepancyType'
        details:
          nullable: true
          type: object
          allOf:
            - $ref: '#/components/schemas/ReconciliationDetailsEntity'
        checkedAt:
          format: date-time
          type: string
        transactionId:
          type: string
        externalTransactionId:
          type: string
          nullable: true
        organizationId:
          type: string
        pfiName:
          allOf:
            - $ref: '#/components/schemas/PFIName'
        runId:
          type: string
          nullable: true
        type:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/ReconciliationRunType'
        cadence:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/ReconciliationCadence'
        createdAt:
          format: date-time
          type: string
        updatedAt:
          format: date-time
          type: string
        wasRegressed:
          type: boolean
          description: >-
            True when the transaction's latest run did not match while an
            earlier run matched it fully.
      required:
        - id
        - status
        - discrepancyType
        - details
        - checkedAt
        - transactionId
        - externalTransactionId
        - organizationId
        - pfiName
        - runId
        - type
        - cadence
        - createdAt
        - updatedAt
        - wasRegressed
    DiscrepancyType:
      type: string
      enum:
        - None
        - AmountMismatch
        - StatusMismatch
        - AmountAndStatusMismatch
        - NotFoundInPfi
        - NotFoundInBorderless
    ReconciliationDetailsEntity:
      type: object
      properties:
        borderless:
          $ref: '#/components/schemas/ReconciliationBorderlessRecordEntity'
        pfi:
          nullable: true
          description: null when the provider had no record or its report could not be read
          type: object
          allOf:
            - $ref: '#/components/schemas/ReconciliationProviderRecordEntity'
        diffs:
          description: What the comparison found, in words
          type: array
          items:
            type: string
        hold:
          type: string
          description: Why an automatic correction was held back
      required:
        - borderless
        - pfi
        - diffs
    ReconciliationBorderlessRecordEntity:
      type: object
      properties:
        externalId:
          type: string
          nullable: true
          description: The provider's id for the transaction, as Borderless recorded it
        externalStatus:
          type: string
          nullable: true
          description: The provider's status, as Borderless last recorded it
        externalType:
          type: string
          nullable: true
        sourceAmount:
          type: string
        destinationAmount:
          type: string
          nullable: true
      required:
        - externalId
        - externalStatus
        - sourceAmount
        - destinationAmount
    ReconciliationProviderRecordEntity:
      type: object
      properties:
        externalId:
          type: string
        status:
          type: string
          description: Raw status string from the provider
        normalizedStatus:
          allOf:
            - $ref: '#/components/schemas/TransactionStatus'
        sourceAmount:
          type: string
        destinationAmount:
          type: string
        sourceCurrency:
          type: string
        destinationCurrency:
          type: string
        type:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/TransactionType'
        rawData:
          type: object
          additionalProperties: true
          description: The provider's own payload; omitted for dashboard users
      required:
        - externalId
        - status
    TransactionStatus:
      type: string
      enum:
        - Submitted
        - Verifying
        - Orchestrating
        - Pending
        - Processing
        - AwaitingDocuments
        - Completed
        - Failed
        - Cancelled
        - Refunded
    TransactionType:
      type: string
      enum:
        - Deposit
        - Withdrawal
        - Exchange
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.