---
title: "Search Status"
method: GET
path: "/search/status/{task_id}"
tags: ["Search"]
---

# Search Status

`GET /search/status/{task_id}`

Query the status of any async search task (deep search or export).

## Path parameters

- `task_id` string, required

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- AgenticSearchStatusResponse — Response for checking agentic search status.
  - `task_id` string, required — Async task ID being queried.
  - `status` string, required — Current status (e.g. queued, running, completed, failed).
  - `start_time` string, required — Timestamp when the task started.
  - `current_phase` integer, nullable — Current pipeline phase index.
  - `progress_message` string, nullable — Human-readable progress message.
  - `close_time` string, nullable — Timestamp when the task finished.
  - `resource_handle_id` string, nullable — Handle for downloading exported results.
  - `total_results` integer, nullable — Total results found.
  - `exported_count` integer, nullable — Number of results actually exported.
  - `error` string, nullable — Error message if the operation failed.
  - `search_id` string, nullable — Search history ID returned by a previous search. Replays only the query shape; pass exclusions again on this request if they should apply.
  - `iterations` object[], nullable — Per-iteration debug data emitted by the agent.

## Other responses

- `400` — Request was rejected by the route's validation rules.
- `401` — Missing or invalid API key.
- `402` — Insufficient credits or no active subscription for this organization.
- `403` — Forwarded user_id does not belong to caller's organization.
- `404` — Search task or export file not found.
- `409` — Export workflow already running for this search.
- `422` — Request body failed validation.
- `429` — Rate limit exceeded.
- `500` — Unexpected server error. Retry with backoff.
- `502` — Upstream search backend returned an error.
- `503` — Search backend is not configured or unavailable.
- `504` — Upstream search backend timed out.

---

[API](https://skmtc.dev/sixtyfour/apis/sixtyfour-api.md) · [All operations](https://skmtc.dev/sixtyfour/apis/sixtyfour-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sixtyfour/sixtyfour-api/revisions/51f0a2b62b44/schema)