---
title: "Customer analytics"
method: GET
path: "/admin/analytics/customers"
tags: ["Admin"]
---

# Customer analytics

`GET /admin/analytics/customers`

## Request

- Base URL: `https://api.presscart.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.presscart.com/admin/analytics/customers`
- Auth: HTTP bearer

Acquisition cohorts + retention, repeat-purchase rate, LTV distribution, and top accounts by spend (read-only, ascend-processor accounting DB).

## Query parameters

- `from` string, required
- `to` string, required
- `granularity` 'day' | 'week' | 'month'
- `top_accounts_limit` integer

## Response `200`

Customer analytics retrieved successfully

- object
  - `from` string, required
  - `to` string, required
  - `granularity` 'day' | 'week' | 'month', required
  - `summary` object, required
    - `total_customers` number, required
    - `repeat_customers` number, required
    - `repeat_purchase_rate` number, required
    - `total_ltv` number, required
    - `average_ltv` number, required
  - `cohorts` object[], required
    - `cohort_start` string, required
    - `cohort_size` number, required
    - `periods` object[], required
      - `period_index` integer, required
      - `active_customers` number, required
      - `retention_rate` number, required
  - `ltv_distribution` object[], required
    - `bucket` string, required
    - `customer_count` number, required
    - `total_ltv` number, required
  - `top_accounts` object[], required
    - `customer_email` string, required
    - `customer_name` string, required
    - `total_spent` number, required
    - `order_count` number, required

## Other responses

- `503`: Accounting database is not configured or unreachable

---

[API](https://skmtc.dev/presscart/apis/presscart-prod-api.md) · [All operations](https://skmtc.dev/presscart/apis/presscart-prod-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presscart/apis/presscart-prod-api/revisions/6cc194695138?raw)