**Source URL:** https://limited.veevavault.dev/medical/ai-agents/api/retrieve-agent

# Retrieve Agent

<Aside type="note">
The functionality described on this page is only available to customers who have licensed Vault AI.
</Aside>

Retrieve details of the specified agent, including all of the agent’s actions.

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

## Headers

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

## URI Path Parameters

<FieldTable>
| Name | Description |
| --- | --- |
| `{agent_name}` | The name of the agent to retrieve. For example, `promomats_document_chat__v`. |
</FieldTable>

## Request

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

## Response

<CodeExample title="">
```json
{
    "responseStatus": "SUCCESS",
    "agent": {
        "name": "quick_check__v",
        "label": "Quick Check",
        "status": true,
        "agentClass": "com.veeva.vault.system.agent.BaseDocumentAgent",
        "documentType": "base_document__v",
        "description": "Performs automated compliance and quality checks on documents in regulated industries to support faster, smoother MLR review. Identifies issues in areas such as important safety information (ISI), boxed warnings, privacy and unsubscribe links, spelling, grammar, accessibility, and risky phrase assessment. Use only for structured document quality checks, not general Q&A.",
        "source": "standard",
        "agentUser": "[agent]quick_check__v",
        "agentModelLevel": "ADVANCED",
        "actions": [
            {
                "name": "spelling_grammar__v",
                "label": "Spelling and Grammar",
                "url": "/api/v26.1/services/ai/agent_action/quick_check__v/spelling_grammar__v"
            },
            {
                "name": "privacy__v",
                "label": "Privacy Policy Link",
                "url": "/api/v26.1/services/ai/agent_action/quick_check__v/privacy__v"
            },
            {
                "name": "phrase_assessment__v",
                "label": "Phrase Assessment",
                "url": "/api/v26.1/services/ai/agent_action/quick_check__v/phrase_assessment__v"
            },
            {
                "name": "boxed_warning_detect__v",
                "label": "Boxed Warning Detect",
                "url": "/api/v26.1/services/ai/agent_action/quick_check__v/boxed_warning_detect__v"
            },
            {
                "name": "boxed_warning_assessment__v",
                "label": "Boxed Warning Assessment",
                "url": "/api/v26.1/services/ai/agent_action/quick_check__v/boxed_warning_assessment__v"
            }
        ]
    }
}
```
</CodeExample>

## Response Details

On `SUCCESS`, the response contains details about the specified agent and each action it can perform.

---

**Previous:** [Retrieve All Agents](/medical/ai-agents/api/retrieve-agents)  
**Next:** [Retrieve All Agent Actions](/medical/ai-agents/api/retrieve-agent-actions)