---
title: "List clients"
method: GET
path: "/v2/clients"
tags: ["Clients API"]
---

# List clients

`GET /v2/clients`

Retrieve a list of all clients linked to your account.

The results are paginated.

## Query parameters

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

## Headers

- `idempotency-key` string

## Response `200`

A list of client objects. For a complete reference of the client object, refer to the
[Get client endpoint](get-client) documentation.

## 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-07** `86a9cd830b06` — 2 warning
  - added the new `en_BE` enum value to the `_embedded/clients/items/allOf[subschema #2]/_embedded/organization/locale/allOf[#/components/schemas/locale-response]/` response property for the response status `200`
  - added the new `en_NL` enum value to the `_embedded/clients/items/allOf[subschema #2]/_embedded/organization/locale/allOf[#/components/schemas/locale-response]/` response property for the response status `200`
- **2026-08-06** `64c0511a62bc` — 1 warning, 1 info
  - added the new `undefined` enum value to the `_embedded/clients/items/allOf[subschema #2]/_embedded/organization/locale/allOf[#/components/schemas/locale-response]/` response property for the response status `200`
  - removed the `null` enum value from the `_embedded/clients/items/allOf[subschema #2]/_embedded/organization/locale/allOf[#/components/schemas/locale-response]/` response property for the response status `200`
- **2026-07-08** `4d4ab81fb2d5` — 2 warning
  - added the new `cs_CZ` enum value to the `_embedded/clients/items/allOf[subschema #2]/_embedded/organization/locale/allOf[#/components/schemas/locale-response]/` response property for the response status `200`
  - added the new `sk_SK` enum value to the `_embedded/clients/items/allOf[subschema #2]/_embedded/organization/locale/allOf[#/components/schemas/locale-response]/` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/clients/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)