CallPayMin V1 API — Complete Guide

curl -X POST https://api.callpaymin.io/api/v1/billing/users \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "user-123",
    "email": "alice@example.com",
    "displayName": "Alice Johnson",
    "initialBalance": 50.00
  }'

{
  "success": true,
  "data": {
    "id": "usr_abc123",
    "externalId": "user-123",
    "email": "alice@example.com",
    "displayName": "Alice Johnson",
    "balance": { "available": 50.00, "pending": 0, "currency": "USD" },
    "status": "active"
  }
}

curl -X POST https://api.callpaymin.io/api/v1/experts \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "expert-456",
    "email": "dr.smith@example.com",
    "profile": {
      "firstName": "David",
      "lastName": "Smith",
      "country": "US"
    },
    "rates": { "perMinute": 5.00 }
  }'

curl -X POST https://api.callpaymin.io/api/v1/calls \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      { "externalId": "user-123", "displayName": "Alice Johnson", "role": "client" },
      { "externalId": "expert-456", "displayName": "Dr. Smith", "role": "expert" }
    ],
    "billing": {
      "payerId": "user-123",
      "ratePerMinute": 5.00
    },
    "config": { "video": true, "audio": true }
  }'

curl -X POST https://api.callpaymin.io/api/v1/calls/call_abc123/end \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "completed" }'

{
  "success": true,
  "data": {
    "id": "call_abc123",
    "status": "ended",
    "duration": { "totalSeconds": 312, "billableSeconds": 312, "billableMinutes": 6 },
    "cost": {
      "total": 30.00,
      "breakdown": {
        "callMinutes": 30.00,
        "platformFee": 1.05,
        "expertEarnings": 23.16,
        "businessShare": 5.79
      }
    }
  }
}

Authorization: Bearer cpm_live_YOUR_KEY

X-API-Key: cpm_live_YOUR_KEY

{
  "ipAllowlist": ["203.0.113.0/24", "198.51.100.42"]
}

Your Customer → Pays You → You call POST /billing/users/{id}/add-funds → Balance updated

Your Customer → Card on file → CallPayMin auto-charges → Balance updated
                                                       → Expert auto-paid via Stripe Connect

$100.00  Gross charge
  ├── $80.00  Expert share (80%)     → You pay the expert
  └── $20.00  Business share (20%)   → Your revenue

$100.00  Gross charge
  ├── Stripe processing fee:    -$3.20  (2.9% + $0.30)
  ├── Platform fee:             -$3.50  (3.5%, min $0.50)
  ├── Net for split:            $93.30
  │     ├── Expert (80%):       $74.64
  │     │     ├── Payout fee:   -$0.75  (1%, min $0.25)
  │     │     └── Expert gets:  $73.45
  │     └── Business (20%):     $18.66
  │           ├── Payout fee:   -$0.25  (1%, min $0.25)
  │           └── Business gets: $18.41
  └── CallPayMin profit:        $4.50

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1708108800

{
  "error": "RATE_LIMITED",
  "message": "Rate limit exceeded. Try again in 45 seconds.",
  "limit": 60,
  "remaining": 0,
  "resetAt": 1708108800
}

{
  "success": true,
  "data": { ... }
}

{
  "error": "ERROR_CODE",
  "message": "Human-readable description"
}

curl https://api.callpaymin.io/api/v1/health

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-02-16T12:00:00.000Z"
}

curl https://api.callpaymin.io/api/v1/status

{
  "status": "operational",
  "version": "1.0.0",
  "timestamp": "2026-02-16T12:00:00.000Z",
  "responseTime": "45ms",
  "services": [
    { "name": "Firestore Database", "status": "operational", "latency": "12ms" },
    { "name": "WebRTC Signaling", "status": "operational", "latency": "8ms" },
    { "name": "TURN Server", "status": "operational", "latency": "15ms" },
    { "name": "AI Services", "status": "operational", "latency": "200ms" },
    { "name": "Stripe Payments", "status": "operational", "latency": "100ms" }
  ],
  "uptime": "99.99%"
}

curl https://api.callpaymin.io/api/v1/organization \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "id": "org_abc123",
    "name": "Acme Consulting",
    "email": "admin@acme.com",
    "plan": "professional",
    "paymentMode": "self_managed",
    "settings": {},
    "status": "active",
    "createdAt": "2026-01-15T10:00:00.000Z"
  }
}

curl -X PUT https://api.callpaymin.io/api/v1/organization \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Consulting Inc.",
    "settings": {
      "defaultCurrency": "USD",
      "timezone": "America/New_York"
    }
  }'

