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

# Get Call by ID

> Retrieve a specific call by its unique identifier

Retrieve detailed information about a specific call using its unique identifier.

<Note>
  This endpoint provides more detailed information about a single call compared
  to the general calls endpoint. It's useful when you need specific call details
  or want to access call recordings and transcriptions.
</Note>

## Request

<ParamField path="id" type="string" required>
  The unique identifier of the call to retrieve
</ParamField>

<ParamField header="Authorization" type="string" required>
  Bearer token for API authentication
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
       --url https://api.credira.com/v1/calls/call_123456789 \
       --header 'Authorization: Bearer YOUR_API_KEY' \
       --header 'Content-Type: application/json'
  ```

  ```typescript TypeScript theme={null}
  const callId = "call_123456789";
  const response = await fetch(`https://api.credira.com/v1/calls/${callId}`, {
    method: "GET",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  });

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample status="200" summary="Success">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "id": "call_123456789",
      "invoice_id": "inv_987654321",
      "duration": 180,
      "status": "completed",
      "from": "+1234567890",
      "to": "+0987654321",
      "transcription_url": "https://api.credira.com/transcriptions/call_123456789.txt",
      "call_recording_url": "https://api.credira.com/recordings/call_123456789.mp3",
      "confidence_score": 0.95,
      "voice_agent_id": "agent_456789123",
      "timezone": "America/New_York",
      "account_id": "acc_789123456",
      "created_time": "2024-01-15T10:30:00Z",
      "updated_time": "2024-01-15T10:33:00Z",
      "start_time": "2024-01-15T10:30:00Z",
      "end_time": "2024-01-15T10:33:00Z",
      "call_type": "outbound",
      "cost": 0.15,
      "currency": "USD",
      "quality_score": 0.92,
      "sentiment_score": 0.75,
      "keywords": ["payment", "invoice", "overdue"],
      "summary": "Customer called regarding overdue invoice payment. Payment scheduled for next week.",
      "tags": ["payment-reminder", "customer-service"],
      "metadata": {
        "campaign_id": "camp_123",
        "customer_id": "cust_456",
        "department": "billing"
      }
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>

<ResponseExample status="400" summary="Bad Request">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_REQUEST",
      "message": "Invalid call ID format"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>

<ResponseExample status="401" summary="Unauthorized">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "UNAUTHORIZED",
      "message": "Invalid or missing API key"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>

<ResponseExample status="403" summary="Forbidden">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "FORBIDDEN",
      "message": "You don't have permission to access this call"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>

<ResponseExample status="404" summary="Not Found">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "NOT_FOUND",
      "message": "Call not found"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>