KCVoIP API Reference

const response = await fetch('https://api.kcvoip.com/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from: '+18165551234',
    to: '+19135551234',
    webhook_url: 'https://your-app.com/call-events'
  })
});

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

import requests

url = 'https://api.kcvoip.com/v1/numbers/search'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'area_code': '816',
    'limit': 10,
    'type': 'local'
}

response = requests.post(url, headers=headers, json=data)
numbers = response.json()

for number in numbers['data']:
    print(f"Available: {number['phone_number']}")

<?php
// Verify webhook signature
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_KCVOIP_SIGNATURE'];
$expected = hash_hmac('sha256', $payload, $webhook_secret);

if (!hash_equals($signature, $expected)) {
    http_response_code(401);
    exit('Invalid signature');
}

$event = json_decode($payload, true);

switch ($event['type']) {
    case 'call.completed':
        // Handle completed call
        $call_id = $event['data']['id'];
        $duration = $event['data']['duration'];
        break;
    
    case 'number.ported':
        // Handle number port completion
        $number = $event['data']['phone_number'];
        break;
}

http_response_code(200);
echo 'OK';
?>