---
title: "List Available Experts"
method: GET
path: "/api/v1/agents"
tags: ["grep-public-api"]
---

# List Available Experts

`GET /api/v1/agents`

## Request

- Base URL: `https://api.grep.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.grep.ai/api/v1/agents`
- Auth: none declared

List available research experts (also served at ``/agents`` and ``/run/agents``).

Use these expert IDs in the 'expert_id' parameter when starting research
to get specialized research behavior for specific domains.

Example expert IDs:
- 'patent-expert' - Patent research with USPTO, EPO, Google Patents
- 'medical-expert' - Medical research with PubMed, clinical trials
- 'legal-expert' - Legal research with CourtListener, case law
- 'supply-chain-expert' - Supply chain with World Bank trade data

## Response `200`

Successful Response

- ExpertsListResponse: Available research experts.
  - `experts` ExpertInfo[], required
    - `description` string, nullable: What this expert specializes in
    - `entity_type` string, required: Primary entity type (company, person, patent, etc.)
    - `icon` string, nullable: Lucide icon name for UI
    - `id` string, required: Expert ID to use in 'expert_id' parameter
    - `is_default` boolean: True if this is the default fallback expert
    - `mcp_tools` string[]: MCP tools included with this expert
    - `name` string, required: Display name
    - `skills` string[]: Skills included with this expert
  - `total_count` integer, required

---

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