Developers
Orders and monthly analytics API
Read tenant sales orders and consolidated monthly analytics through the supported Chattill API v1 endpoints.
For Developers and data teams10 min readUpdated
Supported endpoints
| Method and path | Purpose |
|---|---|
| GET /api/v1/orders | Paginated tenant order feed. Drafts are excluded unless explicitly requested. |
| GET /api/v1/orders/{order_no} | One tenant-owned order by internal order number. |
| GET /api/v1/analytics/monthly | Monthly revenue, costs, profit and SKU consolidation. |
List orders
bash
curl 'https://chattill.com/api/v1/orders?page=1&limit=50&updated_after=2026-09-01T00:00:00Z' \
-H 'Authorization: Bearer YOUR_API_KEY'- page starts at 1.
- limit defaults to 50 and cannot exceed 100.
- status accepts one or more comma-separated statuses.
- from and to use YYYY-MM-DD.
- updated_after uses an ISO timestamp for incremental synchronization.
Incremental synchronization
For incremental reads, page through results ordered by update cursor and a stable identifier. Advance your stored cursor only after every page in the current window is committed successfully. Make the downstream upsert idempotent by order number.
Monthly analytics
bash
curl 'https://chattill.com/api/v1/analytics/monthly?from=2026-01&to=2026-09' \
-H 'Authorization: Bearer YOUR_API_KEY'The range accepts YYYY-MM and is limited to 24 months. The response distinguishes authoritative monthly advertising spend, when connected, from per-order attributed spend. Read the metadata before reconciling reports.
Related guides
Ready to use this in your workspace?
Sign in to continue setup, or review the tenant go-live checklist before sending live traffic.