curl https://api.callpaymin.io/api/v1/organization/plans \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "paymentMode": "self_managed",
    "plans": [
      {
        "id": "free",
        "name": "Free",
        "price": "$0/month",
        "limits": { "callMinutes": 100, "chatMessages": 500, "aiSummaries": 10 },
        "features": ["calls", "chats", "rooms_eval", "jobs_eval"],
        "subscribable": false
      },
      {
        "id": "professional",
        "name": "Professional",
        "price": "$149/month",
        "limits": { "callMinutes": 2500, "chatMessages": 12000, "aiSummaries": 250 },
        "features": ["calls", "chats", "rooms", "jobs", "work_sessions"],
        "subscribable": true
      }
    ]
  }
}

curl https://api.callpaymin.io/api/v1/organization/usage \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "plan": "professional",
    "paymentMode": "self_managed",
    "billingPeriod": { "start": "2026-02-01", "end": "2026-02-28" },
    "usage": {
      "callMinutes": { "used": 450, "limit": 2500, "remaining": 2050, "percentUsed": 18 },
      "chatMessages": { "used": 1200, "limit": 12000, "remaining": 10800, "percentUsed": 10 },
      "aiSummaries": { "used": 25, "limit": 250, "remaining": 225, "percentUsed": 10 }
    }
  }
}

# Past invoices
curl "https://api.callpaymin.io/api/v1/organization/invoices?limit=10" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"
​
# Upcoming invoice
curl "https://api.callpaymin.io/api/v1/organization/invoices?upcoming=true" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/organization/subscription \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/organization/subscription \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "planId": "professional" }'

curl -X DELETE https://api.callpaymin.io/api/v1/organization/subscription \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "immediate": false }'

curl https://api.callpaymin.io/api/v1/organization/payment-methods \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/organization/payment-methods \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethodId": "pm_1234567890",
    "setAsDefault": true
  }'

curl -X DELETE https://api.callpaymin.io/api/v1/organization/payment-methods \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "paymentMethodId": "pm_1234567890" }'

curl -X POST https://api.callpaymin.io/api/v1/organization/setup-intent \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "clientSecret": "seti_xxx_secret_yyy"
  }
}

curl -X POST https://api.callpaymin.io/api/v1/organization/upload-logo \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageData": "data:image/png;base64,iVBORw0KGgo...",
    "fileName": "logo.png",
    "contentType": "image/png"
  }'

curl -X POST https://api.callpaymin.io/api/v1/organization/team/invite \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "teammate@example.com",
    "role": "admin"
  }'

curl https://api.callpaymin.io/api/v1/organization/team/invite \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X DELETE https://api.callpaymin.io/api/v1/organization/team/invite \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inviteId": "inv_abc123" }'

curl https://api.callpaymin.io/api/v1/organization/webhooks \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "endpoints": {
      "callStarted": "https://yourapp.com/webhooks/calls",
      "callEnded": "https://yourapp.com/webhooks/calls",
      "chatMessage": null,
      "balanceLow": "https://yourapp.com/webhooks/billing",
      "expertVerified": null
    },
    "secretPrefix": "whsec_EuPi...",
    "availableEvents": [
      { "type": "call.created", "description": "When a new call is created" },
      { "type": "call.started", "description": "When a call becomes active" },
      { "type": "call.ended", "description": "When a call ends with billing details" },
      { "type": "chat.message", "description": "When a chat message is sent" },
      { "type": "balance.low", "description": "When a user's balance drops below threshold" }
    ]
  }
}

curl -X PUT https://api.callpaymin.io/api/v1/organization/webhooks \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "callStarted": "https://yourapp.com/webhooks/calls",
    "callEnded": "https://yourapp.com/webhooks/calls",
    "chatMessage": "https://yourapp.com/webhooks/chats",
    "balanceLow": "https://yourapp.com/webhooks/billing",
    "expertVerified": "https://yourapp.com/webhooks/experts"
  }'

curl -X POST https://api.callpaymin.io/api/v1/organization/webhooks \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "message": "Webhook secret rotated",
    "secret": "whsec_newSecretHere...",
    "note": "Update your webhook verification code with the new secret"
  }
}

curl "https://api.callpaymin.io/api/v1/organization/webhook-deliveries?limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "stats": { "total": 150, "success": 145, "failed": 3, "pending": 2 },
    "deliveries": [
      {
        "id": "del_abc",
        "eventId": "evt_xyz",
        "url": "https://yourapp.com/webhooks/calls",
        "status": "success",
        "attempts": 1,
        "lastAttemptAt": "2026-02-16T12:00:00Z",
        "response": { "status": 200 },
        "createdAt": "2026-02-16T12:00:00Z"
      }
    ]
  }
}

curl -X POST https://api.callpaymin.io/api/v1/organization/stripe/onboarding-link \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{ "success": true, "data": { "url": "https://connect.stripe.com/setup/..." } }

