API Reference
Developer-friendly API
Build powerful voice AI integrations with our RESTful API. Manage agents, handle calls, and access analytics programmatically with clean, well-documented endpoints.
Quick Start
Make your first API call
Get up and running in seconds. Grab your API key from the dashboard and try this command to list your agents.
curl -X GET https://api.jagcall.com/v1/agents \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"Replace YOUR_API_KEY with your actual API key from the dashboard settings.
Capabilities
Built for developers
Everything you need to integrate voice AI into your application.
REST API
Clean, intuitive endpoints for managing agents, calls, phone numbers, SMS, and analytics. JSON request and response format throughout.
Webhooks
Real-time event notifications for call started, call ended, SMS received, appointment booked, and more. Configure per-agent or globally.
SDKs
Official client libraries for Python and Node.js with full TypeScript support. Install via pip or npm and start building in minutes.
Rate Limiting
Generous rate limits of 1,000 requests per minute on all plans. Burst-friendly with automatic retry headers for seamless integration.
Authentication
All API requests require a Bearer token in the Authorization header. Generate API keys from your dashboard with granular permission scopes.
- Bearer token authentication on every request
- Scoped permissions: read, write, admin
- Rotate keys instantly from the dashboard
- Separate keys for production and development
Authorization: Bearer jc_live_abc123...Example
Create an agent via API
Deploy a fully configured voice agent with a single API call. Set the voice, greeting, instructions, tools, and phone number all at once.
curl -X POST https://api.jagcall.com/v1/agents \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Reception Agent", "voice": "alloy", "greeting": "Hello! Thanks for calling. How can I help you today?", "instructions": "You are a friendly receptionist. Book appointments, answer FAQs, and transfer complex requests to a human agent.", "model": "gpt-4o", "tools": ["book_appointment", "transfer_call"], "phone_number": "+15551234567" }'API Key Management
Create, rotate, and revoke API keys from your dashboard. Set expiration dates and monitor usage per key.
Base URL
All endpoints are available at https://api.jagcall.com/v1. HTTPS is required for all requests.
SDKs & Libraries
Install our official SDK: pip install jagcall or npm install @jagcall/sdk.
Start building with the JagCall API
Create your free account, generate an API key, and deploy your first voice agent in minutes. Full API access on every plan.