AI & Machine Learning Bearer Token

Vapi REST API

Voice AI API for conversational phone calls

Vapi provides a Voice AI platform that enables developers to build conversational AI phone agents. The API allows you to create, configure, and manage voice assistants that can handle inbound and outbound phone calls with natural language understanding, custom voices, and integrations with external services. Developers use Vapi to automate customer support, sales calls, appointment scheduling, and other voice-based interactions.

Base URL https://api.vapi.ai

API Endpoints

Method	Endpoint	Description
POST	`/assistant`	Create a new voice assistant with custom configuration, voice settings, and conversation flow
GET	`/assistant`	List all voice assistants in your account with pagination support
GET	`/assistant/{id}`	Retrieve detailed configuration and settings for a specific assistant
PATCH	`/assistant/{id}`	Update an existing assistant's configuration, prompts, or voice settings
DELETE	`/assistant/{id}`	Delete a voice assistant and remove all associated data
POST	`/call/phone`	Initiate an outbound phone call using a configured voice assistant
GET	`/call`	Retrieve a list of all calls with filtering and pagination options
GET	`/call/{id}`	Get detailed information about a specific call including transcript and metadata
POST	`/phone-number`	Purchase or import a phone number for inbound call handling
GET	`/phone-number`	List all phone numbers associated with your account
PATCH	`/phone-number/{id}`	Update phone number configuration and assign it to an assistant
DELETE	`/phone-number/{id}`	Release or delete a phone number from your account
GET	`/analytics/calls`	Retrieve analytics and metrics for call performance and usage
POST	`/webhook`	Configure webhook endpoints for real-time call events and notifications
GET	`/transcript/{callId}`	Retrieve the full conversation transcript for a completed call

Code Examples

curl -X POST https://api.vapi.ai/call/phone \
  -H 'Authorization: Bearer vapi_abc123xyz456' \
  -H 'Content-Type: application/json' \
  -d '{
    "assistantId": "asst_123456",
    "customer": {
      "number": "+14155551234"
    }
  }'

const response = await fetch('https://api.vapi.ai/call/phone', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer vapi_abc123xyz456',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    assistantId: 'asst_123456',
    customer: {
      number: '+14155551234'
    }
  })
});

const call = await response.json();
console.log('Call initiated:', call.id);

import requests

url = 'https://api.vapi.ai/call/phone'
headers = {
    'Authorization': 'Bearer vapi_abc123xyz456',
    'Content-Type': 'application/json'
}
data = {
    'assistantId': 'asst_123456',
    'customer': {
        'number': '+14155551234'
    }
}

response = requests.post(url, json=data, headers=headers)
call = response.json()
print(f"Call initiated: {call['id']}")

Use Vapi from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for Vapi. Paste your Vapi API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls Vapi directly with your credentials — no local install, works on mobile.

create_voice_assistant Create and configure a new AI voice assistant with custom prompts, voice settings, and conversation flows

initiate_outbound_call Start an outbound phone call using a specified voice assistant to a customer phone number

get_call_transcript Retrieve the full conversation transcript and metadata from a completed voice call

analyze_call_metrics Fetch analytics and performance metrics for calls including duration, sentiment, and outcomes

manage_phone_numbers List, purchase, configure, or release phone numbers for inbound call handling

Connect in 60 seconds

Paste your Vapi key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect Vapi to your AI →

Vapi REST API

API Endpoints

Sponsor this page

Code Examples

Use Vapi from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs