Profitability
Get New vs Recurring Customers Over Time
GET
Returns a time series of new customers (first purchase in the point's period) and returning customers (had bought before) who placed an order. Suited to stacked bar or area charts.
- Periods of up to 31 days return daily points, matching
startDate–endDateexactly. - Longer periods, or no dates, return monthly points, with the period expanded to whole months.
- The
granularityfield tells which granularity was used.
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringOrganization identifier (required)
startDate?stringFirst day of the period, inclusive (YYYY-MM-DD). Applied only together with endDate; without both, the API uses the whole history.
Format
dateendDate?stringLast day of the period, inclusive (YYYY-MM-DD). Applied only together with startDate; without both, the API uses the whole history.
Format
dateNew vs recurring data retrieved successfully
application/json- response
data*array<>New vs recurring customer breakdown per period (month or day, see granularity)
granularity?stringSeries granularity, set by the period length: daily for up to 31 days, monthly for longer periods or no dates.
Value in
"monthly""daily"curl -X GET "https://example.com/v1/profitability/new-vs-recurring?organizationId=c0ad4763-173e-4a05-9cff-5208c8ea5f6a&startDate=2025-01-01&endDate=2025-12-31"{ "data": [ { "month": "2025-10-01", "newCustomers": 210, "recurringCustomers": 140, "totalCustomers": 350 }, { "month": "2025-11-01", "newCustomers": 195, "recurringCustomers": 158, "totalCustomers": 353 } ], "granularity": "monthly"}