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
}

Documentation Index

Fetch the complete documentation index at: https://docs.deeptrace.com/llms.txt

Use this file to discover all available pages before exploring further.

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.