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

# API Reference

> Explore the AgentPhone API with interactive examples and SDK snippets.

## Introduction

AgentPhone provides a REST API for provisioning phone numbers, managing AI agents, sending SMS, and placing voice calls. Most endpoints return JSON and require bearer authentication. Transcript streaming returns SSE. `GET /v1/calls/{call_id}/recording` returns binary recording audio and acts as a bearer link; see [recording downloads](/docs/documentation/guides/calls#call-recording). See [Authentication](/docs/authentication).

## Base URL

```
https://api.agentphone.ai
```

Append the complete path shown in each endpoint, such as `/v1/numbers` or `/integrations/whatsapp/status`. SDK base URLs use the origin above, without an extra `/v1`.

## Available SDKs

#### [TypeScript / JavaScript](https://www.npmjs.com/package/agentphone)

Install with npm install agentphone — works in Node.js 18+, Deno, Bun, and Cloudflare Workers.

#### [Python](https://pypi.org/project/agentphone/)

Install with pip install agentphone — supports both sync and async clients, Python 3.9+.

## Contribute

We welcome contributions to our SDKs. If you have suggestions or improvements, feel free to open a pull request on [GitHub](https://github.com/AgentPhone-AI).

If there are other languages you'd like us to support, let us know!