curl --request POST \
--url https://api.promptlayer.com/api/public/v2/requests/analytics \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"filter_group": {
"logic": "AND",
"filters": [
{
"field": "engine",
"operator": "is",
"value": "gpt-4o"
},
{
"field": "request_start_time",
"operator": "between",
"value": [
"2025-03-08T00:00:00Z",
"2025-03-15T00:00:00Z"
]
}
]
}
}
'{
"success": true,
"chartInterval": {
"interval": "day",
"bucketSizeMs": 86400000,
"bucketMinutes": null
},
"averageLatency": 1.2,
"totalCost": 12.34,
"totalTokens": 120000,
"totalRequests": 2500,
"totalCachedTokens": 15000,
"totalThinkingTokens": 3000,
"cacheTokenRatio": 0.18,
"stats": [
{
"date": "2025-03-15",
"requests": 120,
"tokens": 5400,
"inputTokens": 3000,
"outputTokens": 2400,
"cost": 0.84,
"latency": 1.1
}
],
"mostUsedModels": [
[
"gpt-4o",
2500
]
],
"modelRequestsByDay": {
"gpt-4o": [
[
"2025-03-15",
120
]
]
},
"latency": {
"average_latency": {
"2025-03-15": 1.2
},
"p50_latency": {
"2025-03-15": 0.9
},
"p90_latency": {
"2025-03-15": 2.1
},
"p95_latency": {
"2025-03-15": 2.6
}
}
}Request Analytics
curl --request POST \
--url https://api.promptlayer.com/api/public/v2/requests/analytics \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"filter_group": {
"logic": "AND",
"filters": [
{
"field": "engine",
"operator": "is",
"value": "gpt-4o"
},
{
"field": "request_start_time",
"operator": "between",
"value": [
"2025-03-08T00:00:00Z",
"2025-03-15T00:00:00Z"
]
}
]
}
}
'{
"success": true,
"chartInterval": {
"interval": "day",
"bucketSizeMs": 86400000,
"bucketMinutes": null
},
"averageLatency": 1.2,
"totalCost": 12.34,
"totalTokens": 120000,
"totalRequests": 2500,
"totalCachedTokens": 15000,
"totalThinkingTokens": 3000,
"cacheTokenRatio": 0.18,
"stats": [
{
"date": "2025-03-15",
"requests": 120,
"tokens": 5400,
"inputTokens": 3000,
"outputTokens": 2400,
"cost": 0.84,
"latency": 1.1
}
],
"mostUsedModels": [
[
"gpt-4o",
2500
]
],
"modelRequestsByDay": {
"gpt-4o": [
[
"2025-03-15",
120
]
]
},
"latency": {
"average_latency": {
"2025-03-15": 1.2
},
"p50_latency": {
"2025-03-15": 0.9
},
"p90_latency": {
"2025-03-15": 2.1
},
"p95_latency": {
"2025-03-15": 2.6
}
}
}Behavior Notes
- The response is an aggregated payload, not a paginated list of rows.
- Bucket size is selected automatically based on the filtered time range.
sort_byandsort_orderare accepted for query compatibility but do not affect aggregated output.
Related
Body
Canonical request-log query payload — the filter / search / sort fields shared by POST /api/public/v2/requests/search (which also accepts pagination + include_prompt_name) and POST /api/public/v2/requests/analytics.
Response
Aggregated analytics for the matching request logs.
Aggregated analytics across the matching request logs. Bucket size is selected automatically based on the filter time range (seconds → minutes → hours → days).
Cost and request count breakdown by metadata key-value pairs. When metadata_cost_breakdown_key is set in the request, all entries share that key and the label equals the value. Otherwise entries span the top key-value combinations and label is key = value. Ordered by cost descending; up to 50 entries.
Show child attributes
Show child attributes
Was this page helpful?

