List customers | Pivotal Docs

const url = 'https://my.pivotal.app/api/v1/customers';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "object": "list",
  "data": [
    {
      "object": "customer",
      "id": "clx9f8g7h6j5k4l3m2n1",
      "display_id": 101,
      "name": "Acme Corporation",
      "slug": "acme-corp",
      "domain": "acmecorp.com",
      "status": "active",
      "plan": "enterprise",
      "mrr": 125000,
      "monthly_orders": 320,
      "hubspot_company_id": "hs_987654321",
      "hubspot_deal_id": "deal_123456789",
      "stripe_customer_id": "cus_J5K8L9M0N1O2P3",
      "intercom_company_id": "intco_456789123",
      "slack_channel_id": "C024BE7LT",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-20T14:45:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "2024-04-20T14:45:00Z"
}

const url = 'https://my.pivotal.app/api/v1/customers';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "object": "list",
  "data": [
    {
      "object": "customer",
      "id": "clx9f8g7h6j5k4l3m2n1",
      "display_id": 101,
      "name": "Acme Corporation",
      "slug": "acme-corp",
      "domain": "acmecorp.com",
      "status": "active",
      "plan": "enterprise",
      "mrr": 125000,
      "monthly_orders": 320,
      "hubspot_company_id": "hs_987654321",
      "hubspot_deal_id": "deal_123456789",
      "stripe_customer_id": "cus_J5K8L9M0N1O2P3",
      "intercom_company_id": "intco_456789123",
      "slack_channel_id": "C024BE7LT",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-20T14:45:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "2024-04-20T14:45:00Z"
}

Returns customers in the calling org, newest first. Cursor-paginated — pass next_cursor from a previous response back as cursor to get the next page.

Authentication

AuthorizationBearer

Send your key in the Authorization header. Keys start with pivotal_ (production) or pivotal_test_ (test mode, no side effects on integrations). Rotate keys from /admin/api-keys — old keys 401 instantly when revoked.

Query parameters

limitstringOptional

1–100, default 25.

cursordatetimeOptional

Pagination cursor from a previous response (ISO timestamp).

statusenumOptional

Allowed values:

Response

objectenum

Allowed values:

datalist of objects

has_moreboolean

next_cursorstring or null

Errors

401

Unauthorized Error

429

Too Many Requests Error

1	const url = 'https://my.pivotal.app/api/v1/customers';
2	const options = {
3	method: 'GET',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"object": "list",
3	"data": [
4	{
5	"object": "customer",
6	"id": "clx9f8g7h6j5k4l3m2n1",
7	"display_id": 101,
8	"name": "Acme Corporation",
9	"slug": "acme-corp",
10	"domain": "acmecorp.com",
11	"status": "active",
12	"plan": "enterprise",
13	"mrr": 125000,
14	"monthly_orders": 320,
15	"hubspot_company_id": "hs_987654321",
16	"hubspot_deal_id": "deal_123456789",
17	"stripe_customer_id": "cus_J5K8L9M0N1O2P3",
18	"intercom_company_id": "intco_456789123",
19	"slack_channel_id": "C024BE7LT",
20	"created_at": "2024-01-15T09:30:00Z",
21	"updated_at": "2024-04-20T14:45:00Z"
22	}
23	],
24	"has_more": true,
25	"next_cursor": "2024-04-20T14:45:00Z"
26	}