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": {}
}Endpoints
Retrieve advanced search
Retrieve the current state of a previously created Advanced Search, including raw results and the AI-generated report.
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
string
required
The
id returned when the Search was created.Response
Returns a JSON object representing the Search, including metadata, rawsearch_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.curl -X GET "https://parsagon.io/api/events/v1/search/12345/" \
-H "Authorization: Token YOUR_API_KEY_HERE"