Developer docs

Everything to ship real voice AI on our API.

Pay-as-you-go. Real phones. Real compliance. Idiomatic SDKs in Python + TypeScript generated from the same OpenAPI spec that powers this site.

Guides

Quickstart

Signup → API key → first real call in 10 minutes. Start here.

Concepts

Tenants, agents, calls, campaigns, sandbox mode, idempotency, rate limits, versioning.

Webhooks

15 event types, HMAC signing, replay history, test fire. Subscribe + verify.

Reference

API reference (interactive)

Scalar over /v1/openapi.json. Try any endpoint with your own API key.

SDKs

Hand-written Python + TypeScript clients, coming shortly. Same pattern Stripe, Anthropic, and Pipecat ship — no generator bloat.

Security

What ships, what's on paper, what's deferred. Honest posture.

Status

Live operational status of API, voice runtime, post-call pipeline.

30-second example

Create a sandbox key

curl https://api.callingscout.ai/api/v1/keys \
  -H "Authorization: Bearer $CALLINGSCOUT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "CI sandbox", "sandbox": true}'

Dial a call from Python

from callingscout import CallingScout

cs = CallingScout(api_key="sk_live_…")
call = cs.calls.create(
    agent_id="…",
    from_="+14155552671",
    to="+14155551234",
    idempotency_key="my-dedup-id",
)
print(call.status)  # "queued"

Full walkthrough → Quickstart