Developer Documentation

Build with the JagCall API

Everything you need to integrate AI voice agents, phone numbers, calls, and SMS into your applications. RESTful endpoints, real-time webhooks, and OAuth support.

Authentication

JagCall supports two authentication methods depending on your use case.

API Keys

Best for server-to-server integrations. Create keys in Settings → API Keys. Keys use the prefix jc_live_ for production and jc_test_ for sandbox.

Pass the key as a Bearer token in the Authorization header.

OAuth 2.0

Best for third-party apps acting on behalf of a JagCall user. Implements the standard authorization code flow with refresh tokens.

Access tokens use the prefix jca_. See the OAuth guide for details.

Example Request

curl
curl -X GET https://jagcall.com/v1/agents \
  -H "Authorization: Bearer jc_live_abc123..." \
  -H "Content-Type: application/json"

Example Response

json
{
  "data": [
    {
      "id": "agt_9x8Kp2mN",
      "name": "Sales Agent",
      "status": "active",
      "phone_number": "+14155551234",
      "created_at": "2025-11-01T08:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 3
  }
}

Base URL

https://jagcall.com/v1/

All API endpoints are relative to this base URL. All requests must use HTTPS.