---
title: "Get Customer Stats"
method: GET
path: "/v1/shops/{shopId}/customers/stats"
tags: ["Customers"]
---

# Get Customer Stats

`GET /v1/shops/{shopId}/customers/stats`

## Request

- Base URL: `https://api.sellauth.com`
- URL: `https://api.sellauth.com/v1/shops/{shopId}/customers/stats`
- Auth: HTTP bearer

Retrieves customer counts for the last 30 days and the store balance customers hold.

## Path parameters

- `shopId` integer, required

## Query parameters

- `timezone` string: Time zone the 30-day window starts in, at midnight 29 days ago. Defaults to UTC.

## Request body

- object
  - `timezone` string, nullable

## Response `200`

- object
  - `new_30d` integer
  - `buyers` integer
  - `repeat_buyers` integer
  - `subscribers` integer
  - `balance_holders` integer
  - `balance_usd` integer

## Changes

- **2026-11-19** `a8aa0a1fa573`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/customers/stats/get.md)

---

[API](https://skmtc.dev/sellauth/apis/sellauth-api.md) - [All operations](https://skmtc.dev/sellauth/apis/sellauth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sellauth/apis/sellauth-api/revisions/a8aa0a1fa573?raw)
