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

> Retrieves detailed information for a specific call including status, timestamps,
endpoint information, and additional data associated with the call.



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}
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/calls/{callId}:
    get:
      tags:
        - Calls
      summary: Get call
      description: >-
        Retrieves detailed information for a specific call including status,
        timestamps,

        endpoint information, and additional data associated with the call.
      parameters:
        - name: callId
          in: path
          description: Call identifier
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Returns the call details successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallResponseForEndedDto'
        '401':
          description: Authentication failed or API key is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Access denied to call resources
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Call with specified ID does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Server error occurred while retrieving call
components:
  schemas:
    CallResponseForEndedDto:
      required:
        - agentId
        - callId
        - endpoint
        - orgId
      type: object
      properties:
        callId:
          type: string
          description: Unique identifier of the completed call.
          nullable: true
        orgId:
          type: string
          description: Organization that owns this call.
          nullable: true
        agentId:
          type: string
          description: Agent that handled this call.
          nullable: true
        endpoint:
          type: string
          description: Phone number or SIP endpoint that was called.
          nullable: true
        status:
          allOf:
            - $ref: '#/components/schemas/CallStatus'
          description: >-
            Final status of the call. Typically Completed (successfully
            finished) or Failed (error occurred during the call).
        recordId:
          type: string
          description: >-
            Identifier for the call recording if recording was enabled. Use this
            ID to retrieve or download the audio recording of the conversation.
            Null if recording was not enabled or the recording is not yet
            available.
          nullable: true
        completedTime:
          type: string
          description: >-
            Timestamp when the call completed (ended or failed). Null if the
            call is still in progress or was never started.
          format: date-time
          nullable: true
        inspectorUrl:
          type: string
          description: >-
            URL to the call inspector interface for analyzing conversation flow,
            agent behavior, and call quality. Provides detailed debugging and
            analysis tools for understanding call execution. Null if inspector
            is not available for this call.
          nullable: true
      additionalProperties: false
      description: >-
        Information about a completed call including final status, recording,
        and inspection details. Used for post-call analysis, quality assurance,
        and retrieving conversation recordings.
    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: {}
    CallStatus:
      enum:
        - Unknown
        - Created
        - Pending
        - Queued
        - Completed
        - Failed
        - Canceled
        - Running
      type: string
      description: >-
        Current status of a call in its lifecycle. Tracks the call's progress
        from creation through completion or failure.
  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

````