Skip to main content
POST
/
v1
/
retrievers
/
executions
/
list
List Adhoc Executions
curl --request POST \
  --url https://api.mixpeek.com/v1/retrievers/executions/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "completed",
  "start_time": "<unknown>",
  "end_time": "<unknown>"
}
'
{
  "pagination": "<unknown>",
  "results": [
    {
      "execution_id": "<string>",
      "execution_mode": "<string>",
      "status": "<string>",
      "timestamp": "<unknown>",
      "duration_ms": 1,
      "credits_used": 1,
      "total_processed": 1,
      "total_returned": 1,
      "stages_completed": 1,
      "total_stages": 1,
      "cache_hit_rate": 0.5,
      "query_summary": "<string>",
      "collection_ids": [
        "<string>"
      ]
    }
  ],
  "total": 0
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer | null
Required range: 1 <= x <= 1000
offset
integer | null
Required range: 0 <= x <= 10000
cursor
string | null
include_total
boolean
default:false

Body

application/json

Request to list ad-hoc retriever executions with filtering.

Allows filtering by status, time range, and searching by query summary. Results are ordered by timestamp descending (most recent first).

status
string | null

Filter by execution status. Common values: 'completed', 'failed'. OPTIONAL - omit to see all statuses.

Example:

"completed"

start_time
any | null

Filter executions after this timestamp (inclusive). OPTIONAL - omit for no start time filter.

end_time
any | null

Filter executions before this timestamp (inclusive). OPTIONAL - omit for no end time filter.

Response

Successful Response

Response from listing ad-hoc retriever executions.

pagination
any
required

Pagination metadata.

results
AdhocExecutionSummary · object[]

List of ad-hoc execution summaries.

total
integer
default:0

Total number of ad-hoc executions matching filters.