---
title: "List settlement captures"
method: GET
path: "/v2/settlements/{settlementId}/captures"
tags: ["Settlements API"]
---

# List settlement captures

`GET /v2/settlements/{settlementId}/captures`

Retrieve all captures included in the given settlement.

The response is in the same format as the response of the [List captures endpoint](list-captures).

## Query parameters

- `from` string
- `limit` integer, nullable
- `embed` string, nullable

## Headers

- `idempotency-key` string

## Response `200`

A list of capture objects.

## Other responses

- `400` — The request contains issues. For example, if the specified `from` value is not a valid ID.
- `404` — No entity with this ID exists.
- `429` — Rate Limit has been reached.

## Changes

> 79 revisions in range; 9 not diffed.

- **2026-08-05** `392e474e7edc` — 1 info
  - added the optional write-only property `_embedded/captures/items/allOf[#/components/schemas/list-capture-response]/allOf[#/components/schemas/list-entity-capture]/testmode` to the response with the `200` status
- **2026-07-08** `1bcb76dbe9ea` — 1 breaking
  - the `count` response property's min was decreased from `1.00` to `0.00` for the response status `200`
- **2026-07-02** `e8c8cac71380` — 1 info
  - removed `subschema #2` from the `_embedded/captures/items/allOf[#/components/schemas/list-capture-response]/` response property `allOf` list for the response status `200`
- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-12** `ef4b5a97b56a` — 2 info
  - the endpoint scheme security `advancedAccessToken` was added to the API
  - the endpoint scheme security `organizationAccessToken` was removed from the API

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/settlements/:settlementId/captures/get.md)

---

[API](https://skmtc.dev/mollie/apis/mollie-api.md) · [All operations](https://skmtc.dev/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mollie/mollie-api/revisions/b7497b77b18f/schema)