Marcus Whitfield
Broker · Arbor Homes Realty
“Every listing city has its own local number now. Open-house calls actually get answered — no more screened voicemails from unknown prefixes.”
REST API for voice, SMS, number management, webhooks, and analytics. Bearer token auth. Versioned, documented, and available in 5 SDKs.
/v1/calls/v1/messages/v1/calls/{id}/v1/webhooks/v1/analytics/callsEvery endpoint below follows the same pattern, so once your first request works the rest do too.
Every request goes to https://api.twiching.ai/v1/ over HTTPS. Plain HTTP is rejected.
Send your API key as a Bearer token, or fetch a short-lived token with OAuth 2.0.
Request bodies are JSON. A successful request returns a 200 or 201 status.
The sandbox at sandbox.twiching.ai/v1/ never reaches real numbers and is free.
Base URL: https://api.twiching.ai
Place calls and look up what happened on them. Covers PSTN calling, SIP trunking, call control and recording.
/v1/callsInitiate a call/v1/calls/{id}Retrieve call detailsSend an SMS or MMS and look it up later. Long code, short code and toll-free numbers are supported.
/v1/messagesSend SMS or MMS/v1/messages/{id}Retrieve messageFind a number, then provision it. Numbers are available in 191 countries from the same API.
/v1/numbers/searchSearch available DIDs/v1/numbers/provisionProvision a numberPull a summary of your call analytics without opening the dashboard.
/v1/analytics/callsCall analytics summaryRegister a URL and Twiching sends it events as they happen. Payloads are signed with HMAC-SHA256.
/v1/webhooksRegister webhookMost integrations are a short chain of requests. These are the three we see most.
Pass your API key in the Authorization header on every request.
Use client credentials flow for machine-to-machine integrations.
Send a POST to /v1/calls with the number to dial and the number to dial from. The response carries the call id.
Keep that id. Request GET /v1/calls/{id} later to see how the call went, or subscribe to webhook events and let Twiching tell you.
POST https://api.twiching.ai/v1/calls
Authorization: Bearer tw_live_xxxxxxxxxxxxxxxx
Content-Type: application/json
{
"to": "+14155551234",
"from": "+12125550001"
}HTTP/1.1 200 OK
{
"sid": "CA1a2b3c4d…",
"status": "initiated"
}Register a URL with POST /v1/webhooks and pick the events you want. Signing, retries and delivery are covered on the docs page.
call.initiatedcall.ringingcall.answeredcall.completedcall.failedmessage.sentmessage.deliveredmessage.failedrecording.readyEvery SDK wraps the same endpoints, so the requests on this page translate directly into your language.
npm installpip installgo getgem installcomposer requireReliable communication built for modern teams. From clinics to real-estate offices, businesses stay reachable without missed calls, disconnected systems, or outdated phone setups.
Contact UsBroker · Arbor Homes Realty
“Every listing city has its own local number now. Open-house calls actually get answered — no more screened voicemails from unknown prefixes.”
Director · Northside Family Clinic
“Moved our appointment reminders and after-hours line in a weekend. Patients don't hit voicemail at 5:01 PM anymore, and the whole thing stayed HIPAA-aligned.”
Co-founder · Telemetry SaaS
“Our support number used to show as “unknown caller” in customers’ CRMs. Not anymore. One account, one bill, one team that picks up.”
Operations · Beacon Logistics
“Porting our business numbers was smoother than expected. The onboarding team handled everything while we stayed live.”
Marketing Lead · Elevate Media
“The analytics dashboard finally shows which campaigns drive actual phone calls. Our ad spend makes sense now.”
Broker · Arbor Homes Realty
“Every listing city has its own local number now. Open-house calls actually get answered — no more screened voicemails from unknown prefixes.”
Director · Northside Family Clinic
“Moved our appointment reminders and after-hours line in a weekend. Patients don't hit voicemail at 5:01 PM anymore, and the whole thing stayed HIPAA-aligned.”
Co-founder · Telemetry SaaS
“Our support number used to show as “unknown caller” in customers’ CRMs. Not anymore. One account, one bill, one team that picks up.”
Operations · Beacon Logistics
“Porting our business numbers was smoother than expected. The onboarding team handled everything while we stayed live.”
Marketing Lead · Elevate Media
“The analytics dashboard finally shows which campaigns drive actual phone calls. Our ad spend makes sense now.”
FAQ
Voice calls, SMS and MMS messages, phone numbers, call analytics and webhooks. Each one has its own endpoints under /v1/.
Request GET /v1/calls/{id} for a call or GET /v1/messages/{id} for a message, using the id returned when you created it.
Search with POST /v1/numbers/search, then provision the one you want with POST /v1/numbers/provision. Numbers are available in 191 countries.
A 200 or 201 status with a JSON body. Errors return a 4xx or 5xx status, and the docs list what each code means.
Yes. Register a webhook with POST /v1/webhooks and subscribe to call.completed. Message and recording events work the same way.
On the docs page, which has limits for each plan and a table of error codes. This page is the endpoint reference.
Start building
Full API access, 5 official SDKs, and a sandbox environment. No telephony knowledge required.
Compliance with applicable regulations required.