> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List investigation reports

> Retrieve all AI-generated investigation reports.

Returns investigation reports generated by Smart Sentinel when an event warrants deeper analysis. Each report includes its sections, a summary, and the IDs of the events that triggered it. Reports are scoped to the authenticated customer.

## Query parameters

<ParamField query="vendorId" type="string">
  Filter to reports for a specific vendor.
</ParamField>

<ParamField query="from" type="string">
  Only include reports generated on or after this ISO 8601 date.
</ParamField>

<ParamField query="to" type="string">
  Only include reports generated on or before this ISO 8601 date.
</ParamField>

<ParamField query="page" type="integer" default="1" />

<ParamField query="limit" type="integer" default="20" />

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.vouchmark.com/v1/investigation/reports?vendorId=cmp_aBcD..." \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "reportId": "rpt_aBcD...",
        "planId": "pln_aBcD...",
        "vendorId": "cmp_aBcD...",
        "vendorName": "TEKCIFY TECHNOLOGIES LTD",
        "customerId": "usr_aBcD...",
        "triggeringEventIds": ["evt_xYz...", "evt_qRs..."],
        "sections": [
          {
            "title": "Timeline",
            "content": "2026-05-10: Sentinel detected TIN status change to INACTIVE.",
            "metadata": {}
          }
        ],
        "summary": "FIRS TIN was deactivated on 2026-05-10. The company filed an appeal which is pending.",
        "agentVersion": "2026.05.1",
        "scoreAtGeneration": 90,
        "generatedAt": "2026-05-11T08:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
  ```
</ResponseExample>

`vendorName`, `agentVersion`, and `scoreAtGeneration` may be `null`. Each section's `metadata` is an optional free-form object.