Retrieve a customer | Pivotal Docs

const url = 'https://my.pivotal.app/api/v1/customers/42';
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": "customer",
  "id": "clx7f9d2a9b3e4",
  "display_id": 42,
  "name": "Acme Co.",
  "slug": "acme-co",
  "domain": "acme.com",
  "status": "active",
  "plan": "enterprise",
  "mrr": 125000,
  "monthly_orders": 320,
  "hubspot_company_id": "123456789",
  "hubspot_deal_id": "987654321",
  "stripe_customer_id": "cus_J5k9vX2bL8Q7Yz",
  "intercom_company_id": "abc123def456",
  "slack_channel_id": "C01ABCD2EFG",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-04-20T14:45:00Z"
}

Fetch one customer by numeric display_id (shareable, appears in URLs) or canonical cuid id.

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.

Path parameters

idstringRequired

Numeric display_id or canonical cuid id.

Response

objectenum

idstring

display_idinteger

namestring

slugstring or null

domainstring or null

statusstring

planstring or null

mrrinteger or null

Monthly recurring revenue in cents.

monthly_ordersinteger or null

hubspot_company_idstring or null

hubspot_deal_idstring or null

stripe_customer_idstring or null

intercom_company_idstring or null

slack_channel_idstring or null

created_atdatetime

updated_atdatetime

Errors

401

Unauthorized Error

404

Not Found Error