---
title: "Get Adhoc Execution"
method: GET
path: "/v1/retrievers/executions/{execution_id}"
tags: ["Adhoc Retrievers"]
---

# Get Adhoc Execution

`GET /v1/retrievers/executions/{execution_id}`

Get detailed execution information for a specific ad-hoc retriever execution.

Returns comprehensive execution details including:
    - Execution metadata (status, duration, credits used)
    - Performance metrics (documents processed/returned, cache hit rate)
    - Input data and query summary
    - Stage completion information
    - Collections queried

Use Cases:
    - Debug specific ad-hoc executions
    - Analyze performance of a particular query
    - Retrieve execution inputs for reproduction
    - Audit ad-hoc retriever usage

Raises:
    404 NotFoundError: If execution not found or not an ad-hoc execution

## Path parameters

- `execution_id` string, required — Execution identifier.

## Response `200`

Successful Response

- AdhocExecutionDetail — Detailed information about an ad-hoc retriever execution. Extends AdhocExecutionSummary with full input data and metadata for comprehensive execution analysis.
  - `execution_id` string, required — Unique execution identifier.
  - `execution_mode` string, required — Execution mode ('adhoc').
  - `status` string, required — Execution status ('completed', 'failed', etc.).
  - `timestamp` unknown, required
  - `duration_ms` number, required — Total execution duration in milliseconds.
  - `credits_used` number, required — Credits consumed during execution.
  - `total_processed` integer, required — Total documents processed across all stages.
  - `total_returned` integer, required — Number of documents returned in final results.
  - `cache_hit_rate` number, nullable — Cache hit rate across stages (0.0-1.0).
  - `query_summary` string, nullable — Brief summary of the query inputs.
  - `stages_completed` integer, required — Number of stages completed.
  - `total_stages` integer, required — Total number of stages in the pipeline.
  - `collection_ids` string[] — Collections queried during execution.
  - `inputs` string, nullable — Full input data provided for execution.
  - `inputs_hash` string, nullable — SHA-1 hash of inputs for deduplication.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/5d4c905106b4/schema)