Skip to main content
GET
https://api.getmalakai.com/
callers
/
get-twilio-address
curl --request GET \ 
--url 'callers/get-twilio-address?bundleSid=BU...&isoCountry=US' \ 
--header 'Authorization: Bearer YOUR_API_KEY' 

{
    "responseCode": 2000,
    "message": "Twilio address fetched successfully",
    "data": {
        "accountSid": "***",
        "city": "Rochford",
        "customerName": "",
        "dateCreated": "2025-01-23T08:51:00.000Z",
        "dateUpdated": "2025-01-24T01:04:25.000Z",
        "friendlyName": "",
        "isoCountry": "GB",
        "postalCode": "SS4 1AJ",
        "region": "Essex",
        "sid": "***",
        "street": "16 West Street",
        "uri": "***",
        "emergencyEnabled": false,
        "validated": true,
        "verified": false,
        "streetSecondary": "Rochford"
    }
}

​
Headers

​
Authorization
string
required
Your API key for authentication. Prefix with Bearer .
​
x-access-token
string
required
Your access token for authentication.

​
Query Parameters

​
bundleSid
string
required
The unique SID of the Regulatory Bundle (e.g., BUxxxxxxxx...) for which to retrieve addresses.
​
isoCountry
string
required
The 2-letter ISO 3166-1 alpha-2 country code of the address. For example, US.
curl --request GET \ 
--url 'callers/get-twilio-address?bundleSid=BU...&isoCountry=US' \ 
--header 'Authorization: Bearer YOUR_API_KEY'

​
Response

Returns an array of available Twilio Regulatory Bundles.
​
message
string
Status of the request in the form of a short message.
​
data
object[]
An array of bundle objects.
{
    "responseCode": 2000,
    "message": "Twilio address fetched successfully",
    "data": {
        "accountSid": "***",
        "city": "Rochford",
        "customerName": "",
        "dateCreated": "2025-01-23T08:51:00.000Z",
        "dateUpdated": "2025-01-24T01:04:25.000Z",
        "friendlyName": "",
        "isoCountry": "GB",
        "postalCode": "SS4 1AJ",
        "region": "Essex",
        "sid": "***",
        "street": "16 West Street",
        "uri": "***",
        "emergencyEnabled": false,
        "validated": true,
        "verified": false,
        "streetSecondary": "Rochford"
    }
}