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

# Get SIP credential

> Retrieves a specific SIP credential by its unique identifier including
server configuration, authentication details, and associated phone numbers.



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials/{id}
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:
  - {}
  - {}
tags:
  - name: ActivityLogs
  - name: Agents
  - name: CallResults
  - name: Calls
  - name: Chats
  - 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/{id}:
    get:
      tags:
        - SipCredentials
      summary: Get SIP credential
      description: >-
        Retrieves a specific SIP credential by its unique identifier including

        server configuration, authentication details, and associated phone
        numbers.
      parameters:
        - name: id
          in: path
          description: Credential identifier
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Returns SIP credential successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SipCredentialsResponseDto'
        '401':
          description: Authentication failed or API key is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: SIP credential with specified ID does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Server error occurred while retrieving SIP credential
components:
  schemas:
    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.
    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: {}
    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.

````