curl -X POST https://api.callpaymin.io/api/v1/organization/stripe/dashboard-link \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/organization/stripe/sync-status \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "status": "verified",
    "account": {
      "id": "acct_xxx",
      "charges_enabled": true,
      "payouts_enabled": true,
      "details_submitted": true
    }
  }
}

curl -X POST https://api.callpaymin.io/api/v1/organization/stripe/balance \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/organization/stripe/switch-payment-mode \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "newMode": "managed" }'

curl https://api.callpaymin.io/api/v1/organization/stripe/debug-account \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/organization/stripe/activate-test \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/billing/users \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "user-123",
    "email": "alice@example.com",
    "displayName": "Alice Johnson",
    "phone": "+1234567890",
    "initialBalance": 50.00,
    "currency": "USD",
    "autoRecharge": {
      "enabled": true,
      "threshold": 5.00,
      "amount": 25.00,
      "webhookUrl": "https://yourapp.com/webhooks/recharge"
    },
    "metadata": {
      "plan": "premium",
      "internalUserId": "12345"
    }
  }'

{
  "success": true,
  "data": {
    "id": "usr_mlpylwjl7frvh3",
    "externalId": "user-123",
    "email": "alice@example.com",
    "displayName": "Alice Johnson",
    "balance": { "available": 50.00, "pending": 0, "currency": "USD" },
    "autoRecharge": { "enabled": true, "threshold": 5.00, "amount": 25.00 },
    "stats": { "totalDeposited": 50.00, "totalSpent": 0, "callCount": 0, "chatCount": 0 },
    "status": "active",
    "createdAt": "2026-02-16T12:00:00.000Z"
  }
}

curl "https://api.callpaymin.io/api/v1/billing/users?status=active&balanceBelow=10&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "data": [ { "id": "usr_abc", "externalId": "user-123", "balance": { "available": 50.00 }, ... } ],
    "hasMore": true,
    "cursor": "usr_xyz"
  }
}

curl https://api.callpaymin.io/api/v1/billing/users/usr_mlpylwjl7frvh3 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/billing/users/usr_abc123/add-funds \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25.00,
    "reference": "stripe_pi_xxx",
    "description": "Manual top-up"
  }'

curl -X POST https://api.callpaymin.io/api/v1/billing/users/usr_abc123/charge \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25.00,
    "description": "Balance top-up",
    "passStripeFeeToUser": false
  }'

curl "https://api.callpaymin.io/api/v1/billing/users/usr_abc123/transactions?type=debit&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/billing/users/usr_abc123/payment-methods \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/billing/users/usr_abc123/payment-methods \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethodId": "pm_card_visa_xxx",
    "setAsDefault": true
  }'

curl -X DELETE https://api.callpaymin.io/api/v1/billing/users/usr_abc123/payment-methods/pm_card_visa_xxx \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/billing/users/usr_abc123/setup-intent \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "clientSecret": "seti_xxx_secret_yyy",
    "usage": "off_session"
  }
}

curl -X POST https://api.callpaymin.io/api/v1/experts \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "expert-456",
    "email": "dr.smith@example.com",
    "profile": {
      "firstName": "David",
      "lastName": "Smith",
      "country": "US",
      "bio": "Senior consultant with 10 years experience",
      "skills": ["consulting", "strategy"]
    },
    "rates": { "perMinute": 5.00 },
    "revenueShare": { "expert": 80, "platform": 20 },
    "metadata": { "speciality": "business-strategy" }
  }'

curl "https://api.callpaymin.io/api/v1/experts?status=active&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/experts/exp_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X PUT https://api.callpaymin.io/api/v1/experts/exp_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rates": { "perMinute": 7.50 },
    "profile": { "bio": "Updated bio" }
  }'

curl https://api.callpaymin.io/api/v1/experts/exp_abc123/earnings \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "lifetime": { "gross": 5000.00, "net": 4500.00 },
    "pending": 250.00,
    "total": 4500.00,
    "paidOut": 4250.00
  }
}

curl "https://api.callpaymin.io/api/v1/experts/exp_abc123/payouts?limit=10" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/experts/exp_abc123/payouts \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 100.00 }'

curl -X POST https://api.callpaymin.io/api/v1/experts/exp_abc123/kyc-link \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "onboardingUrl": "https://connect.stripe.com/setup/e/...",
    "status": "pending"
  }
}

curl -X POST https://api.callpaymin.io/api/v1/jobs \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "React Developer for Dashboard Project",
    "description": "Build an analytics dashboard using React and D3.js",
    "skills": ["react", "d3.js", "typescript"],
    "ratePerMinute": 2.50,
    "requirements": {
      "experience": "3+ years React",
      "availability": "20 hours/week"
    },
    "metadata": { "projectId": "proj-123" }
  }'

