---
title: "Get team orders distribution"
method: GET
path: "/teams/{teamId}/performance/orders"
tags: ["Team Performance"]
---

# Get team orders distribution

`GET /teams/{teamId}/performance/orders`

Order counts grouped by time breakdown (hour, day of week, day, week, month)

## Path parameters

- `teamId` string, required — Team identifier

## Query parameters

- `groupBy` 'HOUR' | 'DAY_OF_WEEK' | 'DAY' | 'WEEK' | 'MONTH' — Time breakdown for aggregation
- `timeZone` string — IANA time zone for interpreting date ranges
- `startDate` string, date, required — Start date (YYYY-MM-DD)
- `endDate` string, date, required — End date (YYYY-MM-DD)

## Response `200`

OK

- object
  - `groupBy` 'HOUR' | 'DAY_OF_WEEK' | 'DAY' | 'WEEK' | 'MONTH', required — The grouping used for aggregation
  - `buckets` object[], required
    - `key` union, required — Bucket key (hour 0-23, day 0-6, or date string)
      - number
      - string
    - `label` string, required — Human-readable label
    - `orderCount` number, required — Number of orders
    - `sharePercent` number, required — Percentage of total orders
  - `totalOrders` number, required — Total orders across all buckets

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `409` — 409
- `412` — 412
- `422` — 422
- `429` — 429
- `500` — 500
- `501` — 501
- `503` — 503

---

[API](https://skmtc.net/session/apis/session-services-api.md) · [All operations](https://skmtc.net/session/apis/session-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/session/session-services-api/versions/9f859678cfda/schema)