> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voicy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Agent

> Retrieve a single agent and its variable contract

Returns an [Agent](/api-reference/models/agent) object, including its
`variables_provided` and `variables_extracted`. Works for both prompt-based and
flow agents; an agent's internal flow configuration is never returned.

## Path Parameters

<ParamField path="agent_id" type="string" required>
  The agent's unique identifier (UUID).
</ParamField>

## Response

An [Agent](/api-reference/models/agent) object.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.voicy.co/functions/v1/agent-get/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer voicy_sk_live_xxx"
  ```

  ```javascript JavaScript theme={null}
  const id = '550e8400-e29b-41d4-a716-446655440000';
  const agent = await (await fetch(`https://api.voicy.co/functions/v1/agent-get/${id}`, {
    headers: { 'Authorization': 'Bearer voicy_sk_live_xxx' },
  })).json();
  ```

  ```python Python theme={null}
  import requests
  agent_id = '550e8400-e29b-41d4-a716-446655440000'
  agent = requests.get(
      f'https://api.voicy.co/functions/v1/agent-get/{agent_id}',
      headers={'Authorization': 'Bearer voicy_sk_live_xxx'},
  ).json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "agent_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Appointment Booker",
    "language": "he",
    "voice": "Keren",
    "agent_type": "singlePrompt",
    "active": true,
    "prompt": "You are a friendly receptionist that books appointments.",
    "welcome_message": "שלום, איך אפשר לעזור?",
    "variables_provided": [
      { "name": "customer_name", "description": "The caller's name" }
    ],
    "variables_extracted": [
      { "name": "appointment_date", "description": "The date the caller chose" }
    ],
    "created_at": "2026-06-06T10:00:00Z",
    "updated_at": "2026-06-06T10:00:00Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Agent not found"
  }
  ```
</ResponseExample>