curl "https://api.callpaymin.io/api/v1/jobs?status=open&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X PUT https://api.callpaymin.io/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Title",
    "status": "closed"
  }'

curl -X DELETE https://api.callpaymin.io/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl "https://api.callpaymin.io/api/v1/jobs/job_abc123/applications?status=pending&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/jobs/job_abc123/applications/app_xyz/review \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "approve",
    "notes": "Great portfolio. Welcome aboard!"
  }'

curl -X POST https://api.callpaymin.io/api/v1/jobs/job_abc123/applications/app_xyz/negotiate \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "negotiationNotes": "We love your profile! Would you consider $2.00/min instead?",
    "counterOfferRate": 2.00
  }'

curl -X POST https://api.callpaymin.io/api/v1/calls \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      { "externalId": "user-123", "displayName": "Alice", "role": "client" },
      { "externalId": "expert-456", "displayName": "Dr. Smith", "role": "expert" }
    ],
    "billing": {
      "payerId": "user-123",
      "ratePerMinute": 5.00,
      "currency": "USD",
      "gracePeriodSeconds": 60
    },
    "config": {
      "video": true,
      "audio": true,
      "aiSummaryEnabled": true
    },
    "metadata": { "topic": "legal-consultation" }
  }'

{
  "success": true,
  "data": {
    "id": "call_mlpyn54umfnbu651",
    "participants": [
      { "id": "part_abc", "externalId": "user-123", "displayName": "Alice", "role": "client", "connectionStatus": "connecting" },
      { "id": "part_def", "externalId": "expert-456", "displayName": "Dr. Smith", "role": "expert", "connectionStatus": "connecting" }
    ],
    "billing": {
      "payerId": "usr_abc",
      "ratePerMinute": 5.00,
      "currency": "USD",
      "gracePeriodSeconds": 60
    },
    "webrtc": {
      "roomId": "room_call_mlpyn54umfnbu651",
      "signalingUrl": "wss://signaling.callpaymin.io"
    },
    "status": "pending",
    "createdAt": "2026-02-16T12:00:00.000Z"
  }
}

curl "https://api.callpaymin.io/api/v1/calls?status=active&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/calls/call_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/calls/call_abc123/start \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/calls/call_abc123/end \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "completed" }'

{
  "success": true,
  "data": {
    "id": "call_abc123",
    "status": "ended",
    "endReason": "completed",
    "duration": {
      "totalSeconds": 312,
      "billableSeconds": 312,
      "startedAt": "2026-02-16T12:00:00.000Z",
      "endedAt": "2026-02-16T12:05:12.000Z"
    },
    "cost": {
      "total": 30.00,
      "breakdown": {
        "callMinutes": 30.00,
        "platformFee": 1.05,
        "expertEarnings": 23.16,
        "businessShare": 5.79
      }
    }
  }
}

curl "https://api.callpaymin.io/api/v1/calls/call_abc123/credentials?externalId=user-123" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "callId": "call_abc123",
    "roomId": "room_call_abc123",
    "signaling": {
      "url": "wss://signaling.callpaymin.io",
      "apiUrl": "https://signaling.callpaymin.io"
    },
    "ice": {
      "urls": ["turn:turn.callpaymin.io:3478", "turns:turn.callpaymin.io:5349"],
      "username": "callpaymin",
      "credential": "xxx",
      "credentialType": "password"
    },
    "config": { "video": true, "audio": true },
    "participants": [
      { "id": "part_abc", "externalId": "user-123", "displayName": "Alice", "role": "client" },
      { "id": "part_def", "externalId": "expert-456", "displayName": "Dr. Smith", "role": "expert" }
    ]
  }
}

curl https://api.callpaymin.io/api/v1/calls/call_abc123/recording \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

# Start recording
curl -X PATCH https://api.callpaymin.io/api/v1/calls/call_abc123/recording \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "start" }'
​
# Stop recording
curl -X PATCH https://api.callpaymin.io/api/v1/calls/call_abc123/recording \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "stop" }'

curl -X POST https://api.callpaymin.io/api/v1/calls/call_abc123/recording \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://storage.example.com/recording.webm",
    "durationSeconds": 312,
    "format": "webm",
    "fileSize": 15000000
  }'

curl https://api.callpaymin.io/api/v1/calls/call_abc123/transcription \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/calls/call_abc123/transcription \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/chats \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      { "externalId": "user-123", "displayName": "Alice", "role": "user" },
      { "externalId": "expert-456", "displayName": "Dr. Smith", "role": "expert" }
    ],
    "billing": {
      "payerId": "user-123",
      "ratePerMinute": 5.00
    },
    "metadata": { "topic": "tax-advice" }
  }'

