---
title: "Get stats for a single customer across the whole organisation"
method: GET
path: "/shop/customers/{customerId}/stats"
tags: ["Customers"]
---

# Get stats for a single customer across the whole organisation

`GET /shop/customers/{customerId}/stats`

Use this endpoint to retrieve high-level stats for a single customer.

## Response `200`

Contains the customer stats.

- object
  - `data` CustomerStats, required
    - `totals` CustomerStatsTotals, required
      - `total_order_value` integer, required — The total value of all submitted orders for this customer.
      - `average_order_value` integer, required — This customer's average order value.
      - `num_orders` integer, required — The number of orders this customer has made.
    - `recent_orders` OrderSummary[], required
      - `id` string, object-id, required — The ID of the order.
      - `order_ref` string, required — The order ref of the order.
      - `status` 'submitted' | 'settled' | 'cancelled' | 'no_show', required — The status of the order.
      - `num_items` integer — The number of items in the order.
      - `customer` SchemasCustomerSummary, required
        - `id` string, uuid, required — The ID of the customer.
        - `email` string, nullable, required — The email of the customer.
        - `first_name` string, nullable, required — The first name of the customer.
        - `last_name` string, nullable, required — The last name of the customer.
      - `sales_channel` SalesChannel, required
        - `id` string, object-id — The ID of the sales channel.
        - `name` string — The name of the sales channel.
      - `totals` OrderTotals, required
        - `subtotal` integer — The total cost of the order without order-level discounts, tip and service charge.
        - `order_discount` integer — The total amount of order-level discount applied to the order.
        - `total` integer — The total cost of the order after discount, tip and service charge.
      - `submitted_at` string, date-time, required — The date and time the order was submitted
      - `site` SiteSummary, required
        - `id` string, uuid, required — The ID of the site
        - `name` string, required — The name of the site
  - `meta` CustomerStatsMeta, required
    - `currency` string, required — The currency used for the customer stats

## Other responses

- `401` — The user is unauthenticated
- `404` — The resource couldn't be found

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)