Skip to main content
Retrieve the current state of a previously created Advanced Search. Poll this endpoint after creating a search to check whether processing is complete.
Searches typically complete within 1–5 minutes. Poll approximately once every 15 seconds until search_results, edited_results, and/or error are non-null.

​
Path parameters

​
string
required
The id returned when the Search was created.

​
Response

Returns a JSON object representing the Search, including metadata, raw search_results, and edited_results when available.
For Advanced Search requests created with is_test: true, this endpoint returns the dummy search_results and edited_results stored at creation time.
​
number | string
Unique identifier for the Search.
​
array
Array of category IDs used in the search.
​
string
Context provided in the request.
​
string
Filter prompt provided in the request.
​
string
Edit prompt provided in the request.
​
object
Labels provided in the request.
​
boolean
Whether the Search was created in test mode.
​
object
The date range used, containing either start_date and end_date, or duration_seconds.
​
string
Timestamp when the Search was created (ISO 8601, UTC).
​
array | null
Raw search results when processing is complete, null otherwise. Each item has the same fields as Quick Search results.
​
any | null
AI-generated report when processing is complete, null otherwise. For test searches, this is the value provided in test_data.edited_results, if any.
​
string | null
Error message if the search failed; otherwise null.