> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zudu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get call by ID

> Retrieves a call by ID (current behavior).

## Notes

* Returns full call data, not just status.


## OpenAPI

````yaml get /api/calls/{callId}
openapi: 3.0.3
info:
  title: Zudu API
  description: >-
    Comprehensive REST API for LiveKit Backend - Call Management, Agent
    Configuration, and Real-time Communication Services
  version: 1.0.0
  contact:
    name: Zudu AI Team
    url: https://zudu.ai
    email: support@zudu.ai
  license:
    name: Proprietary
    url: https://zudu.ai/license
servers:
  - url: https://api.zudu.ai
    description: Production (Customer-facing)
security:
  - apiKey: []
    apiSecret: []
tags:
  - name: Agent Management
    description: Create and manage AI agents
  - name: Call Data Management
    description: Call records and history
  - name: Customer API Keys
    description: Manage API keys
  - name: Post-Call Webhooks
    description: Webhook configuration
  - name: phone-number-controller
    description: Phone numbers
  - name: batch-call-controller
    description: Batch calls
  - name: MCP Server Management
    description: MCP servers
  - name: Knowledge Base Management
    description: Knowledge bases
  - name: Call Analysis
    description: Call analysis
paths:
  /api/calls/{callId}:
    get:
      tags:
        - Call Data Management
      summary: Get call by ID
      description: Retrieves detailed information about a specific call by its ID.
      operationId: getCallByCallId
      parameters:
        - name: callId
          in: path
          description: Unique identifier of the call
          required: true
          schema:
            type: string
          example: call_abc123
      responses:
        '200':
          description: Call retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResponse'
              example:
                message: Call retrieved successfully
                status: success
                error: null
                data:
                  id: 550e8400-e29b-41d4-a716-446655440000
                  agent_id: agent-123
                  call_id: call-456
                  organization_id: org-789
                  call_status: ONGOING
                  call_type: PHONE_CALL
                  direction: INBOUND
                  from_number: '+1234567890'
                  to_number: '+0987654321'
                  start_timestamp: 1703097600000
                  end_timestamp: null
                  call_duration: null
                  disconnection_reason: null
                  recording_url: https://storage.azure.com/recordings/call-456.mp4
                  public_log_url: https://api.example.com/logs/call-456
                  opt_out_sensitive_data_storage: false
                  metadata:
                    customer_id: cust-001
                    priority: high
                    campaign: summer-2024
                  events:
                    - timestamp: 1703097600000
                      event: Call created
                      session_time: 0
                      data: {}
                    - timestamp: 1703097630000
                      event: Call started - INBOUND
                      session_time: 0
                      data:
                        direction: INBOUND
                        from: '+1234567890'
                        to: '+0987654321'
                  transcript: Hello, thank you for calling. How can I help you today?
                  transcript_object:
                    - role: assistant
                      content: Hello, thank you for calling. How can I help you today?
                      timestamp: 1703097635000
                      words:
                        - word: Hello
                          start: 1703097635000
                          end: 1703097635500
                  transcript_with_tool_calls: []
                  latency:
                    e2e:
                      max: 450.2
                      min: 120.1
                      num: 15
                      p50: 250.5
                      p90: 380.8
                      p95: 420.3
                      p99: 445.1
                      values:
                        - 120.1
                        - 180.3
                        - 250.5
                        - 380.8
                        - 450.2
                    llm:
                      max: 180.5
                      min: 80.2
                      num: 8
                      p50: 125.3
                      p90: 160.1
                      p95: 170.8
                      p99: 178.2
                      values:
                        - 80.2
                        - 90.1
                        - 125.3
                        - 160.1
                        - 180.5
                  call_analysis: null
                  call_cost:
                    combined_cost: 0.15
                    product_costs:
                      - product: inbound_call
                        cost: 0.1
                        unit_price: 0.02
                      - product: llm_usage
                        cost: 0.05
                        unit_price: 0.001
                    total_duration_seconds: 300
                    total_duration_unit_price: 0.02
                    total_one_time_price: 0.05
                  telephony_identifier:
                    call_sid: CA1234567890abcdef1234567890abcdef
                    conference_sid: CF1234567890abcdef1234567890abcdef
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - apiKey: []
          apiSecret: []
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        message:
          type: string
        status:
          type: string
        error:
          type: string
        data:
          type: object
  responses:
    NotFound:
      description: Resource not found
    InternalServerError:
      description: Internal server error
  securitySchemes:
    apiKey:
      type: apiKey
      description: API Key for MCP server and external service authentication
      name: X-API-KEY
      in: header
    apiSecret:
      type: apiKey
      description: API Secret for MCP server and external service authentication
      name: X-API-SECRET
      in: header

````