Skip to main content
GET
/
api
/
v1
/
investigations
/
{investigation_id}
curl https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8 \
  -H "X-API-Key: dt_your_key_here"

{
  "id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
  "status": "processing",
  "alert_summary": null,
  "investigation_text": null
}
Retrieve the current status and results of an investigation. Poll this endpoint until status is completed. Investigations typically complete in a few minutes.

​
Headers

​
X-API-Key
string
required
Your Deeptrace API key. Obtain from Settings > API Keys. Also accepts Authorization: Bearer <key>.

​
Parameters

​
investigation_id
string
required
UUID of the investigation, returned by Trigger Investigation.
curl https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8 \
  -H "X-API-Key: dt_your_key_here"

​
Returns

Returns an investigation object. While the investigation is running, status is processing and result fields are null. Once finished, status is completed and the full analysis is available. 
{
  "id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
  "status": "processing",
  "alert_summary": null,
  "investigation_text": null
}
​
id
string
UUID of the investigation.
​
status
string
processing while the investigation is running, completed when finished.
​
alert_summary
string | null
Short title summarizing the investigation findings. null while processing.
​
investigation_text
string | null
Full investigation results in markdown format. null while processing.
Completed investigations are also viewable at https://app.deeptrace.com/investigation/{id} with full citations and tool call details.