**Source URL:** https://general.veevavault.dev/ai-agents/api/retrieve-agents.md

# Retrieve All Agents

<Aside type="note">The functionality described on this page is only available to customers who have licensed Veeva AI.</Aside>
Retrieve all of the agents in the authenticated Vault. Includes both System and custom agents.

<Endpoint path="/api/{version}/services/ai/agents" method="GET"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

#### Query Parameters {#query-parameters}

<FieldTable>
| Name | Description |
| --- | --- |
| `agent_name` | The name of an agent, for example, `promomats_document_chat__v`. Include to return information about this agent only. If omitted, retrieves all agents. |
| `available_by_user_name` | A Vault user name. Include to return the agents available to this user only. If omitted, retrieves all agents. |
| `object` | The name of a Vault object. Include to return agents configured on this object only. Required if `object_type` is set. If omitted, retrieves agents configured on all objects. |
| `object_type` | The name of a Vault object type. Include to return agents configured on this object type only. If specified, must also set the `object` query parameter. If omitted, retrieves agents configured on all object types. |
| `document_type` | The name of a document type. Include to return agents configured on this document type only. If omitted, retrieves agents configured on all document types. |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl --location 'https://myvault.veevavault.com/api/v26.1/services/ai/agents' \
--header 'Accept: application/json' \
--header 'Authorization: {SESSION_ID}' \
--header 'X-VaultAPI-ClientID: veeva-vault-api-reference-example'

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "agents": [
        {
            "name": "promomats_document_chat__v",
            "label": "Content Agent",
            "url": "/api/v26.1/services/ai/agents/promomats_document_chat__v"
        },
        {
            "name": "quick_check__v",
            "label": "Quick Check",
            "url": "/api/v26.1/services/ai/agents/quick_check__v"
        },
        {
            "name": "super_agent__sys",
            "label": "Super Agent",
            "url": "/api/v26.1/services/ai/agents/super_agent__sys"
        }
    ]
}

```
</CodeExample>

## Response Details {#response-details}

On `SUCCESS`, the response contains details about each agent.



---

**Previous:** [API Reference](/ai-agents/api)  
**Next:** [Retrieve Agent](/ai-agents/api/retrieve-agent)