Twilio voice URL for a screened number

POST

/api/voice/filter/twiml

Set this URL as the voice URL of a Twilio number. It returns TwiML that forks the caller's audio to the filter socket and dials forward. Twilio posts From, To, and CallSid as form fields. The endpoint copies From and To onto the stream. Events go to webhook only. GET is accepted as well so the URL can be checked in a browser.

Request

Authorization

API Key

Add parameter in header

x-auth

Example:

x-auth: ********************

Query Params

Body Params application/x-www-form-urlencoded

Responses

🟢200TwiML or TeXML that forks the caller's audio to the filter a

application/xml

TwiML or TeXML that forks the caller's audio to the filter and dials forward.

Bodyapplication/xml

🟠400Bad input

🟠401Missing or wrong API key

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.callerapi.com/api/voice/filter/twiml?forward=+15551234567&webhook=https%3A%2F%2Fexample.com%2Fcallerapi-voice&language=en&report=false&tracks=undefined' \
--header 'x-auth: <api-key>' \
--data-urlencode 'From=' \
--data-urlencode 'To=' \
--data-urlencode 'CallSid='

Response Example

200 - TwiML or TeXML that forks the caller's audio to the filter a

<?xml version="1.0" encoding="UTF-8"?><Response><Start><Stream url="wss://api.callerapi.com/api/voice/filter/stream?key=YOUR_KEY" track="inbound_track"><Parameter name="from" value="+15559990000"/><Parameter name="to" value="+15551234567"/><Parameter name="webhook" value="https://example.com/hook"/></Stream></Start><Dial>+15551234567</Dial></Response>

Modified at 2026-09-18 16:51:51

Get one session with verdict and intel

Preview the Twilio TwiML