Skip to main content
GET
https://parsagon.io
/
api
/
events
/
v1
/
search
/
{search_id}
Retrieve advanced search
curl --request GET \
  --url https://parsagon.io/api/events/v1/search/{search_id}
{
  "id": {},
  "categories": [
    {}
  ],
  "context": "<string>",
  "filter_prompt": "<string>",
  "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, with the same fields as the POST /search/ response.
​
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.
​
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
object | null
AI-generated monitoring report when processing is complete, null otherwise. Includes the report in both HTML and Markdown formats.
​
error
string | null
Error message if the search failed; otherwise null.

​
Example (cURL)

curl -X GET "https://parsagon.io/api/events/v1/search/12345/" \
  -H "Authorization: Token YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"