---
title: "Retrieve payments"
method: POST
path: "/reconciliation/v1/payments"
tags: ["Reconciliation"]
---

# Retrieve payments

`POST /reconciliation/v1/payments`

Retrieve payments with reconciliation information.

## Request body

- object
  - `payment_initiation_date` object, required — Range of payment intiation dates of the payments that you want to fetch
    - `from` string, date, required — first UTC date of range
    - `to` string, date, required — last UTC date of range
  - `customer_id` string — Id of the customer you want to fetch payments for
  - `pagination` object — Parameters describing pagination you would like for the response
    - `page_number` integer, required — Page to retrieve
    - `results_per_page` integer, required — Number of objects per page

## Response `200`

- object
  - `payments` object[], required — List of payments with reconciliation information
    - `id` string — The unique identifier for the payment
    - `customer_id` string, required — Id of the customer who performed the payment
    - `payment_initiation_timestamp` string, date-time, required — The UTC datetime the payment was initiated
    - `reconciliation` object — Reconciliation information for the payment
      - `status` 'RECONCILED' | 'OUTSTANDING' | 'UNRECEIVED', required — If the payment has been reconciled, not reconciled yet or not received
      - `reference` string, required — Reference added when reconciling the payment
      - `amount` number, required — Amount reconciled
      - `currency_code` string, required — The 3 letter ISO code of currency of reconciliation
      - `deposit` object, required — Information about the bank deposit that the payment was reconciled against
        - `id` string, required — The unique identifier for the deposit.
        - `description` string, required — The description for the deposit as provided by the bank.
        - `timestamp` string, date-time, required — The UTC datetime the deposit was completed. Note that in the case the bank only provides the date with no time, we assume the transaction ocurred at 00:00 in the local timezone and then convert to UTC.
        - `amount` number, required — The amount of the deposit
        - `currency_code` string, required — The currency of the account where the deposit was received in
  - `pagination` object, required — Pagination information
    - `page_number` integer, required — Page retrieved
    - `results_per_page` integer, required — Number of objects per page
    - `total_results` integer, required — Total number of objects available to be retrieved

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)