---
title: "get list of payments"
method: GET
path: "/v3/reconciliation/payments"
tags: ["payoutPayments"]
---

# get list of payments

`GET /v3/reconciliation/payments`

Endpoint to get list of payments

## Query parameters

- `payout-id` string
- `size` integer
- `page` integer
- `start-date` string, date
- `end-date` string, date

## Response `200`

returns all the payments for this payout

- PayoutPaymentsResponse — Base paginated list response
  - `size` integer, required — the total number of elements in the current page of this response
  - `totalPages` integer, required — the total number of pages in the response
  - `totalElements` integer, required — the total number of elements in the response
  - `number` integer, required — the current page number
  - `payments` PaymentDetails[], required — a list of payments included in the payout.
    - `paymentId` string, required — The id of the payment
    - `payoutId` string — The id of the payout
    - `paymentProfileId` string, required — The profile id of the merchant used in the transaction
    - `merchantName` string, required — The name of the merchant
    - `paymentChannel` 'ONLINE' | 'INSTORE' | 'INVOICE', required — "The channel of the payment"
    - `currency` 'EUR', required — currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)
    - `amount` integer, required — Total amount in cents of the transaction
    - `reference` string — The reference provided by the merchant/partner during a payment/refund
    - `description` string — The description provided by the merchant/partner during a payment/refund
    - `transactionDate` string, date-time, required — timestamp, when transaction was created in UTC

## Other responses

- `400` — Error codes: * _BAD_REQUEST_ - some field in the request was not formatted correctly
- `401` — If JWS signature is not valid. Error codes: * _UNAUTHORIZED_ - caller doesn't have valid authentication credentials
- `403` — Error codes: * _ACCESS_DENIED_ - operation not allowed, caller doesn't have required authorities
- `404` — Error codes: * _PAYOUT_NOT_FOUND_ - payout with the id not found
- `500` — Error codes: * _TECHNICAL_ERROR_ - technical error
- `503` — Service is unavailable

---

[API](https://skmtc.net/bancontactpro/apis/merchant-reconciliation-api.md) · [All operations](https://skmtc.net/bancontactpro/apis/merchant-reconciliation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bancontactpro/merchant-reconciliation-api/versions/8124fa43e7e9/schema)