v51

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2026-08-011534301009.2 KB

Customers

List customers

List customers.

get/api/v1/customers

Query parameters

pageinteger

Page index.

Default is 1.

pageSizeinteger

The maximum number of items per page.

Default is 100.

order'ASC' | 'DESC'

The order direction.

orderBy'id' | 'name' | 'createdAt'

Order by options for customers.

The order by field.

includeDeletedboolean

Include deleted customers.

keystring

Filter customers by key. Case-insensitive partial match.

namestring

Filter customers by name. Case-insensitive partial match.

primaryEmailstring

Filter customers by primary email. Case-insensitive partial match.

subjectstring

Filter customers by usage attribution subject. Case-insensitive partial match.

planKeystring

Filter customers by the plan key of their susbcription.

expandCustomerExpand[]

What parts of the list output to expand in listings

Response

The request has succeeded.

totalCountinteger required

The total number of items.

pageinteger required

The page index.

pageSizeinteger required

The maximum number of items per page.

Example response

{
  "totalCount": 500,
  "page": 1,
  "pageSize": 100,
  "items": [
    {
      "id": "01G65Z755AFWAKHE12NY0CQ9FH",
      "name": "ACME Inc.",
      "usageAttribution": {
        "subjectKeys": [
          "my_subject_key"
        ]
      },
      "createdAt": "2024-01-01T01:01:01.001Z",
      "updatedAt": "2024-01-01T01:01:01.001Z"
    }
  ]
}