Customers API

Retrieve customer data and interaction timelines.

List customers


GET /api/v1/customers
Authorization: Bearer <token>

Returns the top 100 customers sorted by lastSeen (most recent first).

Get a customer


GET /api/v1/customers/:id
Authorization: Bearer <token>

Returns the customer profile along with their touchpoints.

Customer timeline


GET /api/v1/customers/:id/timeline
Authorization: Bearer <token>

Returns all touchpoints for this customer ordered chronologically (ascending). Each touchpoint includes the action, channel, campaign attribution, and timestamp.

Endpoint	Description
`GET /api/v1/segments`	List all customer segments
`GET /api/v1/campaigns`	List all campaigns
`GET /api/v1/opportunities`	Top 50 opportunities by score
`GET /api/v1/journeys`	List customer journeys
`GET /api/v1/cohorts`	List algorithm-discovered cohorts
`GET /api/v1/products`	List products

Customers API

List customers

Get a customer

Customer timeline

Related endpoints