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

# Get Request Facets

`GET /v0/requests/facets`

Observed filter values from this team's requests in the selected window, intersected with filters on the other dimensions (a facet ignores its own selection so more values can be added). Values only: how often each one is used, and the search patterns, come from /v0/requests/facets/metrics. API keys are identifiers only; no credentials are returned.

## Query parameters

- `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.

## Response `200`

Successful Response

- RequestFacetValues — Which values exist, and nothing else: the payload the filter dropdowns need first.
  - `origins` string[], required
  - `endpoints` string[], required
  - `status_codes` integer[], required
  - `api_key_ids` string[], required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-11** `16937613a4ec` — 1 warning, 1 info
  - deleted the `query` request parameter `campaign_key`
  - added the new optional `query` request parameter `search_pattern_key`
- **2026-09-10** `6862391ec53d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/requests/facets/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)