curl "https://api.callpaymin.io/api/v1/chats?status=active&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/chats/chat_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/chats/chat_abc123/messages \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderExternalId": "user-123",
    "content": "Can you help me with my tax return?",
    "contentType": "text"
  }'

curl "https://api.callpaymin.io/api/v1/chats/chat_abc123/messages?limit=50&order=asc" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/chats/chat_abc123/end \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/rooms \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expertExternalId": "expert-456",
    "name": "Tax Consultation Room",
    "description": "Weekly tax Q&A session",
    "maxParticipants": 10,
    "scheduledTime": "2026-02-20T14:00:00.000Z",
    "scheduledEndTime": "2026-02-20T15:00:00.000Z",
    "settings": {
      "ratePerMinute": 2.00,
      "video": true,
      "audio": true
    },
    "metadata": { "recurring": true }
  }'

curl "https://api.callpaymin.io/api/v1/rooms?status=active&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/rooms/room_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/rooms/room_abc123/start \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "expertExternalId": "expert-456" }'

curl -X POST https://api.callpaymin.io/api/v1/rooms/room_abc123/join \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participantExternalId": "user-123",
    "participantName": "Alice Johnson"
  }'

curl -X POST https://api.callpaymin.io/api/v1/rooms/room_abc123/heartbeat \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "participantExternalId": "user-123" }'

{ "success": true, "data": { "ok": true } }

curl -X POST https://api.callpaymin.io/api/v1/rooms/room_abc123/billing-increment \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "participantExternalId": "user-123" }'

{
  "success": true,
  "data": {
    "charged": 10.00,
    "minutes": 5,
    "balance": { "available": 40.00 },
    "shouldDisconnect": false
  }
}

curl -X POST https://api.callpaymin.io/api/v1/rooms/room_abc123/leave \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participantExternalId": "user-123",
    "reason": "done"
  }'

curl -X POST https://api.callpaymin.io/api/v1/rooms/room_abc123/remove-participant \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expertExternalId": "expert-456",
    "participantExternalId": "user-123"
  }'

curl -X POST https://api.callpaymin.io/api/v1/rooms/room_abc123/close \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "expertExternalId": "expert-456" }'

curl -X DELETE https://api.callpaymin.io/api/v1/rooms/room_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "expertExternalId": "expert-456" }'

curl -X POST https://api.callpaymin.io/api/v1/work-sessions \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "job_abc123",
    "questerId": "usr_client",
    "workerId": "exp_expert",
    "ratePerMinute": 2.50,
    "metadata": { "task": "dashboard-build" }
  }'

curl "https://api.callpaymin.io/api/v1/work-sessions?status=active&limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/end?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "endReason": "completed" }'

curl -X POST "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/process-increment?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "questerId": "usr_client",
    "videoCallActive": true
  }'

curl "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/chat?questerId=usr_client&limit=50" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/chat?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "usr_client",
    "senderRole": "quester",
    "text": "Can you focus on the charts section?"
  }'

curl "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/screenshots?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/screenshots?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageBase64": "iVBORw0KGgo...",
    "width": 1920,
    "height": 1080
  }'

# List files
curl "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/files?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"
​
# Download specific file
curl "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/files?questerId=usr_client&fileKey=report.pdf" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/files?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "report.pdf",
    "fileData": "JVBERi0xLjQ...",
    "fileType": "application/pdf",
    "senderId": "usr_client",
    "senderRole": "quester"
  }'

curl "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/review?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST "https://api.callpaymin.io/api/v1/work-sessions/ws_abc123/review?questerId=usr_client" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rating": 5,
    "comment": "Excellent work! Delivered exactly what I needed.",
    "deliverableReceived": true,
    "reviewerName": "Alice Johnson"
  }'

curl -X POST https://api.callpaymin.io/api/v1/summaries/calls/call_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "id": "sum_abc",
    "callId": "call_abc123",
    "summary": "Alice consulted Dr. Smith about her tax situation...",
    "keyPoints": ["Discussed Q4 deductions", "Recommended filing extension"],
    "generatedAt": "2026-02-16T12:10:00.000Z"
  }
}

curl https://api.callpaymin.io/api/v1/summaries/calls/call_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X POST https://api.callpaymin.io/api/v1/summaries/chats/chat_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl https://api.callpaymin.io/api/v1/summaries/chats/chat_abc123 \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

