---
title: "List transactions-recon"
method: GET
path: "/api/merchants/{merchantId}/transactions-recon"
tags: ["Transactions recon"]
---

# List transactions-recon

`GET /api/merchants/{merchantId}/transactions-recon`

List transactions for a merchant's reconciliation processes.

- Rate limit: One request per second
- Date limit: Cannot query transactions before 1 January 2023
- Date range limit: Cannot query transactions on a date range longer than 24 hours per request

For more information, see the [documentation](https://developer.peachpayments.com/docs/bus-ops-recon-api#/list-transactions-reconciliation-flow), and for sample calls, see the [public Postman collection](https://www.postman.com/peachpayments/peach-payments-public-workspace/request/knra3bn/recon-public?action=share&creator=20323380&ctx=documentation&active-environment=13324425-4d2ac6d5-12c6-4386-b5a9-605d38682519).

## Path parameters

- `merchantId` string, required

## Query parameters

- `startDate` string, date-time, required — ISO-8601 timestamp for the start of the date range in the request. If no timezone can be inferred from the timestamp, UTC+2 will be assumed. If no time (i.e. the `T00:00:00.000Z` part) is included, the beginning of that calendar day will be assumed. For example, `startDate=2024-03-14` will be changed to `startDate=2024-03-13T22:00:00.000Z`
- `endDate` string, date-time, required — ISO-8601 timestamp for the end of the date range in the request. If no timezone can be inferred from the timestamp, UTC+2 will be assumed. If no time (i.e. the `T00:00:00.000Z` part) is included, the end of that calendar day will be assumed. For example, `endDate=2024-03-15` will be changed to `endDate=2024-03-15T22:00:00.000Z`
- `isSuccessful` boolean
- `paymentMethod` string
- `batchNumber` string
- `settlementReference` string

## Headers

- `Accept-Encoding` string

## Response `200`

A list of transactions.

- object[]
  - `merchantId` string, required
  - `merchantName` string, required — The merchant's name.
  - `channelName` string, required — The channel's name.
  - `channelId` string, required
  - `merchantUsn` string, required — The merchant's unique serial number.
  - `batchNumber` string, required
  - `uniqueId` string, required
  - `transactionId` string, required
  - `customerName` string, required — The customer's name.
  - `accountHolder` string, required — The account holder.
  - `last4` string, required — Last 4 digits of the card number.
  - `bin` string, required — Bank identification number. First 6 numbers on the card. Identifies the institution that issued the card.
  - `expiryMonth` string, required — Calendar month when the card is expiring.
  - `expiryYear` string, required — Calendar year when the card is expiring.
  - `paymentType` 'DB' | 'RG' | 'PA' | 'RF' | 'CP' | 'RV' | 'CD' | 'RB', required
  - `paymentMethod` string, required — The payment method.
  - `brand` string, required — The payment brand.
  - `cardType` string, required — The card type.
  - `currency` string, required — The transaction's currency.
  - `createdAt` string, date-time, required — The time the transaction was created.
  - `updatedAt` string, date-time, required — The time the transaction was updated.
  - `issuer` string, required — The issuer.
  - `credit` number, required — This is the absolute value of the transaction amount if the amount is negative, otherwise 0.
  - `debit` number, required — This is the transaction amount if the amount is positive, otherwise 0.
  - `amount` number — The total transaction amount. If a tip is included, this value is inclusive of `tipAmount`. For direct-settled accounts, utilise this field for reconciliation instead of `settledAmount`.
  - `tipAmount` number — The tip portion included within the total `amount`. Returns `null` if no tip was given.
  - `settledAmount` number, required — The final settled amount after back-office processing is completed. This field is applicable to Peach-settled accounts only.
  - `settlementStatus` string, required — The settlement status. Relevant for Peach-settled accounts only.
  - `settlementReference` string, required — The Peach-generated reference as seen on a merchant's bank statement. Relevant for Peach-settled accounts only. Payment methods are settled in a single batch settlement. Unique per settlement.
  - `peachResult` 'successful' | 'failed' | 'cancelled' | 'pending', required — The Peach Payments result.
  - `bankResult` 'successful' | 'missing', required — The bank's result.
  - `reconResult` string, required — The reconciliation result.
  - `rrn` string, required — The retrieval reference number.

## Other responses

- `400` — An object containing the error message string.
- `401` — An object containing the error message string.
- `403` — An object containing the error message string.
- `500` — An object containing the error message string.

---

[API](https://skmtc.net/peachpayments/apis/checkout.md) · [All operations](https://skmtc.net/peachpayments/apis/checkout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peachpayments/checkout/versions/3a98165665f8/schema)