Agency RollupsPer-location stats

Per-location stats

One row per location: event volume, unique users, and unique sessions over the date window, plus the all-time live person count. Rows are zero-filled from the roster — a location that sent nothing in the window appears as a row of zeros, never an omission.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/agency/stats?location_ids=loc_abc123%2Cloc_def456&date_from=2026-08-01&date_to=2026-08-28" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": [
    {
      "location_id": "loc_abc123",
      "name": "Acme Dental",
      "active": true,
      "total_events": 48210,
      "unique_users": 6120,
      "unique_sessions": 9344,
      "people": 12873
    }
  ]
}
GET
/client/v1/agency/stats
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) only — a location secret key (sk_) gets 403 agency_required. Keys are server-side credentials; this surface serves no CORS headers on purpose. Agency-wide scoped keys (mcp_ with no fixed location) are accepted too and need agency:read; a client-bound mcp_ key gets 403 agency_key_required. See Using an mcp_ key over HTTP.

Agency key (ak_) only — a location secret key (sk_) gets 403 agency_required. Keys are server-side credentials; this surface serves no CORS headers on purpose. Agency-wide scoped keys (mcp_ with no fixed location) are accepted too and need agency:read; a client-bound mcp_ key gets 403 agency_key_required. See Using an mcp_ key over HTTP.
query
location_idsstring

Comma-separated location ids to narrow the roster. Every id must belong to this agency — a foreign id is 403 location_not_linked, never a silent empty result. Required in batches of up to 100 when the agency has more than 100 locations.

query
date_fromstring

ISO date the window starts at. Default: 30 days ago.

Format: date
query
date_tostring

ISO date the window ends at (inclusive day).

Format: date
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) only — a location secret key (sk_) gets 403 agency_required. Keys are server-side credentials; this surface serves no CORS headers on purpose. Agency-wide scoped keys (mcp_ with no fixed location) are accepted too and need agency:read; a client-bound mcp_ key gets 403 agency_key_required. See Using an mcp_ key over HTTP.

Query Parameters

location_idsstring

Comma-separated location ids to narrow the roster. Every id must belong to this agency — a foreign id is 403 location_not_linked, never a silent empty result. Required in batches of up to 100 when the agency has more than 100 locations.

Example:
loc_abc123,loc_def456
date_fromstring

ISO date the window starts at. Default: 30 days ago.

Example:
2026-08-01
date_tostring

ISO date the window ends at (inclusive day).

Example:
2026-08-28

Responses

successboolean
dataarray