---
title: "Retrieve (via POST) order count"
method: POST
path: "/analytics/shipping/orders/count/v1"
tags: ["/analytics", "/shipping"]
---

# Retrieve (via POST) order count

`POST /analytics/shipping/orders/count/v1`

Retrieves order counts bucketed by time period. | (AnalyticsTimePeriodReq) -> (AnalyticsTimeBucketRes)

## Request body

- AnalyticsTimePeriodReq
  - `start` string, date-time, required
  - `end` string, date-time, required
  - `granularity` 'hour' | 'day' | 'week' | 'month' | 'year'
  - `timezone` 'America/Los_Angeles' | 'America/Denver' | 'America/Chicago' | 'America/New_York' | 'America/Anchorage' | 'Pacific/Honolulu' | 'Europe/London' | 'Europe/Paris' | 'Europe/Berlin' | 'Europe/Amsterdam' | 'Europe/Rome' | 'Europe/Madrid' | 'Europe/Zurich' | 'Europe/Stockholm' | 'Europe/Warsaw' | 'Europe/Athens' | 'UTC'
  - `start_of_week` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday'

## Response `200`

Successful Response

- AnalyticsTimeBucketRes
  - `buckets` TimeBucket[], required
    - `period` string, date-time, required
    - `value` number, required
  - `total` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)