Search Request Logs

Request body

qstring nullable

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.

sort_order'asc' | 'desc' nullable

Sort direction. Must be provided together with sort_by.

metadata_cost_breakdown_keystring nullable

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.

pageinteger nullable

Page number for pagination. Defaults to 1.

per_pageinteger nullable

Number of results per page. Defaults to 10, maximum 25.

include_prompt_nameboolean nullable

When true, includes the prompt template name in each result item. Defaults to false.

Example request

{
  "filter_group": {
    "logic": "AND",
    "filters": [
      {
        "field": "cost",
        "operator": "gte",
        "value": 0.1
      }
    ]
  },
  "page": 1,
  "per_page": 25,
  "sort_by": "cost",
  "sort_order": "desc"
}

Response

Paginated list of matching request logs.

successboolean

Indicates the request was successful.

pageinteger

Current page number.

pagesinteger

Total number of pages.

per_pageinteger

Number of results per page.

totalinteger

Total number of matching results.

has_nextboolean

Whether there are more pages after the current one.

has_prevboolean

Whether there are pages before the current one.

next_numinteger nullable

Next page number, or null if on the last page.

prev_numinteger nullable

Previous page number, or null if on the first page.

v2

Search Request Logs

Request body

Example request

Response