---
title: "Get agent by ID"
method: GET
path: "/v1/agents/{agent_id}"
tags: ["Agents", "Agents"]
---

# Get agent by ID

`GET /v1/agents/{agent_id}`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/agents/{agent_id}`
- Auth: HTTP bearer

Retrieve a single agent's full configuration: prompts, voice, model, language, knowledge base bindings, function definitions, post-call actions and assigned phone numbers. With an ephemeral end-user token, returns only the trimmed public card; hidden agents return 404.

## Path parameters

- `agent_id` string, required

## Response `200`

The full agent configuration (trimmed public card for ephemeral tokens).

- unknown

## Other responses

- `404`: Agent not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/call2me/apis/call2me-api.md) · [All operations](https://skmtc.dev/call2me/apis/call2me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call2me/apis/call2me-api/revisions/3951f9b7e47d?raw)