curl -X PUT https://api.callpaymin.io/api/v1/organization/webhooks \
  -H "Authorization: Bearer cpm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "callStarted": "https://yourapp.com/webhooks/calls",
    "callEnded": "https://yourapp.com/webhooks/calls",
    "chatMessage": "https://yourapp.com/webhooks/chats",
    "balanceLow": "https://yourapp.com/webhooks/billing",
    "expertVerified": "https://yourapp.com/webhooks/experts"
  }'

Content-Type: application/json
X-CallPayMin-Event: call.ended
X-CallPayMin-Delivery: del_abc123
X-CallPayMin-Signature: t=1708108800,v1=5257a869...

{
  "id": "evt_abc123",
  "type": "call.ended",
  "data": {
    "callId": "call_xyz",
    "duration": { "totalSeconds": 312, "billableMinutes": 6 },
    "cost": { "total": 30.00 },
    "endReason": "completed"
  },
  "created": 1708108800
}

const crypto = require('crypto');
​
function verifyWebhook(rawBody, signatureHeader, webhookSecret) {
  const parts = signatureHeader.split(',');
  const timestamp = parts.find(p => p.startsWith('t=')).slice(2);
  const signature = parts.find(p => p.startsWith('v1=')).slice(3);
​
  // Check timestamp (reject if > 5 minutes old)
  const age = Math.abs(Date.now() / 1000 - parseInt(timestamp));
  if (age > 300) return false;
​
  // Compute expected signature
  const signedPayload = `${timestamp}.${rawBody}`;
  const expected = crypto
    .createHmac('sha256', webhookSecret)
    .update(signedPayload)
    .digest('hex');
​
  // Timing-safe comparison
  return crypto.timingSafeEqual(
    Buffer.from(signature, 'hex'),
    Buffer.from(expected, 'hex')
  );
}
​
// Express.js example
app.post('/webhooks/calls', express.raw({ type: 'application/json' }), (req, res) => {
  const isValid = verifyWebhook(
    req.body.toString(),
    req.headers['x-callpaymin-signature'],
    'whsec_YOUR_SECRET'
  );
​
  if (!isValid) return res.status(401).send('Invalid signature');
​
  const event = JSON.parse(req.body);
  console.log('Event:', event.type, event.data);
​
  res.status(200).json({ received: true });
});

import hmac
import hashlib
import time
​
def verify_webhook(raw_body: str, signature_header: str, webhook_secret: str) -> bool:
    parts = dict(p.split('=', 1) for p in signature_header.split(','))
    timestamp = parts.get('t', '')
    signature = parts.get('v1', '')
​
    # Check timestamp
    age = abs(time.time() - int(timestamp))
    if age > 300:
        return False
​
    # Compute expected signature
    signed_payload = f"{timestamp}.{raw_body}"
    expected = hmac.new(
        webhook_secret.encode(),
        signed_payload.encode(),
        hashlib.sha256
    ).hexdigest()
​
    return hmac.compare_digest(signature, expected)

package main
​
import (
    "crypto/hmac"
    "crypto/sha256"
    "encoding/hex"
    "fmt"
    "math"
    "strconv"
    "strings"
    "time"
)
​
func verifyWebhook(rawBody, signatureHeader, webhookSecret string) bool {
    parts := make(map[string]string)
    for _, p := range strings.Split(signatureHeader, ",") {
        kv := strings.SplitN(p, "=", 2)
        if len(kv) == 2 {
            parts[kv[0]] = kv[1]
        }
    }
​
    timestamp := parts["t"]
    signature := parts["v1"]
​
    ts, _ := strconv.ParseInt(timestamp, 10, 64)
    age := math.Abs(float64(time.Now().Unix() - ts))
    if age > 300 {
        return false
    }
​
    signedPayload := fmt.Sprintf("%s.%s", timestamp, rawBody)
    mac := hmac.New(sha256.New, []byte(webhookSecret))
    mac.Write([]byte(signedPayload))
    expected := hex.EncodeToString(mac.Sum(nil))
​
    return hmac.Equal([]byte(signature), []byte(expected))
}

function verifyWebhook(string $rawBody, string $signatureHeader, string $webhookSecret): bool {
    $parts = [];
    foreach (explode(',', $signatureHeader) as $part) {
        [$key, $value] = explode('=', $part, 2);
        $parts[$key] = $value;
    }
​
    $timestamp = $parts['t'] ?? '';
    $signature = $parts['v1'] ?? '';
​
    if (abs(time() - (int)$timestamp) > 300) {
        return false;
    }
​
    $signedPayload = "{$timestamp}.{$rawBody}";
    $expected = hash_hmac('sha256', $signedPayload, $webhookSecret);
​
    return hash_equals($expected, $signature);
}

require 'openssl'
​
def verify_webhook(raw_body, signature_header, webhook_secret)
  parts = signature_header.split(',').map { |p| p.split('=', 2) }.to_h
  timestamp = parts['t']
  signature = parts['v1']
