Skip to main content
GET
/
api
/
v1
/
providers
/
twilio
/
{id}
Get Twilio provider
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://blackbox.dasha.ai/api/v1/providers/twilio/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "name": "<string>",
  "providerType": "twilio",
  "accountSid": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "verificationStatus": "pending",
  "lastVerifiedAt": "2023-11-07T05:31:56Z",
  "phoneNumberCount": 123,
  "verificationDetails": [
    {
      "checkName": "<string>",
      "message": "<string>",
      "status": "passed",
      "timestamp": "2023-11-07T05:31:56Z",
      "details": {}
    }
  ],
  "trunkSid": "<string>",
  "terminationUri": "<string>",
  "region": "<string>",
  "supportsCallTransfer": true
}

​
Twilio-Specific Response

This endpoint returns Twilio-specific configuration details not available in the generic provider endpoint:
FieldDescription
accountSidYour Twilio Account SID (non-sensitive identifier)
trunkSidSID of the auto-configured SIP trunk
terminationUriSIP termination URI for the trunk
regionTwilio region for the trunk (us1, us2, ie1, de1, etc.)
supportsCallTransferWhether call transfer is enabled

​
Security Note

The Auth Token is never exposed in API responses for security reasons. Only the Account SID is returned as it is a non-sensitive identifier used for display purposes.
  • Generic provider: GET /api/v1/providers/{id} - Returns polymorphic response with base provider fields
  • Update provider: PUT /api/v1/providers/twilio/{id} - Update Twilio-specific configuration
  • Available numbers: GET /api/v1/providers/twilio/{id}/available-numbers - List phone numbers in Twilio account

Path Parameters

​
id
string<uuid>
required

Provider identifier

Response

Returns Twilio provider successfully with all configuration details

Response DTO for Twilio provider integrations. Contains Twilio-specific configuration details including account identifier, SIP trunk configuration, and regional settings. AuthToken is intentionally excluded from responses for security.

​
name
string | null
required

Display name for the provider integration. Used to identify the provider in the UI and API responses.

​
providerType
enum<string>
required

Type of VoIP provider. Always returns Twilio for this DTO.

Available options:
twilio
​
accountSid
string
required

Twilio Account SID. A unique identifier for the Twilio account associated with this provider. Format: AC[a-f0-9]{32} (e.g., ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx).

Minimum string length: 1
​
id
string<uuid>

Unique identifier for the provider integration.

​
verificationStatus
enum<string>

Current verification status of the provider credentials. Indicates the health and validity of the integration. Supported values: pending, verified, warning, failed.

Available options:
pending,
verified,
warning,
failed
​
lastVerifiedAt
string<date-time> | null

Timestamp when the provider credentials were last verified. Null if verification has never been performed.

​
phoneNumberCount
integer<int32>

Total number of phone numbers currently imported and managed through this provider integration.

​
verificationDetails
object[] | null

Detailed results of the last verification. Contains individual check results with status, messages, and timestamps. Null if verification has never been performed.

​
trunkSid
string | null

Twilio SIP Trunk SID. The unique identifier for the SIP trunk created in Twilio for this provider. Format: TK[a-f0-9]{32} (e.g., TKxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx).

​
terminationUri
string | null

SIP trunk termination URI configured for this provider. Used for routing outbound calls through Twilio. Format: sip:.pstn.twilio.com

​
region
string | null

Twilio region where the SIP trunk is configured. Affects call routing latency and regional compliance. Common values: us1, us2, ie1, de1, au1, jp1, br1, sg1.

​
supportsCallTransfer
boolean

Whether the provider supports call transfers. When enabled, allows warm and cold transfers during calls. Requires proper Twilio account configuration and sufficient permissions.