---
title: "Get Agent By Id"
method: GET
path: "/v1/agents/{agent_id}"
tags: ["[beta] A2A Agents"]
---

# Get Agent By Id

`GET /v1/agents/{agent_id}`

Get a specific agent by ID

Example Request:
```bash
curl -X GET "http://localhost:4000/v1/agents/123e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer <your_api_key>"
```

## Path parameters

- `agent_id` string, required

## Response `200`

Successful Response

- AgentResponse
  - `agent_id` string, required
  - `agent_name` string, required
  - `litellm_params` object, nullable
  - `agent_card_params` object, required
  - `object_permission` object, nullable
  - `spend` number, nullable
  - `tpm_limit` integer, nullable
  - `rpm_limit` integer, nullable
  - `session_tpm_limit` integer, nullable
  - `session_rpm_limit` integer, nullable
  - `static_headers` object, nullable
  - `extra_headers` string[], nullable
  - `keys` AgentKeySummary[], nullable
    - `token` string, required
    - `key_alias` string, nullable
    - `key_name` string, nullable
  - `search_score` number, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `created_by` string, nullable
  - `updated_by` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-21** `6246f8d427b7` — 2 info
  - api tag `[beta] A2A Agents` added
  - api tag `agents` removed
- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `agents` added
  - api tag `[beta] A2A Agents` removed
- **2026-09-18** `082b5fabd909` — 6 info
  - api tag `[beta] A2A Agents` added
  - api tag `agents` removed
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - …2 more
- **2026-09-15** `b408bdb637df` — 2 info
  - api tag `agents` added
  - api tag `[beta] A2A Agents` removed
- **2026-09-12** `0915d6a9ba99` — 2 info
  - api tag `[beta] A2A Agents` added
  - api tag `agents` removed

[Full history](https://skmtc.dev/flock/apis/litellm-api/changes/v1/agents/:agent_id/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/7ed45f30a5f0?raw)