Get Call by ID

Retrieve a specific call by its unique identifier

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

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.

Request

id · string · required

The unique identifier of the call to retrieve

Authorization · string · required

Bearer token for API authentication

cURL

curl --request GET \
     --url https://api.credira.com/v1/calls/call_123456789 \
     --header 'Authorization: Bearer YOUR_API_KEY' \
     --header 'Content-Type: application/json'

Response

{
  "success": true,
  "data": {
    "id": "call_123456789",
    "invoice_id": "inv_987654321",
    "duration": 180,
    "status": "completed",
    "from": "[phone]",
    "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"
  }
}

Response

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid call ID format"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}

Response

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}

Response

{
  "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"
  }
}

Response

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Call not found"
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_123456789"
  }
}