Telnyx voice URL for a screened number

POST

/api/voice/filter/texml

Set this URL as the Voice URL of a Telnyx TeXML Application. It returns TeXML that forks the caller's audio to the filter socket with codec="PCMU" and dials forward. Telnyx sends from and to in the stream start frame. Events go to webhook only.

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/texml?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:56

Preview the Twilio TwiML

Twilio voice URL for a honeypot number