​
  return false if (Time.now.to_i - timestamp.to_i).abs > 300
​
  signed_payload = "#{timestamp}.#{raw_body}"
  expected = OpenSSL::HMAC.hexdigest('sha256', webhook_secret, signed_payload)
​
  ActiveSupport::SecurityUtils.secure_compare(signature, expected)
end

curl "https://api.callpaymin.io/api/v1/organization/webhook-deliveries?status=failed&limit=10" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

1. Create billing user          POST /billing/users
2. Create expert                POST /experts
3. Add payment method to user            POST /billing/users/{id}/add-funds
4. Create call                  POST /calls
5. Get WebRTC credentials       GET  /calls/{id}/credentials?externalId=xxx
6. Connect participants via WebRTC (your frontend)
7. Start call (begin billing)   POST /calls/{id}/start
8. ... call in progress ...
9. End call (auto-bills)        POST /calls/{id}/end
10. Generate AI summary         POST /summaries/calls/{id}
11. Check user balance          GET  /billing/users/{id}
12. Check expert earnings       GET  /experts/{id}/earnings

1. Create billing user          POST /billing/users  (skip if exists)
2. Create expert                POST /experts  (skip if exists)
3. Add payment method                    POST /billing/users/{id}/add-funds
4. Create chat                  POST /chats
5. Send messages                POST /chats/{id}/messages  (first 10 free, then billed)
6. ... chat in progress ...
7. End chat                     POST /chats/{id}/end
8. Generate summary             POST /summaries/chats/{id}

1. Create expert                POST /experts  (skip if exists)
2. Create room                  POST /rooms
3. Expert joins / starts room   POST /rooms/{id}/start  (if scheduled)
4. Participants join             POST /rooms/{id}/join  (one per user)
5. Start heartbeat timer        POST /rooms/{id}/heartbeat  (every 30s per participant)
6. Start billing timer          POST /rooms/{id}/billing-increment  (every 5 min per participant)
7. ... meeting in progress ...
8. Participant leaves            POST /rooms/{id}/leave
9. Expert closes room           POST /rooms/{id}/close  (finalizes all billing)

1. Create a job                 POST /jobs
2. Wait for applications        GET  /jobs/{id}/applications  (poll or use webhooks)
3. Review application           POST /jobs/{id}/applications/{appId}/review
4. (Optional) Negotiate rate    POST /jobs/{id}/applications/{appId}/negotiate
5. Create work session          POST /work-sessions
6. Start billing timer          POST /work-sessions/{id}/process-increment  (every 5 min)
7. Chat during work             POST /work-sessions/{id}/chat
8. Upload files                 POST /work-sessions/{id}/files
9. Capture screenshots          POST /work-sessions/{id}/screenshots
10. End session                 POST /work-sessions/{id}/end
11. Submit review               POST /work-sessions/{id}/review

1. User's balance drops below threshold
2. CallPayMin sends webhook to your URL:
   POST https://yourapp.com/webhooks/recharge
   {
     "type": "balance.low",
     "data": {
       "userId": "usr_abc",
       "externalId": "user-123",
       "currentBalance": 3.50,
       "threshold": 5.00,
       "suggestedAmount": 25.00
     }
   }
3. Your server charges the user's card (via your Stripe/payment provider)
4. Your server adds funds:
   POST /billing/users/{id}/add-funds  { "amount": 25.00 }
5. User continues their session uninterrupted

1. Switch to managed mode       POST /organization/stripe/switch-payment-mode  { "newMode": "managed" }
2. Complete Stripe onboarding   POST /organization/stripe/onboarding-link  (redirect user to URL)
3. Sync verification status     POST /organization/stripe/sync-status
4. Create billing user          POST /billing/users
5. Create Stripe setup intent   POST /billing/users/{id}/setup-intent
6. Collect card on frontend     (use Stripe.js with clientSecret)
7. Save payment method          POST /billing/users/{id}/payment-methods
8. Now auto-recharge works!     (CallPayMin charges the card when balance is low)

class CallPayMin {
  private baseUrl: string;
  private apiKey: string;
​
  constructor(apiKey: string, baseUrl = 'https://api.callpaymin.io/api/v1') {
    this.apiKey = apiKey;
    this.baseUrl = baseUrl;
  }
​
  private async request(method: string, path: string, body?: any) {
    const res = await fetch(`${this.baseUrl}${path}`, {
      method,
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json',
      },
      body: body ? JSON.stringify(body) : undefined,
    });
​
    const data = await res.json();
​
    if (!res.ok) {
      throw new Error(`${data.error}: ${data.message}`);
    }
​
    return data.data || data;
  }
