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

> Retrieves SIP protocol traces for a specific call, identified by its blackbox call ID.
The system resolves the internal server job ID from the call record and fetches
SIP signaling data including INVITE, ACK, BYE messages and their
raw content, useful for debugging telephony connectivity issues.



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}/sip-traces
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/calls/{callId}/sip-traces:
    get:
      tags:
        - Calls
      summary: Get SIP traces
      description: >-
        Retrieves SIP protocol traces for a specific call, identified by its
        blackbox call ID.

        The system resolves the internal server job ID from the call record and
        fetches

        SIP signaling data including INVITE, ACK, BYE messages and their

        raw content, useful for debugging telephony connectivity issues.
      parameters:
        - name: callId
          in: path
          description: Blackbox call identifier
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Returns SIP trace groups successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SipTraceGroupDto'
        '401':
          description: Authentication failed or API key is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Call not found or no SIP traces available
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Server error occurred while fetching SIP traces
components:
  schemas:
    SipTraceGroupDto:
      type: object
      properties:
        callId:
          type: string
          description: SIP Call-ID header value that uniquely identifies this SIP dialog.
          nullable: true
        direction:
          type: string
          description: >-
            Call direction: "DirectionOut" for outbound, "DirectionIn" for
            inbound.
          nullable: true
        messages:
          type: array
          items:
            $ref: '#/components/schemas/SipTraceMessageDto'
          description: Ordered list of SIP messages exchanged during this call.
          nullable: true
      additionalProperties: false
      description: Group of SIP trace messages belonging to a single SIP call/dialog.
    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: {}
    SipTraceMessageDto:
      type: object
      properties:
        timestamp:
          type: string
          description: ISO 8601 timestamp of when the SIP message was sent or received.
          nullable: true
        method:
          type: string
          description: SIP method name (e.g., INVITE, ACK, BYE, CANCEL, OPTIONS).
          nullable: true
        statusCode:
          type: integer
          description: >-
            SIP response status code (e.g., 200, 401, 486). Null for SIP
            requests.
          format: int32
          nullable: true
        sourceIp:
          type: string
          description: Source IP address of the message sender.
          nullable: true
        sourcePort:
          type: integer
          description: Source port of the message sender.
          format: int32
        destIp:
          type: string
          description: Destination IP address of the message receiver.
          nullable: true
        destPort:
          type: integer
          description: Destination port of the message receiver.
          format: int32
        protocol:
          type: string
          description: Transport protocol used (e.g., UDP, TCP, TLS).
          nullable: true
        rawMessage:
          type: string
          description: Full raw SIP message content including headers and body.
          nullable: true
      additionalProperties: false
      description: Individual SIP protocol message within a trace group.

````