---
title: "List an agent's investigations"
method: GET
path: "/v1/agents/{id}/investigations"
tags: ["Agents"]
---

# List an agent's investigations

`GET /v1/agents/{id}/investigations`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/agents/{id}/investigations`
- Auth: one of:
  - API key in header `GREPR-API-KEY`
  - OpenID Connect (`https://grepr-prod.us.auth0.com/.well-known/openid-configuration`)

Returns the investigations the agent has run, newest first.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `pageSize` integer
- `statuses` string[]
- `hasActions` boolean
- `triggers` string[]

## Response `200`

Investigations retrieved successfully

- InvestigationsList
  - `investigations` ItemsCollectionInvestigationSummary
    - `items` InvestigationSummary[]
      - `actions` InvestigationAction[]
        - `description` string
        - `toolCallId` string
        - `toolName` string
        - `url` string
      - `agentId` string
      - `createdAt` string, date-time
      - `endedAt` string, date-time
      - `inputTokens` integer
      - `investigationId` string
      - `live` boolean
      - `outputTokens` integer
      - `resumable` boolean
      - `startedAt` string, date-time
      - `status` 'QUEUED' | 'RUNNING' | 'STOPPING' | 'CANCELLING' | 'STOPPED' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'DISCARDED'
      - `summary` string
      - `triggerSignals` TriggerSignal[]
        - `source` string
        - `type` string
  - `limit` integer
  - `start` integer
  - `total` integer

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)