---
title: "List and search customers"
method: GET
path: "/customers"
tags: ["customers"]
---

# List and search customers

`GET /customers`

Returns a paginated list of customers sorted by creation date. Supports fuzzy search across customer names, business names, and email addresses, plus exact filtering by email and verification status. Default limit is 25 customers per page, maximum 200.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `status` string

## Headers

- `Accept` 'application/vnd.dwolla.v1.hal+json', required

## Response `200`

successful operation

## Other responses

- `403` — Forbidden

## Changes

- **2025-12-03** `32790f685ab9` — 1 info
  - added the optional property `total` to the response with the `200` status
- **2025-11-19** `e44b6a6d5724` — 2 breaking, 32 warning, 37 info
  - added `#/components/schemas/ReceiveOnlyCustomer` to the `_embedded/customers/items/` response property `oneOf` list for the response status `200`
  - the `_embedded/customers/items/oneOf[subschema #1: UnverifiedCustomer]/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `_embedded/customers/items/oneOf[subschema #1: UnverifiedCustomer]/_links` from the response with the `200` status
  - removed the optional property `_embedded/customers/items/oneOf[subschema #1: UnverifiedCustomer]/correlationId` from the response with the `200` status
  - …67 more
- **2025-06-06** `231d0268586b` — 2 breaking, 1 info
  - for the `query` request parameter `limit`, the type/format was changed from `string`/`` to `integer`/``
  - for the `query` request parameter `offset`, the type/format was changed from `string`/`` to `integer`/``
  - added the non-success response with the status `403`
- **2025-05-23** `4c8b16e05918` — 1 breaking
  - added the new required `header` request parameter `Accept`

[Change history](https://skmtc.dev/dwolla/apis/dwolla-api/changes/customers/get.md)

---

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