Call Details

Updated on: October 9, 2025
Purpose: Retrieve detailed information about a specific call, including its status, duration, timestamps, and agent details.

---

Endpoint

GET https://ai.salpre.com/api/gateway/v1/call/{id}

Example:

GET https://ai.salpre.com/api/gateway/v1/call/874

Authentication:
Every request must include your Account Secret Key in the header.

account-secret-key: YOUR_API_KEY

Keep your Account Secret Key private. Use server-side calls whenever possible.

---

Path parameter

Name	Type	Required	Description
id	integer	Yes	The unique call ID you want to retrieve. Example: 874.

---

Code samples

cURL (Bash)

curl --location --request GET 'https://ai.salpre.com/api/gateway/v1/call/874' \
--header 'account-secret-key: YOUR_API_KEY'

JavaScript (Fetch)

const myHeaders = new Headers();
myHeaders.append("account-secret-key", "YOUR_API_KEY");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://ai.salpre.com/api/gateway/v1/call/874", requestOptions)
  .then(response => response.json())
  .then(result => console.log(result))
  .catch(error => console.log("error", error));

---

Example response

{
  "status": "success",
  "data": {
    "call_id": "874",
    "status": "completed",
    "direction": "outbound",
    "agent_id": 5,
    "from": "salprebox:EXAMPLE_SERIAL_NO",
    "to": "+905xxxxxxxxx",
    "started_at": "2025-10-09T10:41:22Z",
    "ended_at": "2025-10-09T10:44:04Z",
    "duration_sec": 162,
    "audio_record_url": "https://cdn.salpre.com/recordings/call_874.mp3",
    "transcript": "Hello, this is your appointment reminder from Luxen Clinic...",
    "variables": {
      "customer_name": "Ahmet",
      "appointment_time": "14:30"
    }
  }
}

---

Error responses

Missing or invalid authentication key

{
  "status": "error",
  "message": "Unauthorized. Missing or invalid account-secret-key"
}

Invalid or unknown call ID

{
  "status": "error",
  "message": "Call not found. Please check the call ID."
}

---

Notes & best practices

• Use the call ID returned from the List Calls or Make Call endpoints to retrieve its details.
• Audio recordings (if available) are stored temporarily. Download them if you need to archive calls.
• Transcripts are included only if your account’s agent had transcription enabled for that call.
• Time fields are returned in UTC ISO 8601 format.