Skip to main content
GET
Get Twilio provider

Twilio-Specific Response

This endpoint returns Twilio-specific configuration details not available in the generic provider endpoint:

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.