Skip to main content
curl -X GET "https://parsagon.io/api/events/v1/search/12345/" \
  -H "Authorization: Token YOUR_API_KEY_HERE"

{
  "id": {},
  "categories": [
    {}
  ],
  "context": "<string>",
  "filter_prompt": "<string>",
  "edit_prompt": "<string>",
  "labels": {},
  "is_test": true,
  "date_range": {},
  "created_at": "<string>",
  "search_results": {},
  "edited_results": {},
  "error": {}
}
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

​
search_id
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.
​
id
number | string
Unique identifier for the Search.
​
categories
array
Array of category IDs used in the search.
​
context
string
Context provided in the request.
​
filter_prompt
string
Filter prompt provided in the request.
​
edit_prompt
string
Edit prompt provided in the request.
​
labels
object
Labels provided in the request.
​
is_test
boolean
Whether the Search was created in test mode.
​
date_range
object
The date range used, containing either start_date and end_date, or duration_seconds.
​
created_at
string
Timestamp when the Search was created (ISO 8601, UTC).
​
search_results
array | null
Raw search results when processing is complete, null otherwise. Each item has the same fields as Quick Search results.
​
edited_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.
​
error
string | null
Error message if the search failed; otherwise null.
curl -X GET "https://parsagon.io/api/events/v1/search/12345/" \
  -H "Authorization: Token YOUR_API_KEY_HERE"