---
title: "List Settlement Batches"
method: GET
path: "/v3/settlement-account/list-settlement-batches"
tags: ["Settlement Accounts"]
---

# List Settlement Batches

`GET /v3/settlement-account/list-settlement-batches`

## Request

- Base URL: `https://sandbox-api.transfi.com`
- URL: `https://sandbox-api.transfi.com/v3/settlement-account/list-settlement-batches`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/transfi/apis/transfi-single-integrated-api/docs/v3/settlement-account/list-settlement-batches/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of settlement batch details.

## Query parameters

- `page` integer
- `limit` integer

## Headers

- `MID` string, required

## Response `200`

Settlement batches listed successfully

- object
  - `status` string
  - `message` string
  - `data` object[]
    - `settlementId` string: Unique identifier of the settlement batch
    - `orgId` string: Organization the batch belongs to
    - `holdingCurrency` string: Currency the funds are held in before settlement
    - `totalAmountInHoldingCurrency` number: Total batched amount in the holding currency
    - `settlementCurrency` string: Currency the batch is settled in
    - `exchangeRateHoldingToSettlement` number: Exchange rate applied from holding to settlement currency
    - `settlementAmountToBeDelivered` number: Final amount to be delivered in the settlement currency
    - `transactionHash` string: On-chain transaction hash for crypto settlements (empty if not applicable)
    - `status` string: Current lifecycle status of the settlement batch
    - `settlementFeeCharged` number: Settlement fee charged on the batch
    - `transactions` string[]: Order IDs included in this settlement batch
    - `settlementTime` string, date-time: Scheduled settlement time for the batch
    - `timestamps` object: Lifecycle timestamps keyed by event (varies with batch status)
    - `createdAt` string, date-time
  - `pagination` object
    - `total` integer
    - `pages` integer
    - `currentPage` integer
    - `limit` integer
    - `hasNext` boolean
    - `hasPrev` boolean

## Other responses

- `400`: Validation error or page out of limit
- `500`: Internal server error

## Changes

- **2026-11-03** `7b745621a79f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/changes/v3/settlement-account/list-settlement-batches/get.md)

---

[API](https://skmtc.dev/transfi/apis/transfi-single-integrated-api.md) - [All operations](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/llms.txt) - [OpenAPI document](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/revisions/7b745621a79f?raw)