> ## 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 SIP credentials

> Retrieves all SIP credentials for your organization with support for pagination and search.
SIP credentials store authentication information for connecting to SIP trunk providers,
including server addresses, usernames, passwords, and optional TLS settings.



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials
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/sip-credentials:
    get:
      tags:
        - SipCredentials
      summary: List SIP credentials
      description: >-
        Retrieves all SIP credentials for your organization with support for
        pagination and search.

        SIP credentials store authentication information for connecting to SIP
        trunk providers,

        including server addresses, usernames, passwords, and optional TLS
        settings.
      parameters:
        - name: search
          in: query
          description: Search by domain or auth user (partial match)
          schema:
            type: string
        - name: skip
          in: query
          description: Number of items to skip
          schema:
            maximum: 2147483647
            minimum: 0
            type: integer
            format: int32
            default: 0
        - name: take
          in: query
          description: Number of items to return
          schema:
            maximum: 1000
            minimum: 1
            type: integer
            format: int32
            default: 20
      responses:
        '200':
          description: Returns SIP credentials successfully
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/SipCredentialsResponseDtoPaginatedResponse
        '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'
        '500':
          description: Server error occurred while retrieving SIP credentials
components:
  schemas:
    SipCredentialsResponseDtoPaginatedResponse:
      required:
        - items
        - skip
        - take
        - totalCount
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SipCredentialsResponseDto'
          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: {}
    SipCredentialsResponseDto:
      required:
        - createdTime
        - id
        - lastUpdateTime
        - orgId
        - server
        - source
        - transport
      type: object
      properties:
        id:
          type: string
          description: >-
            Unique identifier for these SIP credentials. Use this ID when
            configuring phone numbers or referencing these credentials in agent
            configurations.
          format: uuid
        orgId:
          minLength: 1
          type: string
          description: >-
            Organization that owns these SIP credentials. Used for access
            control and resource isolation.
        domain:
          type: string
          description: >-
            SIP domain for authentication realm as defined in RFC 3261. Used by
            some SIP providers as the authentication domain.
          nullable: true
        server:
          minLength: 1
          type: string
          description: >-
            SIP server hostname or IP address with optional port, following RFC
            3261 specifications. Specifies where to send SIP registration and
            call signaling.
        authUser:
          type: string
          description: >-
            Authentication user identifier as defined in RFC 3261. Different
            providers may call this "username", "account", "user ID", or other
            names.
          nullable: true
        authPassword:
          type: string
          description: Password for SIP authentication as defined in RFC 3261.
          nullable: true
        transport:
          allOf:
            - $ref: '#/components/schemas/TransportProtocol'
          description: >-
            Transport protocol used for SIP signaling. Indicates whether this
            trunk uses UDP, TCP, or TLS for communication.
        description:
          type: string
          description: >-
            Human-readable description of these credentials. Helps identify
            which SIP provider or trunk these credentials represent.
          nullable: true
        cpsLimit:
          type: integer
          description: >-
            Maximum calls per second allowed through this SIP trunk. Controls
            call pacing to prevent exceeding provider rate limits.
          format: int32
          nullable: true
        cpsKey:
          type: string
          description: >-
            Shared rate limiting key for grouping multiple credentials under a
            common CPS limit. When set, multiple trunks with the same key share
            the rate limit.
          nullable: true
        source:
          allOf:
            - $ref: '#/components/schemas/CredentialSource'
          description: >-
            Indicates how these credentials were created. 'manual' means
            user-entered credentials, 'provider' means automatically configured
            by a connected VoIP provider integration (such as Twilio).
        providerId:
          type: string
          description: >-
            Reference to the VoIP provider that manages these credentials.
            Present only for provider-managed credentials where Source is
            'provider'. When present, the provider handles credential lifecycle
            and configuration.
          format: uuid
          nullable: true
        createdTime:
          type: string
          description: Timestamp when these credentials were originally created.
          format: date-time
        lastUpdateTime:
          type: string
          description: >-
            Timestamp when these credentials were last modified. Updates when
            configuration changes are made.
          format: date-time
      additionalProperties: false
      description: >-
        SIP trunk credentials information including connection settings,
        authentication, rate limiting, and metadata. Contains all configuration
        needed to connect to a SIP provider for making and receiving calls.
    TransportProtocol:
      enum:
        - udp
        - tcp
        - tls
      type: string
      description: >-
        Transport protocol for SIP communication. Defines how SIP messages are
        transmitted over the network.
    CredentialSource:
      enum:
        - manual
        - provider
      type: string
      description: >-
        Source of provider credentials. Indicates how the credentials were
        obtained and configured.
  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

````