> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.resemble.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.resemble.ai/_mcp/server.

# List Investigators

`GET https://app.resemble.ai/api/v2/agents`

Return the seven Resemble catalog investigators, followed by the authenticated team's active custom investigators. Use an investigator's `uuid` to [inspect it](/detect/investigator/get), run an investigation, or retrieve its run history.

```bash
curl --request GET 'https://app.resemble.ai/api/v2/agents' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

## Response

The example below abbreviates the `items` array to one catalog investigator. The complete response lists the seven catalog investigators first and then the team's custom investigators, so `count` is 7 plus the number of custom investigators.

```json
{
  "success": true,
  "items": [
    {
      "id": "verify_id",
      "uuid": "verify_id",
      "name": "Verify an ID",
      "description": "Verify a government-issued identity document and the person presenting it.",
      "preset_id": "verify_id",
      "tier": "forensic",
      "memory_preview": "(memory is empty - no patterns learned yet)",
      "capabilities": {
        "media": true,
        "reverse_search": true,
        "identity": true,
        "grounding": true,
        "structured": true,
        "tools": true,
        "knowledge": false
      },
      "tagline": "You operate inside an IDENTITY-VERIFICATION workflow.",
      "activated": true,
      "updated_at": "2026-08-11T16:45:00Z",
      "created_at": "2026-08-10T09:15:00Z"
    }
  ],
  "count": 7
}
```

## Response Fields

| Field            | Type             | Description                                                                                                                     |
| ---------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `id`             | `string`         | Stable investigator identifier, the same as `uuid`.                                                                             |
| `uuid`           | `string`         | Identifier used by the detail, run, and history endpoints: the `preset_id` for a catalog investigator, a UUID for a custom one. |
| `name`           | `string`         | Investigator display name.                                                                                                      |
| `description`    | `string \| null` | Verification workflow handled by the investigator.                                                                              |
| `preset_id`      | `string \| null` | Catalog investigator identifier, or `null` for a custom investigator.                                                           |
| `tier`           | `string`         | Managed investigation depth. Informational and read-only.                                                                       |
| `memory_preview` | `string`         | Read-only preview of patterns learned from previous runs.                                                                       |
| `capabilities`   | `object`         | Read-only feature flags describing the investigator.                                                                            |
| `tagline`        | `string \| null` | Short description derived from the investigator's instructions.                                                                 |
| `display`        | `object \| null` | Curated catalog metadata such as audience, outcome, and features. `null` for a custom investigator.                             |
| `activated`      | `boolean`        | Whether the team has initialized backing state for this investigator by running it.                                             |
| `created_at`     | `string \| null` | ISO 8601 timestamp for the team's backing state, or `null` before the investigator's first run.                                 |
| `updated_at`     | `string \| null` | ISO 8601 timestamp for the team's backing state, or `null` before the investigator's first run.                                 |

This endpoint returns every catalog investigator and the team's active custom investigators, and does not accept pagination or filtering parameters. Catalog order is managed by Resemble.