---
title: "Get Agent"
method: GET
path: "/agents/{agent_id}"
tags: ["Agents"]
---

# Get Agent

`GET /agents/{agent_id}`

Returns the details of a specific agent

## Path parameters

- `agent_id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- AgentSummary — A summary of essential information about an agent.
  - `id` string, required — The ID of the agent.
  - `name` string, required — The unique name of the agent, which can be used to identify the agent in the CLI.
  - `description` string, nullable — A brief description of the agent.
  - `created_at` string, date-time, required — The date and time when the agent was created.
  - `updated_at` string, date-time, required — The date and time when the agent was last updated.
  - `tts_voice` string, required — The ID of the voice. Find one in the [Voice Library](https://play.cartesia.ai/voices) or via [List Voices](/api-reference/voices/list).
  - `tts_language` string, required — The language used for text-to-speech by the agent.
  - `noise_suppression_level` integer, required — The level of noise suppression applied to the caller's audio, from 0 (off) to 100 (maximum).
  - `webhook_id` string, nullable — The identifier for the webhook associated with the agent. Add or customize a webhook to your agent to receive events when calls are made to your agent via the Playground.
  - `deleted_at` string, date-time, nullable — The date and time when the agent was deleted, if applicable.
  - `git_repository` GitRepository
    - `provider` string, required — The provider of the Git repository.
    - `account` string, required — The account name associated with the Git repository.
    - `name` string, required — The name of the Git repository.
  - `git_deploy_branch` string, nullable — The branch of the Git repository used for deployment.
  - `phone_numbers` PhoneNumberSummary[], nullable — The phone numbers associated with the agent. Currently, you can only have one phone number per agent.
    - `id` string, required — The ID of the phone number.
    - `number` string, required — The phone number with country code included.
  - `has_text_to_agent_run` boolean, required — Whether the agent has a text-to-agent run.
  - `deployment_count` integer, required — The number of deployments associated with the agent.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/versions/8910812440d3/schema)