--- title: "API sample for historical search" slug: "api-sample-for-historical-search" tags: ["EDR with Forensics (EDRF)", "Endpoint Security", "Incident Responder"] updated: 2026-08-25T15:20:24Z published: 2026-08-26T19:31:36Z canonical: "docs.trellix.com/api-sample-for-historical-search" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # API sample for historical search The historical search APIs let you query stored endpoint telemetry over a defined time range. Use these endpoints to investigate past activity, hunt for indicators of compromise (IOCs), and reconstruct incident timelines. Historical search queries data that endpoints have already reported. **Endpoints** | Endpoint | Description | | --- | --- | | [POST request](/v1/docs/post-request-2) | Use this to submit a query and start a historical search job. | | [Get status](/v1/docs/get-status-1) | Use this to check whether a search job has finished. | | [Get result](/v1/docs/get-result-1) | Use this to retrieve completed results as paginated JSON. | | [Get result — file export](/v1/docs/get-result-file-export-1) | Use this to download the full result set as a CSV file. | ### Common reference All endpoints use the same authentication and request headers. Responses use the s0–s5 severity scale. For details, see [Security levels](/v1/docs/severity-levels-1).