Skip to main content
GET
Get a customer lifetime value summary

Authorizations

x-api-key
string
header
required

A server-side Bily API key created under Settings > MCP > Access key fallback. Select the intended store before creating it.

Headers

x-bily-organization-id
string

An organization ID returned by GET /context or GET /organizations. Required for GET /stores and optional for store-scoped paths.

Example:

"org_01J8W7T9G3E6ZQ4M2K5N8P1R0S"

Path Parameters

storeUrl
string
required

The exact store URL returned by GET /context or GET /stores.

Example:

"store.example.com"

Query Parameters

startDate
string<date>

Optional first date to include, in YYYY-MM-DD format.

endDate
string<date>

Optional last date to include, in YYYY-MM-DD format.

Response

Request completed successfully.

shop
string
required
currency
string | null
required
ltv_total_customers
number
required
ltv_total_orders
number
required
ltv_total_revenue
number
required
ltv_total_refunds
number
required
ltv_net_revenue
number
required
ltv_avg_order_value
number
required
ltv_30d
number
required
ltv_90d
number
required
ltv_6m
number
required
ltv_12m
number
required
ltv_avg_last_order_days_ago
number
required
ltv_avg_time_to_second_purchase_days
number
required