---
title: "List customers"
method: GET
path: "/v0/customers"
tags: ["Customers"]
---

# List customers

`GET /v0/customers`

## Request

- Base URL: `https://orchestration.seismic.systems/api`
- URL: `https://orchestration.seismic.systems/api/v0/customers`
- Auth: API key in header `Api-Key`

One page of the org's customers, newest first. Filter with `customer_type`, `status` or `pending_rfi`, and page with `cursor`. `next_cursor` is `null` on the last page; a filtered page is still a full page, so an empty `customers` array together with a null `next_cursor` is the only end-of-list signal.

## Query parameters

- `customer_type` 'individual' | 'business'
- `status` 'draft' | 'submitted' | 'under_review' | 'action_required' | 'approved' | 'rejected' | 'terminally_rejected' | 'paused' | 'unknown'
- `pending_rfi` boolean
- `cursor` string
- `limit` integer

## Response `200`

One page of customers, newest first.

- ListCustomersResponse: `GET /v0/customers` response body.
  - `customers` CustomerListItem[], required
    - `created_at` string, date-time, required
    - `customer_type` 'individual' | 'business', required
    - `display_name` string, nullable: Human-readable label: "First Last" for individuals, legal name for businesses. `None` when no name fields have been filled in yet.
    - `email` string, nullable: Contact email from the customer's profile. `None` when none has been provided yet.
    - `id` string, uuid, required
    - `pending_rfi` boolean, required: `true` while an open request for information is outstanding on this verification. Raised by Seismic compliance and independent of the status, so it can be `true` at any status; answering every open item clears it. Resubmitting the profile does not.
    - `status` 'draft' | 'submitted' | 'under_review' | 'action_required' | 'approved' | 'rejected' | 'terminally_rejected' | 'paused' | 'unknown', required
  - `next_cursor` string, nullable: Pass back as `?cursor=` for the next page. `null` on the last page.

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/seismic/apis/seismic-orchestration-api.md) - [All operations](https://skmtc.dev/seismic/apis/seismic-orchestration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seismic/apis/seismic-orchestration-api/revisions/08ada1f159fa?raw)