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

fetch('https://blackbox.dasha.ai/api/v1/providers/{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
}

Path Parameters

​
id
string<uuid>
required

Provider identifier

Response

Returns provider successfully with provider-specific details

Base response DTO for VoIP provider integrations. Contains common provider information shared across all provider types including identification, verification status, and phone number counts. Uses polymorphic serialization with providerType discriminator to support different provider implementations.

​
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.