Customers

List customers

GET/v1/customers

Lists customers, newest first.

API key · or dashboard session.

Request

Shell
curl -fsS "$API/v1/customers?limit=50" \
  -H "Authorization: Bearer $PAYDAY_API_KEY"

Response

200 OK
{
  "customers": [ {
      "id": "cus_0198f80c-1111-7dc1-a369-90556a64f700",
      "name": "Globex",
      "email": "ap@globex.example",
      "details": "Attn: Accounts Payable",
      "created_at": "2026-09-06T12:00:00Z",
      "updated_at": "2026-09-06T12:00:00Z"
    } ],
  "next_cursor": null
}

Query parameters

limitinteger
1–100. Default 20.
starting_aftercus_ id
Cursor from next_cursor.

Response

{ customers: Customer[], next_cursor: cus_ id | null }.