Get customer LTV by first-touch acquisition channel

GET

https://numueg.app/api/v1/stores/{store_id}/analytics/ltv-by-channel

Last modified:2026-09-19 16:39:33

x-numu-scope:analytics:read

LTV by acquisition channel — customer cohorts joined to lifetime orders.

The date_from/date_to window from the standard date-range
dependency is applied to customers.first_touch_at (cohort
selection), not to orders. The point of LTV-by-channel is to
see how much revenue each acquisition cohort eventually produces
over their entire history, so we don't crop the order side.

Channels are read from customers.first_touch_attribution —
customers without that field (no UTMs on first touch) fall into a
"direct" bucket so they aren't dropped from the rollup.

group_by accepts source (default), medium, or
campaign. Invalid values 422 at the route layer before any
DB work runs.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//analytics/ltv-by-channel?group_by=&days=&start_date=&end_date=&granularity=&tz=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "group_by": "string",
        "channels": [
            {
                "channel": "string",
                "customer_count": 0,
                "total_orders": 0,
                "total_revenue_cents": 0,
                "average_order_value_cents": 0,
                "orders_per_customer": 0,
                "ltv_cents": 0
            }
        ],
        "totals": {
            "customer_count": 0,
            "total_orders": 0,
            "total_revenue_cents": 0,
            "average_ltv_cents": 0
        }
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Get marketing attribution analytics

Get AI-powered store insights