> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.next-dev.rtcleague.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.next-dev.rtcleague.com/_mcp/server.

# Quickstart

This guide walks you from "I have an account" to "I just placed an outbound
phone call programmatically."

## 1. Get an API key

Follow [Authentication](/getting-started/authentication) to create a key in your dashboard.
Have it ready as `$TELECHO_API_KEY`.

```bash
export TELECHO_API_KEY=tel_live_xxxxxxxxxxxxxxxxxxxxxxxx
```

## 2. List your agents

```bash
curl https://api.telecho.io/api/v1/public/agents \
  -H "Authorization: Bearer $TELECHO_API_KEY"
```

You'll get back a paginated list of agents in your org. Note one of the `id`
values — it looks like `tel_agt_a3f9b22e1c4d`.

## 3. List your phone numbers

```bash
curl https://api.telecho.io/api/v1/public/phone-numbers \
  -H "Authorization: Bearer $TELECHO_API_KEY"
```

Find a phone number with `status: "active"` and grab its `id` — looks like
`tel_pn_b8e44d12`.

## 4. Place an outbound call

```bash
curl https://api.telecho.io/api/v1/public/calls/outbound \
  -X POST \
  -H "Authorization: Bearer $TELECHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_id": "tel_pn_b8e44d12",
    "destination_number": "+14155021922",
    "agent_id": "tel_agt_a3f9b22e1c4d"
  }'
```

The destination phone will ring, your agent will join the call when the line is
answered, and you'll receive a response like:

```json
{
  "call_id": "tel_call_19a8c4d3e2f1",
  "room_name": "call-a3f9b22e1c4d",
  "status": "initiated",
  "phone_number": "+12345401155",
  "destination_number": "+14155021922"
}
```

## 5. Read the call afterwards

Once the call ends, it shows up in `/calls`:

```bash
curl "https://api.telecho.io/api/v1/public/calls?limit=5" \
  -H "Authorization: Bearer $TELECHO_API_KEY"
```

The response includes `duration_seconds`, `cost`, and `recording_url`.

## Next steps

* Read the [API Reference](/api-reference) for the full list of endpoints and parameters.
* Set up [error handling](/getting-started/errors) for production code.
* Understand [rate limits](/getting-started/rate-limits) before going live.