PRpromptlayer
tracking

Search Request Logs

Changed on
post/api/public/v2/requests/search

Request

Request body

qstring nullable

Free-text search query. Searches across the prompt input and LLM output text using fuzzy prefix matching.

sort_by'request_start_time' | 'input_tokens' | 'output_tokens' | 'cost' | 'latency_ms' | 'status' nullable

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.

Changes

  • 773ed3aacb73Revision changes
    • info

      added the new optional request property /

    • info

      added the new agent_intent enum value to the request property /////

    • info

      added the new user_intent enum value to the request property /////