​
  // Billing Users
  async createUser(data: any) { return this.request('POST', '/billing/users', data); }
  async getUser(userId: string) { return this.request('GET', `/billing/users/${userId}`); }
  async addFunds(userId: string, amount: number, ref?: string) {
    return this.request('POST', `/billing/users/${userId}/add-funds`, { amount, reference: ref });
  }
​
  // Experts
  async createExpert(data: any) { return this.request('POST', '/experts', data); }
  async getExpert(expertId: string) { return this.request('GET', `/experts/${expertId}`); }
​
  // Calls
  async createCall(data: any) { return this.request('POST', '/calls', data); }
  async startCall(callId: string) { return this.request('POST', `/calls/${callId}/start`); }
  async endCall(callId: string, reason = 'completed') {
    return this.request('POST', `/calls/${callId}/end`, { reason });
  }
  async getCredentials(callId: string, externalId: string) {
    return this.request('GET', `/calls/${callId}/credentials?externalId=${externalId}`);
  }
​
  // Chats
  async createChat(data: any) { return this.request('POST', '/chats', data); }
  async sendMessage(chatId: string, senderExternalId: string, content: string) {
    return this.request('POST', `/chats/${chatId}/messages`, { senderExternalId, content });
  }
  async endChat(chatId: string) { return this.request('POST', `/chats/${chatId}/end`); }
​
  // Rooms
  async createRoom(data: any) { return this.request('POST', '/rooms', data); }
  async joinRoom(roomId: string, participantExternalId: string) {
    return this.request('POST', `/rooms/${roomId}/join`, { participantExternalId });
  }
  async closeRoom(roomId: string, expertExternalId: string) {
    return this.request('POST', `/rooms/${roomId}/close`, { expertExternalId });
  }
​
  // Work Sessions
  async createWorkSession(data: any) { return this.request('POST', '/work-sessions', data); }
  async endWorkSession(sessionId: string) {
    return this.request('POST', `/work-sessions/${sessionId}/end`);
  }
​
  // AI Summaries
  async generateCallSummary(callId: string) {
    return this.request('POST', `/summaries/calls/${callId}`);
  }
  async generateChatSummary(chatId: string) {
    return this.request('POST', `/summaries/chats/${chatId}`);
  }
}
​
// Usage
const cpm = new CallPayMin('cpm_live_YOUR_KEY');
​
const user = await cpm.createUser({
  externalId: 'user-123',
  email: 'alice@example.com',
  displayName: 'Alice',
  initialBalance: 50.00,
});
​
const call = await cpm.createCall({
  participants: [
    { externalId: 'user-123', displayName: 'Alice', role: 'client' },
    { externalId: 'expert-456', displayName: 'Dr. Smith', role: 'expert' },
  ],
  billing: { payerId: 'user-123', ratePerMinute: 5.00 },
});
​
// ... connect WebRTC, then:
await cpm.startCall(call.id);
​
// ... when done:
const result = await cpm.endCall(call.id);
console.log(`Cost: $${result.cost.total}`);

async function connectToCall(callId, externalId, apiKey) {
  // 1. Get credentials
  const res = await fetch(
    `https://api.callpaymin.io/api/v1/calls/${callId}/credentials?externalId=${externalId}`,
    { headers: { 'Authorization': `Bearer ${apiKey}` } }
  );
  const { data } = await res.json();
​
  // 2. Create peer connection with TURN servers
  const pc = new RTCPeerConnection({
    iceServers: [{
      urls: data.ice.urls,
      username: data.ice.username,
      credential: data.ice.credential,
    }],
  });
​
  // 3. Add local media
  const stream = await navigator.mediaDevices.getUserMedia({
    video: data.config.video,
    audio: data.config.audio,
  });
  stream.getTracks().forEach(track => pc.addTrack(track, stream));
​
  // 4. Handle remote media
  pc.ontrack = (event) => {
    document.getElementById('remoteVideo').srcObject = event.streams[0];
  };
​
  // 5. Signal via your signaling server (data.signaling.url)
  // ... implement offer/answer exchange ...
​
  return { pc, stream };
}

curl "https://api.callpaymin.io/api/v1/calls?limit=20" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{ "data": [...], "hasMore": true, "cursor": "call_xyz" }

curl "https://api.callpaymin.io/api/v1/calls?limit=20&cursor=call_xyz" \
  -H "Authorization: Bearer cpm_live_YOUR_KEY"

{
  "success": true,
  "data": { ... }
}

{
  "error": "ERROR_CODE",
  "message": "What went wrong and how to fix it"
}

{
  "success": true,
  "data": {
    "data": [ ... ],
    "hasMore": true,
    "cursor": "next_page_token"
  }
}