DataProduct

Customer Cohorts

Get the single-customer cohorts for the company associated with the deal.

Returns the top 25 customers, ranked by combined ACV and total lifetime value, ordered by cohort date then cohort value.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

group_idintegerRequired
deal_idintegerRequired

Query parameters

user_typeenumRequired
metricstringRequired
freqenumOptional
Allowed values:

Response

Successful Response
cohortstring
The date of the cohort.
user_idstring

The user identifier for the user-cohort.

periodinteger
The period since the user joined. 0 is the first period.
cohort_size_amountdouble
The size denominated in the metric amount of the cohort.
logo_retentiondoubleOptional
Whether or not the user is active in the period.
amountdoubleOptional
The active amount, such as revenue or gtv, in the period for the user in the period.
amount_retentiondoubleOptional

The amount retention rate, defined as amount / cohort size amount.

ltvdoubleOptional
The cumulative lifetime value in terms of the metric amount up until the period, on average per user in the cohort.

Errors

422
Unprocessable Entity Error