---
title: "Retrieve an AI voice agent"
method: GET
path: "/test_framework/v2/aiagents/{id}/"
tags: ["test_framework"]
---

# Retrieve an AI voice agent

`GET /test_framework/v2/aiagents/{id}/`

Retrieve an AI voice agent, including its configured connections.

**Configured connection → run endpoint** (call this before running scenarios; a run endpoint only works if its connection is configured on the agent):
- `telephony.phone_number` → `scenarios-run-voice`
- `telephony.sip_uri` → `scenarios-run-sip`
- `telephony.websocket_url` → `scenarios-run-chirp` (raw-PCM voice websocket)
- `provider.type` vapi / retell / livekit / pipecat / agora (WebRTC) → `scenarios-run-vapi-webrtc` / `-retell-webrtc` / `-livekit-v2` / `-pipecat-v2` / `-agora`
- `provider.type` elevenlabs → `scenarios-run-elevenlabs`
- `provider.chat_agent_details` (chat/SMS/WhatsApp) → `scenarios-run-text`

## Path parameters

- `id` integer, required

## Response `200`

- AIAgentV2
  - `id` integer — Agent ID. Example: `2142`
  - `name` string — Agent name. Optional when configure_from_provider is set — it's fetched from the provider.
  - `description` string — A detailed description of what this agent does and how it should interact Example:

## Other responses

- `404`

---

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