---
title: "List Settlements"
method: GET
path: "/settlement_accounts/{settlement_account_id}/settlements"
tags: ["Cash Settlement"]
---

# List Settlements

`GET /settlement_accounts/{settlement_account_id}/settlements`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/settlement_accounts/{settlement_account_id}/settlements`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/settlement_accounts/:settlement_account_id/settlements/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `settlement_account_id` string, required: A settlement account identifier

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponseSettlementResponse
  - `data` SettlementResponse[], required: The elements of the response.
    - `id` string, required: A value identifying the settlement.
    - `amount` string, required: The amount for the settlement.
    - `currency` string, required: An ISO 4217 three-letter currency code. Its value represents the currency for prices of the instrument listed here. The only currently available currency is "EUR".
    - `cutoff_timestamp` string, date-time, required: The point in time at which `debit` settlements have to be delivered and the point in time for cash distribution for `credit` settlements.
    - `direction` 'credit' | 'debit', required: A category representing the direction of settlement: <ul> <li><code>credit</code>: The settlement results in funds being credited (net-sell day). <li><code>debit</code>: The settlement results in funds being debited (net-buy day). </ul>
  - `pagination` Pagination, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)