Developers

API overview

The KwikCall REST API lets you look up numbers, manage phone numbers, read calls, and send messages — authenticated with an API key. Base URL:

https://api.kwikcall.ai/v1

Get an API key

Sign in, open Developers in your dashboard, and create a key. Keys look likekc_live_…and are shown once — store it securely.

Authentication

Send your key as a Bearer token on every request:

Authorization: Bearer kc_live_xxxxxxxxxxxxxxxx

Look up a number

Carrier, line type and portability for any number.

curl https://api.kwikcall.ai/v1/phone-numbers/lookup?number=+14155551212 \
  -H "Authorization: Bearer $KWIKCALL_API_KEY"

# → { "number": "+14155551212", "country": "United States",
#     "carrier": "…", "line_type": "mobile", "ported": "no" }

List your numbers & calls

curl https://api.kwikcall.ai/v1/phone-numbers -H "Authorization: Bearer $KEY"
curl https://api.kwikcall.ai/v1/calls        -H "Authorization: Bearer $KEY"

Buy a number

curl https://api.kwikcall.ai/v1/phone-numbers/search?pattern=313 \
  -H "Authorization: Bearer $KEY"

curl -X POST https://api.kwikcall.ai/v1/phone-numbers/buy \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"number":"+13139085024"}'

Place a call (Voice API)

Place an outbound call handled by one of your AI agents.

curl -X POST https://api.kwikcall.ai/v1/calls \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"to":"+14155551212","agent_id":"agt_xxx"}'

Send a fax

Fax a PDF over the API.

curl -X POST https://api.kwikcall.ai/v1/faxes \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"to":"+14155551212","media_url":"https://example.com/doc.pdf"}'

Verify a user (OTP / 2FA)

Send a one-time passcode by voice call or SMS, then check it. We generate, deliver and track the code — you never store it. Voice OTP is available today.

curl -X POST https://api.kwikcall.ai/v1/verify/start \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"number":"+14155551212","channel":"call"}'   # channel: call | sms | flashcall

curl -X POST https://api.kwikcall.ai/v1/verify/check \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"number":"+14155551212","code":"123456"}'
# → { "verified": true }

Send a message

Send SMS from your number. Note: outbound US SMS requires 10DLC registration — contact us to enable it on your account.

curl -X POST https://api.kwikcall.ai/v1/sms/send \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"to":"+13139085024","body":"Hello from KwikCall"}'

Webhooks

Register endpoints in your dashboard to receive signed events for call and message status. Verify the signature header before trusting a payload.

Need a hand?
Email support@kwikcall.ai or open a ticket from your dashboard — we’ll help you integrate.