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

# List customers

`GET /customers`

## Request

- Base URL: `https://api.moonclerk.com`
- URL: `https://api.moonclerk.com/customers`
- Auth: API key in header `Authorization`

Returns customers and their subscription info. These are the records the MoonClerk web interface calls "Plans". Filters may be combined; all date filters are `YYYY-MM-DD` and UTC-based, with `*_from` starting at the beginning of the day and `*_to` running through the end of it.

## Query parameters

- `count` integer
- `offset` integer
- `form_id` integer
- `checkout_from` string, date
- `checkout_to` string, date
- `next_payment_from` string, date
- `next_payment_to` string, date
- `status` 'active' | 'canceled' | 'expired' | 'past_due' | 'pending' | 'unpaid'

## Response `200`

A page of customers.

## Other responses

- `401`: Missing or invalid API key. The body is currently `text/plain` (`HTTP Token: Access denied.`), not JSON.
- `429`: Throttling limit exceeded. Reduce the number and frequency of calls, then retry. No `RateLimit` or `Retry-After` headers are currently published.
- `500`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.
- `502`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.
- `503`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.
- `504`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.

---

[API](https://skmtc.dev/moonclerk/apis/moonclerk-api.md) · [All operations](https://skmtc.dev/moonclerk/apis/moonclerk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/moonclerk/apis/moonclerk-api/revisions/168fe9354080?raw)