curl --request POST \
--url https://api.promptlayer.com/api/public/v2/requests/search \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"filter_group": {
"logic": "AND",
"filters": [
{
"field": "cost",
"operator": "gte",
"value": 0.1
},
{
"field": "request_start_time",
"operator": "after",
"value": "2025-03-14T00:00:00Z"
}
]
},
"sort_by": "cost",
"sort_order": "desc"
}
'{
"success": true,
"items": [
{
"id": 12345,
"engine": "gpt-4o",
"provider_type": "openai",
"input_tokens": 150,
"output_tokens": 300,
"price": 0.005,
"request_start_time": "2025-03-15T10:30:00Z",
"request_end_time": "2025-03-15T10:30:01Z",
"latency": 1.234,
"tags_array": [
"production"
],
"metadata": [
{
"user_id": "customer_123"
}
],
"scores": [],
"prompt_name": "support-response"
}
],
"page": 1,
"pages": 5,
"per_page": 25,
"total": 112,
"has_next": true,
"has_prev": false,
"next_num": 2,
"prev_num": null
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"success": false,
"message": "Rate limit exceeded. Please retry later."
}Search Request Logs
curl --request POST \
--url https://api.promptlayer.com/api/public/v2/requests/search \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"filter_group": {
"logic": "AND",
"filters": [
{
"field": "cost",
"operator": "gte",
"value": 0.1
},
{
"field": "request_start_time",
"operator": "after",
"value": "2025-03-14T00:00:00Z"
}
]
},
"sort_by": "cost",
"sort_order": "desc"
}
'{
"success": true,
"items": [
{
"id": 12345,
"engine": "gpt-4o",
"provider_type": "openai",
"input_tokens": 150,
"output_tokens": 300,
"price": 0.005,
"request_start_time": "2025-03-15T10:30:00Z",
"request_end_time": "2025-03-15T10:30:01Z",
"latency": 1.234,
"tags_array": [
"production"
],
"metadata": [
{
"user_id": "customer_123"
}
],
"scores": [],
"prompt_name": "support-response"
}
],
"page": 1,
"pages": 5,
"per_page": 25,
"total": 112,
"has_next": true,
"has_prev": false,
"next_num": 2,
"prev_num": null
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"success": false,
"message": "Rate limit exceeded. Please retry later."
}Behavior Notes
- This endpoint is rate limited to 10 requests per minute.
- Results are capped at 25 items per page.
- Use
filter_groupfor structured filters andqfor fuzzy prefix search across prompt input and LLM output text. - Search indexing, nested fields, and operator behavior are explained in Search Data Model.
Related
Authorizations
Body
Search and filter request logs with structured filters, free-text search, sorting, and pagination. Extends RequestLogQuery with pagination and include_prompt_name.
Nested filter group with AND/OR logic. Use this for complex queries.
Show child attributes
Show child attributes
Free-text search query. Searches across the prompt input and LLM output text using fuzzy prefix matching.
Field to sort results by. Does not affect aggregated output for /requests/analytics.
request_start_time, input_tokens, output_tokens, cost, latency_ms, status Sort direction. Must be provided together with sort_by.
asc, desc When provided, the analytics response includes a metadataValueBreakdown array with cost and request counts for each value of this metadata key. Omit or pass null to get an aggregate breakdown across the top metadata keys.
Page number for pagination. Defaults to 1.
x >= 1Number of results per page. Defaults to 10, maximum 25.
1 <= x <= 25When true, includes the prompt template name in each result item. Defaults to false.
Response
Paginated list of matching request logs.
Paginated search results.
Indicates the request was successful.
List of matching request log summaries.
Show child attributes
Show child attributes
Current page number.
Total number of pages.
Number of results per page.
Total number of matching results.
Whether there are more pages after the current one.
Whether there are pages before the current one.
Next page number, or null if on the last page.
Previous page number, or null if on the first page.
Was this page helpful?