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

# Get agent

> Retrieve detailed Voice AI agent information, including configuration, status, and tasks.

Retrieve complete operational metadata, runtime parameters, voice configuration, task definitions, and current status for an existing agent by its unique identifier.

***

### Authentication

This endpoint requires Bearer token authentication.

```http theme={null}
Authorization: Bearer <token>
```

| Header          | Type     | Required | Description                                     | Format           |
| :-------------- | :------- | :------- | :---------------------------------------------- | :--------------- |
| `Authorization` | `string` | **Yes**  | Scoped organization API key or Bearer JWT token | `Bearer <token>` |

***

### Input parameters

The following parameters are required to call this endpoint.

<ParamField path="agent_id" type="string" required>
  Unique identifier of the agent. Example: `agent_12345` or UUID `550e8400-e29b-41d4-a716-446655440000`.
</ParamField>

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication. Format: `Bearer <token>`.
</ParamField>

***

### Response Fields

<ResponseField name="id" type="string">
  Unique identifier of the agent.
</ResponseField>

<ResponseField name="name" type="string">
  Display name assigned to the voice agent.
</ResponseField>

<ResponseField name="status" type="string">
  Operational state of the agent (`active`, `inactive`, `training`).
</ResponseField>

<ResponseField name="description" type="string">
  Detailed explanation of the agent's persona and conversational role.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the agent was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp when the agent configuration was last modified.
</ResponseField>

<ResponseField name="configuration" type="object">
  Runtime settings governing conversational synthesis:

  <Expandable title="configuration fields">
    <ResponseField name="language" type="string">
      BCP-47 language tag (e.g. `en-US`, `es-ES`).
    </ResponseField>

    <ResponseField name="voice" type="string">
      Voice identifier or Cartesia/ElevenLabs voice persona.
    </ResponseField>

    <ResponseField name="model" type="string">
      Underlying LLM model powering responses (e.g. `gpt-4o-mini`, `claude-3-5-sonnet`).
    </ResponseField>

    <ResponseField name="temperature" type="number">
      Sampling temperature between `0.0` and `1.0`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="tasks" type="string[]">
  List of capability tasks and functions assigned to this agent (e.g. `qualify_leads`, `book_meeting`, `send_followup_email`).
</ResponseField>

***

<RequestExample>
  ```python Python theme={null}
  import requests

  url = "https://api.sayvy.ai/api/v1/agents/agent_12345"

  headers = {
      "Authorization": "Bearer <token>"
  }

  response = requests.get(url, headers=headers)

  print(response.status_code)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.sayvy.ai/api/v1/agents/agent_12345",
    {
      method: "GET",
      headers: {
        "Authorization": "Bearer <token>"
      }
    }
  );

  const data = await response.json();
  console.log(data);
  ```

  ```java Java theme={null}
  HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://api.sayvy.ai/api/v1/agents/agent_12345"))
      .header("Authorization", "Bearer <token>")
      .GET()
      .build();

  HttpResponse<String> response =
      HttpClient.newHttpClient()
          .send(request, HttpResponse.BodyHandlers.ofString());

  System.out.println(response.body());
  ```

  ```bash cURL theme={null}
  curl -X GET \
    "https://api.sayvy.ai/api/v1/agents/agent_12345" \
    -H "Authorization: Bearer <token>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "agent_12345",
    "name": "Sales Assistant",
    "status": "active",
    "description": "Handles inbound sales calls",
    "created_at": "2024-05-20T10:15:30Z",
    "updated_at": "2024-05-22T14:22:10Z",
    "configuration": {
      "language": "en-US",
      "voice": "alloy",
      "model": "gpt-4o-mini",
      "temperature": 0.3
    },
    "tasks": [
      "qualify_leads",
      "book_meeting",
      "send_followup_email"
    ]
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "error": 123,
    "message": "Invalid or missing agent_id"
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "error": 401,
    "message": "Unauthorized"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": 404,
    "message": "Agent not found"
  }
  ```

  ```json 500 Internal Server Error theme={null}
  {
    "error": 500,
    "message": "Internal server error"
  }
  ```
</ResponseExample>

***

<div
  style={{
display: "flex",
alignItems: "center",
justifyContent: "space-between",
backgroundColor: "rgba(255, 255, 255, 0.03)",
border: "1px solid rgba(255, 255, 255, 0.08)",
borderRadius: "16px",
padding: "10px 18px",
marginTop: "40px",
gap: "16px",
flexWrap: "wrap"
}}
>
  <a
    href="/api-reference/agents/overview"
    style={{
display: "inline-flex",
alignItems: "center",
gap: "6px",
color: "#94A3B8",
textDecoration: "none",
fontSize: "14px",
fontWeight: "500",
padding: "4px 8px"
}}
  >
    <span style={{ fontSize: "16px" }}>‹</span> Previous
  </a>

  <div
    style={{
display: "flex",
alignItems: "center",
gap: "16px",
backgroundColor: "rgba(255, 255, 255, 0.04)",
border: "1px solid rgba(255, 255, 255, 0.06)",
borderRadius: "12px",
padding: "8px 16px",
marginLeft: "auto"
}}
  >
    <div style={{ textAlign: "right" }}>
      <div style={{ fontSize: "13px", fontWeight: "700", color: "#F8FAFC" }}>Create agent</div>

      <div style={{ fontSize: "11px", color: "#94A3B8", maxWidth: "260px", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }}>
        Provision a new conversational Voice AI prompt agent
      </div>
    </div>

    <div style={{ width: "1px", height: "24px", backgroundColor: "rgba(255, 255, 255, 0.1)" }} />

    <a
      href="/api-reference/agents/create-agent"
      style={{
  display: "inline-flex",
  alignItems: "center",
  gap: "6px",
  color: "#94A3B8",
  textDecoration: "none",
  fontSize: "14px",
  fontWeight: "500"
}}
    >
      Next <span style={{ fontSize: "16px" }}>›</span>
    </a>
  </div>
</div>