Skip to main content
GET
cURL
Returns the call object. FaceTime webhooks send this same object in data.

Status

cause is null while the call is live. After hangup it is dialer_hungup if you hang up, recipient_hungup if the remote party left, or another end reason.

Participants

participants is the current roster while the call is live. After the call ends it is whoever remained, not everyone who was ever on the call.

Media

link is a FaceTime Web URL, once Apple has created it. It is null during queued and ringing. Opening it joins as a web participant. webrtc is present while the call is active and null after it ends. webrtc.join is a URL that connects you as the Contiguity FaceTime Audio line. url, room, and token are the raw WebRTC credentials. duration is seconds of connected time. It stays null until the call ends.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

call_id
string
required

The call ID.

Example:

"call_ftaAbCdEfGhIjKlMnOpQrStUv"

Response

Get a FaceTime call

id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

timestamp
number
required
Example:

1790548280377

api_version
string
required
Example:

"v2026.9.27"

object
string
required
Example:

"response"

data
object
required