> ## Documentation Index > Fetch the complete documentation index at: https://blackbox.dasha.ai/llms.txt > Use this file to discover all available pages before exploring further. # List providers > Retrieves all VoIP provider integrations for your organization with support for pagination. Returns polymorphic responses with provider-specific details based on the provider type. The providerType field acts as a discriminator to identify the specific provider implementation. ## OpenAPI ````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers openapi: 3.0.4 info: title: Dasha BlackBox Agent API description: API for managing AI agents and calls contact: name: DashaAI Team email: support@dasha.ai version: v1 servers: - url: https://blackbox.dasha.ai description: Dasha BlackBox Agent API security: - ApiKey: [] - OAuth: [] tags: - name: ActivityLogs - name: Agents - name: AgentTestCases - name: CallResults - name: Calls - name: Chats - name: Copilot - name: CustomerData - name: Mcp - name: Media - name: Misc - name: PronunciationDictionaries - name: Providers - name: SipAliases - name: SipCredentials - name: SipPhoneNumbers - name: TextChat - name: TwilioProvider - name: Voice - name: WebhookTest - name: WebIntegrations - name: WebSocket description: WebSocket endpoints for real-time communication paths: /api/v1/providers: get: tags: - Providers summary: List providers description: >- Retrieves all VoIP provider integrations for your organization with support for pagination. Returns polymorphic responses with provider-specific details based on the provider type. The providerType field acts as a discriminator to identify the specific provider implementation. parameters: - name: skip in: query description: Number of items to skip for pagination schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: take in: query description: Number of items to return (max 100) schema: maximum: 100 minimum: 1 type: integer format: int32 default: 20 responses: '200': description: Returns providers successfully with polymorphic serialization content: application/json: schema: $ref: '#/components/schemas/ProviderResponseDtoPaginatedResponse' '400': description: Invalid pagination parameters content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Authentication failed or API key is missing content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: Access denied to the requested resource content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '500': description: Server error occurred while retrieving providers components: schemas: ProviderResponseDtoPaginatedResponse: required: - items - skip - take - totalCount type: object properties: items: type: array items: oneOf: - $ref: '#/components/schemas/TwilioProviderResponseDto' description: >- 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. description: >- Items in the current page. Contains the subset of results for this page based on the Skip and Take parameters. totalCount: type: integer description: >- Total number of items available across all pages. Use this to calculate the total number of pages and build pagination controls. Represents the complete result set size regardless of pagination. format: int32 skip: type: integer description: >- Number of items skipped from the beginning of the result set to reach this page. For example, Skip=20 with Take=10 returns items 21-30. Use this to understand the current position in the overall result set. format: int32 take: type: integer description: >- Maximum number of items included in this page. Indicates the requested page size. The actual Items count may be less than Take on the last page or when fewer results are available. format: int32 additionalProperties: false description: >- Generic paginated response containing a subset of items along with pagination metadata. Enables efficient navigation through large datasets by returning data in manageable pages rather than loading all results at once. ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} TwilioProviderResponseDto: allOf: - $ref: '#/components/schemas/ProviderResponseDto' - required: - accountSid - providerType type: object properties: providerType: enum: - twilio type: string description: Type of VoIP provider. Always returns Twilio for this DTO. readOnly: true accountSid: minLength: 1 type: string description: >- Twilio Account SID. A unique identifier for the Twilio account associated with this provider. Format: AC[a-f0-9]{32} (e.g., ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx). trunkSid: type: string description: >- 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). nullable: true terminationUri: type: string description: >- SIP trunk termination URI configured for this provider. Used for routing outbound calls through Twilio. Format: sip:.pstn.twilio.com nullable: true region: type: string description: >- 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. nullable: true supportsCallTransfer: type: boolean description: >- Whether the provider supports call transfers. When enabled, allows warm and cold transfers during calls. Requires proper Twilio account configuration and sufficient permissions. additionalProperties: false description: >- 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. ProviderResponseDto: required: - name - providerType type: object properties: id: type: string description: Unique identifier for the provider integration. format: uuid name: type: string description: >- Display name for the provider integration. Used to identify the provider in the UI and API responses. nullable: true providerType: allOf: - $ref: '#/components/schemas/ProviderType' description: >- Type of VoIP provider. Determines the specific provider implementation and available features. Supported values: twilio, vonage, telnyx. readOnly: true verificationStatus: allOf: - $ref: '#/components/schemas/VerificationStatus' description: >- Current verification status of the provider credentials. Indicates the health and validity of the integration. Supported values: pending, verified, warning, failed. lastVerifiedAt: type: string description: >- Timestamp when the provider credentials were last verified. Null if verification has never been performed. format: date-time nullable: true phoneNumberCount: type: integer description: >- Total number of phone numbers currently imported and managed through this provider integration. format: int32 verificationDetails: type: array items: $ref: '#/components/schemas/VerificationCheckDto' description: >- Detailed results of the last verification. Contains individual check results with status, messages, and timestamps. Null if verification has never been performed. nullable: true additionalProperties: false description: >- 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. ProviderType: enum: - twilio - vonage - telnyx type: string description: >- Type of VoIP provider integration. Determines the specific provider implementation and API interactions. VerificationStatus: enum: - pending - verified - warning - failed type: string description: >- Status of provider credential verification. Indicates the current health and validity of the provider integration. VerificationCheckDto: required: - checkName - message type: object properties: checkName: type: string description: >- Name of the verification check that was performed. Common values: credentials, api_connectivity, sip_trunk, phone_numbers. nullable: true status: allOf: - $ref: '#/components/schemas/CheckStatus' description: >- Status indicating whether the check passed, failed, or raised a warning. Supported values: passed, failed, warning. message: type: string description: >- Human-readable message describing the check result. Provides context about what was verified and any issues encountered. nullable: true timestamp: type: string description: Timestamp when the check was performed. Recorded in UTC. format: date-time details: type: object additionalProperties: type: string description: >- Additional details about the check result as key-value pairs. Can contain provider-specific information such as error codes or configuration details. nullable: true additionalProperties: false description: >- DTO representing the result of an individual verification check for a provider. Contains details about what was checked, the outcome, and any additional context. CheckStatus: enum: - passed - failed - warning type: string description: >- Status of an individual verification check. Indicates whether a specific verification check passed, failed, or raised a warning. securitySchemes: ApiKey: type: http description: API Key Authentication (Bearer {key}) scheme: Bearer OAuth: type: oauth2 flows: implicit: authorizationUrl: https://auth.dasha.ai/connect/authorize scopes: platform_api: Platform API ````