---
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 changed from `object` to no type 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 changed from `string` to `integer`
  - for the `query` request parameter `offset`, the type 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/cc67dc949947/schema)