List request-log groups (POST filter)

POST

https://api.respan.ai/clickhouse/request-logs/groups/

POST

/clickhouse/request-logs/groups/

$ curl -X POST https://api.respan.ai/clickhouse/request-logs/groups/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "date_group": "2024-01-15T09:30:00Z"
> }'

201Created

1 {
2   "count": 25,
3   "results": [
4     {
5       "date_group": "2024-01-15T09:30:00Z",
6       "number_of_requests": 1,
7       "total_cost": 1.1,
8       "total_prompt_tokens": 1,
9       "total_completion_tokens": 1,
10       "total_tokens": 1,
11       "max_tpm": 1,
12       "error_count": 1,
13       "error_percentage": 1.1,
14       "average_prompt_tokens": 1,
15       "average_completion_tokens": 1,
16       "average_tokens": 1,
17       "average_cost": 1.1,
18       "average_latency": 1.1,
19       "average_tps": 1.1,
20       "average_ttft": 1.1,
21       "prompt_cache_hit_tokens": 1,
22       "reasoning_tokens": 1,
23       "max_cost": 1.1,
24       "max_tokens": 1,
25       "max_latency": 1.1,
26       "unique_customers": 1,
27       "latency_p_50": 1.1,
28       "latency_p_95": 1.1,
29       "latency_p_99": 1.1,
30       "cache_hit_percentage": 1.1,
31       "requests_per_second": 1.1
32     }
33   ],
34   "next": "string",
35   "previous": "string",
36   "total_count": 100,
37   "current_filters": {},
38   "filters_data": {}
39 }

Same as GET; the POST body carries a filters payload (POST-for-filtering — POST delegates to GET).

Authentication

AuthorizationBearer

JWT access token or Respan API key

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Request

This endpoint expects an object.

date_groupdatetimeRequired

number_of_requestsinteger or nullOptional

total_costdouble or nullOptional

total_prompt_tokensinteger or nullOptional

total_completion_tokensinteger or nullOptional

total_tokensinteger or nullOptional

max_tpminteger or nullOptional

error_countinteger or nullOptional

error_percentagedouble or nullOptional

average_prompt_tokensinteger or nullOptional

average_completion_tokensinteger or nullOptional

average_tokensinteger or nullOptional

average_costdouble or nullOptional

average_latencydouble or nullOptional

average_tpsdouble or nullOptional

average_ttftdouble or nullOptional

prompt_cache_hit_tokensinteger or nullOptional

reasoning_tokensinteger or nullOptional

max_costdouble or nullOptional

max_tokensinteger or nullOptional

max_latencydouble or nullOptional

unique_customersinteger or nullOptional

latency_p_50double or nullOptional

latency_p_95double or nullOptional

latency_p_99double or nullOptional

cache_hit_percentagedouble or nullOptional

requests_per_seconddouble or nullOptional

modelstringOptional>=1 character

Response

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

total_countinteger

current_filtersobject

Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters.

Each key is a metric name (str), and each value can be:

A single MetricFilterParamPydantic (one condition)
A List[MetricFilterParamPydantic] (multiple conditions for same metric)
A FilterBundlePydantic (nested filter bundle with connector)

Note: Uses extra=“allow” for dynamic metric name fields. The pydantic_extra annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.

filters_dataobject