> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.agentphone.ai/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.agentphone.ai/_mcp/server. # API Reference ## API Docs - API Reference > agents [List Voices](https://docs.agentphone.ai/api-reference/agents/list-voices-v-1-agents-voices-get.md) - API Reference > agents [List Agents](https://docs.agentphone.ai/api-reference/agents/list-agents-v-1-agents-get.md) - API Reference > agents [Create Agent](https://docs.agentphone.ai/api-reference/agents/create-agent-v-1-agents-post.md) - API Reference > agents [Get Agent](https://docs.agentphone.ai/api-reference/agents/get-agent-v-1-agents-agent-id-get.md) - API Reference > agents [Delete Agent](https://docs.agentphone.ai/api-reference/agents/delete-agent-v-1-agents-agent-id-delete.md) - API Reference > agents [Update Agent](https://docs.agentphone.ai/api-reference/agents/update-agent-v-1-agents-agent-id-patch.md) - API Reference > agents [Attach Number To Agent](https://docs.agentphone.ai/api-reference/agents/attach-number-to-agent-v-1-agents-agent-id-numbers-post.md) - API Reference > agents [Detach Number From Agent](https://docs.agentphone.ai/api-reference/agents/detach-number-from-agent-v-1-agents-agent-id-numbers-number-id-delete.md) - API Reference > agents [List Agent Conversations](https://docs.agentphone.ai/api-reference/agents/list-agent-conversations-v-1-agents-agent-id-conversations-get.md) - API Reference > agents [List Agent Calls](https://docs.agentphone.ai/api-reference/agents/list-agent-calls-v-1-agents-agent-id-calls-get.md) - API Reference > numbers [List Numbers](https://docs.agentphone.ai/api-reference/numbers/list-numbers-v-1-numbers-get.md) - API Reference > numbers [Create Number](https://docs.agentphone.ai/api-reference/numbers/create-number-v-1-numbers-post.md) - API Reference > numbers [List Available Numbers](https://docs.agentphone.ai/api-reference/numbers/list-available-numbers-v-1-numbers-available-get.md) - API Reference > numbers [Lookup Numbers](https://docs.agentphone.ai/api-reference/numbers/lookup-numbers-v-1-numbers-lookup-get.md) - API Reference > numbers [Get Number](https://docs.agentphone.ai/api-reference/numbers/get-number-v-1-numbers-number-id-get.md) - API Reference > numbers [Delete Number](https://docs.agentphone.ai/api-reference/numbers/delete-number-v-1-numbers-number-id-delete.md) - API Reference > numbers [Update Number](https://docs.agentphone.ai/api-reference/numbers/update-number-v-1-numbers-number-id-patch.md) - API Reference > numbers [Get Messages](https://docs.agentphone.ai/api-reference/numbers/get-messages-v-1-numbers-number-id-messages-get.md) - API Reference > webhooks [Get Webhook](https://docs.agentphone.ai/api-reference/webhooks/get-webhook-v-1-webhooks-get.md) - API Reference > webhooks [Create Or Update Webhook](https://docs.agentphone.ai/api-reference/webhooks/create-or-update-webhook-v-1-webhooks-post.md) - API Reference > webhooks [Delete Webhook](https://docs.agentphone.ai/api-reference/webhooks/delete-webhook-v-1-webhooks-delete.md) - API Reference > webhooks [List Deliveries](https://docs.agentphone.ai/api-reference/webhooks/list-deliveries-v-1-webhooks-deliveries-get.md) - API Reference > webhooks [Delivery Stats](https://docs.agentphone.ai/api-reference/webhooks/delivery-stats-v-1-webhooks-deliveries-stats-get.md) - API Reference > webhooks [All Time Stats](https://docs.agentphone.ai/api-reference/webhooks/all-time-stats-v-1-webhooks-deliveries-all-time-get.md) - API Reference > webhooks [Test Webhook](https://docs.agentphone.ai/api-reference/webhooks/test-webhook-v-1-webhooks-test-post.md) - API Reference > agent-webhooks [Get Agent Webhook](https://docs.agentphone.ai/api-reference/agent-webhooks/get-agent-webhook-v-1-agents-agent-id-webhook-get.md) - API Reference > agent-webhooks [Create Or Update Agent Webhook](https://docs.agentphone.ai/api-reference/agent-webhooks/create-or-update-agent-webhook-v-1-agents-agent-id-webhook-post.md) - API Reference > agent-webhooks [Delete Agent Webhook](https://docs.agentphone.ai/api-reference/agent-webhooks/delete-agent-webhook-v-1-agents-agent-id-webhook-delete.md) - API Reference > agent-webhooks [List Agent Deliveries](https://docs.agentphone.ai/api-reference/agent-webhooks/list-agent-deliveries-v-1-agents-agent-id-webhook-deliveries-get.md) - API Reference > agent-webhooks [Test Agent Webhook](https://docs.agentphone.ai/api-reference/agent-webhooks/test-agent-webhook-v-1-agents-agent-id-webhook-test-post.md) - API Reference > contacts [List Contacts](https://docs.agentphone.ai/api-reference/contacts/list-contacts-v-1-contacts-get.md) - API Reference > contacts [Create Contact](https://docs.agentphone.ai/api-reference/contacts/create-contact-v-1-contacts-post.md) - API Reference > contacts [Get Contact Capabilities](https://docs.agentphone.ai/api-reference/contacts/get-contact-capabilities-v-1-contacts-capabilities-get.md) - API Reference > contacts [Get Contact](https://docs.agentphone.ai/api-reference/contacts/get-contact-v-1-contacts-contact-id-get.md) - API Reference > contacts [Delete Contact](https://docs.agentphone.ai/api-reference/contacts/delete-contact-v-1-contacts-contact-id-delete.md) - API Reference > contacts [Update Contact](https://docs.agentphone.ai/api-reference/contacts/update-contact-v-1-contacts-contact-id-patch.md) - API Reference > conversations [List Conversations](https://docs.agentphone.ai/api-reference/conversations/list-conversations-v-1-conversations-get.md) - API Reference > conversations [Get Conversation](https://docs.agentphone.ai/api-reference/conversations/get-conversation-v-1-conversations-conversation-id-get.md) - API Reference > conversations [Update Conversation](https://docs.agentphone.ai/api-reference/conversations/update-conversation-v-1-conversations-conversation-id-patch.md) - API Reference > conversations [Get Conversation Messages](https://docs.agentphone.ai/api-reference/conversations/get-conversation-messages-v-1-conversations-conversation-id-messages-get.md) - API Reference > conversations [Send Typing Indicator](https://docs.agentphone.ai/api-reference/conversations/send-typing-indicator-v-1-conversations-conversation-id-typing-post.md) - API Reference > conversations [Set Chat Background](https://docs.agentphone.ai/api-reference/conversations/set-chat-background-v-1-conversations-conversation-id-background-post.md) - API Reference > conversations [Remove Chat Background](https://docs.agentphone.ai/api-reference/conversations/remove-chat-background-v-1-conversations-conversation-id-background-delete.md) - API Reference > calls [List Calls](https://docs.agentphone.ai/api-reference/calls/list-calls-v-1-calls-get.md) - API Reference > calls [Create Outbound Call](https://docs.agentphone.ai/api-reference/calls/create-outbound-call-v-1-calls-post.md) - API Reference > calls [Create Web Call](https://docs.agentphone.ai/api-reference/calls/create-web-call-v-1-calls-web-post.md) - API Reference > calls [Get Call](https://docs.agentphone.ai/api-reference/calls/get-call-v-1-calls-call-id-get.md) - API Reference > calls [End Call](https://docs.agentphone.ai/api-reference/calls/end-call-v-1-calls-call-id-end-post.md) - API Reference > calls [Get Call Recording](https://docs.agentphone.ai/api-reference/calls/get-call-recording-v-1-calls-call-id-recording-get.md) - API Reference > calls [Get Call Transcript](https://docs.agentphone.ai/api-reference/calls/get-call-transcript-v-1-calls-call-id-transcript-get.md) - API Reference > calls [Stream Call Transcript](https://docs.agentphone.ai/api-reference/calls/stream-call-transcript-v-1-calls-call-id-transcript-stream-get.md) - API Reference > calls [List Calls For Number](https://docs.agentphone.ai/api-reference/calls/list-calls-for-number-v-1-numbers-number-id-calls-get.md) - API Reference > usage [Get Usage](https://docs.agentphone.ai/api-reference/usage/get-usage-v-1-usage-get.md) - API Reference > usage [Get Daily Usage](https://docs.agentphone.ai/api-reference/usage/get-daily-usage-v-1-usage-daily-get.md) - API Reference > usage [Get Monthly Usage](https://docs.agentphone.ai/api-reference/usage/get-monthly-usage-v-1-usage-monthly-get.md) - API Reference > usage [Get Usage By Number](https://docs.agentphone.ai/api-reference/usage/get-usage-by-number-v-1-usage-by-number-get.md) - API Reference > usage [Get Usage By Agent](https://docs.agentphone.ai/api-reference/usage/get-usage-by-agent-v-1-usage-by-agent-get.md) - API Reference > messages [Send Message](https://docs.agentphone.ai/api-reference/messages/send-message-v-1-messages-post.md) - API Reference > messages [Send Reaction](https://docs.agentphone.ai/api-reference/messages/send-reaction-v-1-messages-message-id-reactions-post.md) - API Reference > verification [Send Verification](https://docs.agentphone.ai/api-reference/verification/send-verification-v-1-verify-send-post.md) - API Reference > verification [Check Verification](https://docs.agentphone.ai/api-reference/verification/check-verification-v-1-verify-check-post.md) - API Reference > contact cards [Get Contact Card](https://docs.agentphone.ai/api-reference/contact-cards/get-contact-card-v-1-numbers-number-id-contact-card-get.md) - API Reference > contact cards [Put Contact Card](https://docs.agentphone.ai/api-reference/contact-cards/put-contact-card-v-1-numbers-number-id-contact-card-put.md) - API Reference > contact cards [Delete Contact Card](https://docs.agentphone.ai/api-reference/contact-cards/delete-contact-card-v-1-numbers-number-id-contact-card-delete.md) - API Reference > sub-accounts [List Sub Accounts](https://docs.agentphone.ai/api-reference/sub-accounts/list-sub-accounts-v-1-sub-accounts-get.md) - API Reference > sub-accounts [Create Sub Account](https://docs.agentphone.ai/api-reference/sub-accounts/create-sub-account-v-1-sub-accounts-post.md) - API Reference > sub-accounts [Delete Sub Account](https://docs.agentphone.ai/api-reference/sub-accounts/delete-sub-account-v-1-sub-accounts-sub-account-id-delete.md) - API Reference > sub-accounts [Update Sub Account](https://docs.agentphone.ai/api-reference/sub-accounts/update-sub-account-v-1-sub-accounts-sub-account-id-patch.md) - API Reference > sip-trunks [List Sip Trunks](https://docs.agentphone.ai/api-reference/sip-trunks/list-sip-trunks-v-1-sip-trunks-get.md) - API Reference > sip-trunks [Create Sip Trunk](https://docs.agentphone.ai/api-reference/sip-trunks/create-sip-trunk-v-1-sip-trunks-post.md) - API Reference > sip-trunks [Get Sip Trunk](https://docs.agentphone.ai/api-reference/sip-trunks/get-sip-trunk-v-1-sip-trunks-trunk-id-get.md) - API Reference > sip-trunks [Delete Sip Trunk](https://docs.agentphone.ai/api-reference/sip-trunks/delete-sip-trunk-v-1-sip-trunks-trunk-id-delete.md) - API Reference > sip-trunks [Update Sip Trunk](https://docs.agentphone.ai/api-reference/sip-trunks/update-sip-trunk-v-1-sip-trunks-trunk-id-patch.md) - API Reference > whatsapp [Whatsapp Connect](https://docs.agentphone.ai/api-reference/whatsapp/connect-integrations-whatsapp-connect-post.md) - API Reference > whatsapp [Whatsapp Available Numbers](https://docs.agentphone.ai/api-reference/whatsapp/available-numbers-integrations-whatsapp-connection-id-available-numbers-get.md) - API Reference > whatsapp [Whatsapp Connect Number](https://docs.agentphone.ai/api-reference/whatsapp/connect-number-integrations-whatsapp-connection-id-numbers-post.md) - API Reference > whatsapp [Whatsapp List Templates](https://docs.agentphone.ai/api-reference/whatsapp/list-templates-integrations-whatsapp-connection-id-templates-get.md) - API Reference > whatsapp [Whatsapp Create Template](https://docs.agentphone.ai/api-reference/whatsapp/create-template-integrations-whatsapp-connection-id-templates-post.md) - API Reference > whatsapp [Whatsapp Delete Template](https://docs.agentphone.ai/api-reference/whatsapp/delete-template-integrations-whatsapp-connection-id-templates-delete.md) - API Reference > whatsapp [Whatsapp Status](https://docs.agentphone.ai/api-reference/whatsapp/status-integrations-whatsapp-status-get.md) - API Reference > whatsapp [Whatsapp Disconnect](https://docs.agentphone.ai/api-reference/whatsapp/disconnect-integrations-whatsapp-connection-id-delete.md) - API Reference > registration [Get Registration Status](https://docs.agentphone.ai/api-reference/registration/get-registration-status-v-1-register-status-get.md) - API Reference > registration [Get Registration Details](https://docs.agentphone.ai/api-reference/registration/get-registration-details-v-1-register-get.md) - API Reference > registration [Register A2P](https://docs.agentphone.ai/api-reference/registration/register-a-2-p-v-1-register-post.md) - API Reference > registration [Update A2P Registration](https://docs.agentphone.ai/api-reference/registration/update-a-2-p-registration-v-1-register-patch.md) - API Reference > feedback [Submit agent feedback](https://docs.agentphone.ai/api-reference/feedback/submit-feedback-v-1-feedback-post.md) - API Reference > location [Get Location](https://docs.agentphone.ai/api-reference/location/get-location-v-1-location-phone-number-get.md) - API Reference > location [Refresh Locations](https://docs.agentphone.ai/api-reference/location/refresh-locations-v-1-location-refresh-post.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.agentphone.ai/api-reference/openapi.json) - [OpenAPI YAML](https://docs.agentphone.ai/api-reference/openapi.yaml) > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.agentphone.ai/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.agentphone.ai/_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. All endpoints return JSON and require Bearer token authentication. ## Base URL ``` https://api.agentphone.ai/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!