---
title: "Get Request Analytics"
method: GET
path: "/v0/requests/analytics"
tags: ["Requests"]
---

# Get Request Analytics

`GET /v0/requests/analytics`

Daily request activity with one optional breakdown. Counts and actual ledger credits refer to requests that ran in the selected window, bucketed by request date. Split charges count a request once; credits include later charges for those requests. Use credit consumption for billing totals by charge date. Filters match the individual request log.

## Query parameters

- `group_by` 'search_pattern' | 'endpoint' | 'origin' | 'status', nullable
- `start_datetime` string, date-time, nullable
- `end_datetime` string, date-time, nullable
- `origins` UsageOrigin[], nullable
  - union
    - 'api' | 'app' | 'web' | 'mcp' | 'admin_mcp'
    - 'unassigned' | 'webhook'
- `endpoints` string[], nullable
- `status_codes` integer[], nullable
- `api_key_id` string, uuid, nullable
- `search_pattern_key` string, nullable
- `endpoint` string, nullable
- `origin` 'api' | 'app' | 'web' | 'mcp' | 'admin_mcp'
- `is_origin_app` boolean, nullable
- `types` RequestType[], nullable
- `min_credits_consumed` integer, nullable — Only requests whose total (api + ui) credits consumed are at least this.
- `max_credits_consumed` integer, nullable — Only requests whose total (api + ui) credits consumed are at most this.
- `timezone` string — IANA timezone, such as Europe/Madrid.

## Response `200`

Successful Response

- RequestAnalytics[]
  - `period_start` string, date-time, required
  - `number_of_requests` integer, required
  - `api_credits_consumed` integer, required
  - `ui_credits_consumed` integer, required
  - `group_key` string, nullable
  - `group_name` string, nullable
  - `search_type` 'jobs' | 'companies' | 'technologies', nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-11** `16937613a4ec` — 1 breaking, 1 warning, 3 info
  - removed the enum value `campaign` from the property `anyOf[subschema #1]/` of the `query` request parameter `group_by`
  - deleted the `query` request parameter `campaign_key`
  - added the new optional `query` request parameter `search_pattern_key`
  - added the enum value `search_pattern` to the property `anyOf[subschema #1]/` of the `query` request parameter `group_by`
  - …1 more
- **2026-09-10** `6862391ec53d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/requests/analytics/get.md)

---

[API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.dev/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/theirstack/apis/theirstack-api-reference/revisions/d33f66b4fd81?raw)