Skip to main content
GET
cURL
Returns a call in the company associated with your API key. The id path parameter is the Finosu call UUID — the id returned by List All Calls — not a customer reference. Missing, deleted, or inaccessible calls return 404. recordingUrl is a fresh link valid for one hour; it is null when the call has no recording or when recording storage is temporarily unavailable, so refetch the call to refresh or retry the link.

Response fields

customerId is your external customer reference, falling back to the Finosu customer UUID when no reference is stored. timestamp is the call record’s creation time in ISO 8601. toPhoneNumber, transcript, recordingUrl, and timestamp can each be null when unavailable.

Invalid Identifier

An invalid call UUID returns HTTP 422 Unprocessable Content with a string detail. A valid UUID with no accessible matching record returns 404.

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string
required

ID of call to retrieve

Response

Call response

REST call detail returned by GET /calls/{id} and GET /calls/customer/{customerId}. This is not the outbound call webhook payload.

customerId
string
required

Your external customer reference, falling back to the Finosu customer UUID when no reference is stored.

toPhoneNumber
string | null

Called phone number, or null when unavailable.

transcript
string | null

Call transcript, or null when unavailable.

recordingUrl
string | null

Fresh one-hour recording URL, or null when unavailable.

timestamp
string | null

Call record creation time in ISO 8601 format, or null.