---
title: "One app's traffic over a window: totals and the period before, deltas, a series, breakdowns, what the figures cover, what they mean, and a summary in sentences"
method: GET
path: "/instances/{instance_id}/apps/{name}/analytics"
tags: ["analytics"]
---

# One app's traffic over a window: totals and the period before, deltas, a series, breakdowns, what the figures cover, what they mean, and a summary in sentences

`GET /instances/{instance_id}/apps/{name}/analytics`

## Request

- Base URL: `https://app.lathe.live/api/v1`
- URL: `https://app.lathe.live/api/v1/instances/{instance_id}/apps/{name}/analytics`
- Auth: none declared

## Path parameters

- `instance_id` string, required
- `name` string, required

## Query parameters

- `range` string: 1h, 24h, 72h, 7d, 30d, 90d or 365d; 24h when neither this nor from is given. Limited to what the plan keeps.
- `from` string: Start of a window in UTC, such as 2026-09-30 or 2026-09-30T14:00:00Z, instead of range.
- `to` string: End of that window in UTC; now when omitted.
- `compare` boolean: Also answer the period of the same length just before, and the deltas.
- `path` string: Only requests stored under this path, exactly.
- `referrer` string: Only requests referred by this host, exactly; (direct) for none.
- `status` string: Only this status code (404) or class (5xx).
- `host_kind` string: Only requests to the app's subdomain, a custom domain, or the box's own name: subdomain, custom or box.
- `breakdown` string[]: paths, referrers, countries, devices, browsers, os, statuses, host_kinds; repeat or separate with commas. With a filter, only that filter's dimension.
- `limit` integer: Rows per breakdown, 1 to 200.
- `cursor` string: A breakdown's next_cursor, for its next page.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lathe/apis/lathe-customer-api.md) · [All operations](https://skmtc.dev/lathe/apis/lathe-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lathe/apis/lathe-customer-api/revisions/68cfd9bb71c1?raw)