Get call

GET

calls

{callId}

cURL

curl --request GET \
  --url https://api.attent.app/v1/calls/{callId} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.attent.app/v1/calls/{callId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.attent.app/v1/calls/{callId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.attent.app/v1/calls/{callId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.attent.app/v1/calls/{callId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "leadId": "c4f23a1b-d8e5-4f67-90c1-2a5b8d3e9f7c",
  "direction": "OUTBOUND",
  "callStatus": "COMPLETE",
  "durationSeconds": 145,
  "createdAt": "2026-06-15T14:30:00.000Z",
  "updatedAt": "2026-06-15T14:32:25.000Z",
  "summary": "Customer inquired about pricing and requested a follow-up meeting.",
  "transcript": [
    {
      "role": "assistant",
      "content": "Hi, this is Apten calling about your inquiry.",
      "startTime": "2026-06-15T14:30:01.000Z",
      "endTime": "2026-06-15T14:30:05.000Z"
    },
    {
      "role": "user",
      "content": "Yes, I had some questions about pricing.",
      "startTime": "2026-06-15T14:30:06.000Z",
      "endTime": "2026-06-15T14:30:10.000Z"
    }
  ],
  "isTransfer": false
}

{
  "message": "Invalid format for field: phone"
}

{
  "message": "Unauthorized"
}

{
  "message": "Forbidden"
}

{
  "message": "Resource not found: Call"
}

{
  "message": "Internal Server Error"
}

When to use this endpoint

Call webhooks include data.callId and basic metadata (direction, duration, transfer flags). CALL events from GET /leads/{leadId}/events carry the same metadata, and the event’s top-level id field is the call ID. Neither includes the full transcript or every transfer detail. Use GET /calls/{callId} to enrich a call after a webhook fires — for example, to pull the AI-generated summary and full transcript into your CRM or data warehouse. After a transfer, transferStatus and transferFailureCode match the final outcome in call.completed and the dedicated transfer webhooks. For failed transfers, transferInitiatedAt records when Apten began the transfer attempt and transferWaitDurationSeconds records the elapsed time until Apten recorded the terminal failure. midCallTransferDuration is different: it measures time connected to a transfer recipient after a successful mid-call transfer.

Recordings

This endpoint never returns a recording URL. To download a completed recording, use GET /calls/{callId}/recording. The download URL is temporary; store the downloaded file, not the URL.

Webchat calls

For webchat voice calls, the response includes sessionId instead of leadId.

Authorizations

x-api-key

string

header

required

Path Parameters

callId

string

required

Call ID from data.callId (webhooks) or the event id (CALL events).

Response

Call details fetched successfully.

Full call record returned by GET /calls/{callId}.

string

required

Stable unique identifier for the call.

direction

enum<string>

required

Available options:

INBOUND,

OUTBOUND

callStatus

string

required

Current or final status of the call (e.g. COMPLETE, NO_ANSWER, IN_PROGRESS).

durationSeconds

integer

required

Length of the call in seconds.

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

transcript

object[]

required

Ordered transcript turns. Empty array if no transcript is stored yet.

Show child attributes

leadId

string

The lead (room) this call belongs to. Absent for webchat-only calls.

sessionId

string

The webchat session ID. Present for webchat voice calls instead of leadId.

summary

string

AI-generated summary of the conversation. Present after the call is processed; may be absent immediately after a terminal webhook if processing is still in flight.

isTransfer

boolean

true if this was a transfer to a human agent.

midCallTransfer

boolean

true if a transfer happened mid-call.

hasVoicemail

boolean

true if the call left a voicemail.

transferNumber

string

E.164 number the call was transferred to, if applicable.

fallbackTransferNumber

string

Fallback transfer number used when the primary transfer failed.

transferAnswerStatus

enum<string>

Available options:

answered,

no_answer,

pending

transferAnsweredBy

enum<string>

Available options:

human,

machine_start,

machine_end_beep,

machine_end_silence,

machine_end_other,

unknown

transferFallbackAttempted

boolean

transferFallbackAnswerStatus

enum<string>

Available options:

answered,

no_answer,

pending

transferFallbackAnsweredBy

enum<string>

Available options:

human,

machine_start,

machine_end_beep,

machine_end_silence,

machine_end_other,

unknown

midCallTransferDuration

integer

Seconds the lead was connected to a transfer recipient during a mid-call transfer.

endedBy

enum<string>

Who ended the call. Only populated for warm transfers (where the lead is bridged into a live conference with a human agent); omitted for cold transfers and ordinary calls. LEAD — the lead hung up. AGENT — the human agent hung up. UNKNOWN — the call ended but the hangup could not be attributed to either party.

Available options:

LEAD,

AGENT,

UNKNOWN

transferInitiatedAt

string<date-time>

When Apten began the transfer attempt and the lead began waiting. Absent if no transfer was started.

agentConnected

boolean

true if a warm-transfer agent was bridged to the lead.

transferFailureCode

enum<string>

Why the transfer failed after the agent was dialed. Absent if the transfer connected or was never started.

Available options:

agent_not_connected,

lead_disconnected

transferWaitDurationSeconds

integer

Seconds from transfer initiation until Apten recorded the terminal failure, rounded to the nearest whole second. Present when failure timing is available.

Required range: x >= 0

transferStatus

enum<string>

Terminal transfer outcome after an agent was dialed. Absent if no transfer was started.

Available options:

connected,

failed

aiCallWithoutHumanResponse

boolean

true if the lead never spoke during an AI-initiated call.

isFollowUp

boolean

isAiInitiated

boolean

hitCallScreening

boolean

reachedHumanAfterScreening

boolean

isForward

boolean

cURL

curl --request GET \
  --url https://api.attent.app/v1/calls/{callId} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.attent.app/v1/calls/{callId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.attent.app/v1/calls/{callId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.attent.app/v1/calls/{callId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.attent.app/v1/calls/{callId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "leadId": "c4f23a1b-d8e5-4f67-90c1-2a5b8d3e9f7c",
  "direction": "OUTBOUND",
  "callStatus": "COMPLETE",
  "durationSeconds": 145,
  "createdAt": "2026-06-15T14:30:00.000Z",
  "updatedAt": "2026-06-15T14:32:25.000Z",
  "summary": "Customer inquired about pricing and requested a follow-up meeting.",
  "transcript": [
    {
      "role": "assistant",
      "content": "Hi, this is Apten calling about your inquiry.",
      "startTime": "2026-06-15T14:30:01.000Z",
      "endTime": "2026-06-15T14:30:05.000Z"
    },
    {
      "role": "user",
      "content": "Yes, I had some questions about pricing.",
      "startTime": "2026-06-15T14:30:06.000Z",
      "endTime": "2026-06-15T14:30:10.000Z"
    }
  ],
  "isTransfer": false
}

{
  "message": "Invalid format for field: phone"
}

{
  "message": "Unauthorized"
}

{
  "message": "Forbidden"
}

{
  "message": "Resource not found: Call"
}

{
  "message": "Internal Server Error"
}

API Reference

Leads

Calls

Tags

Usage

Do Not Contact

When to use this endpoint

Recordings

Webchat calls

Authorizations

Path Parameters

Response

​When to use this endpoint

​Recordings

​Webchat calls

Authorizations

Path Parameters

Response

When to use this endpoint

Recordings

Webchat calls