Skip to main content

Voice Call Recordings

Use these endpoints to retrieve what was said on a verification call. Voice webhooks carry callId, hasRecording, and hasTranscript; call these endpoints with that callId when a flag is true. All three routes are read-only and scoped to a search. They only read your own tenant’s data.
Every route returns 404 when the search is not yours or does not exist, when the call does not belong to the search, and when the call has no recording or transcript. The cases are deliberately indistinguishable. Right after a webhook a call can 404 for a few seconds while its files are written; retry shortly.

Shared Path Parameters

string
required
Search ID (UUID).
string
Call ID from a voice webhook or from the calls list. Required on the transcript and recording routes. Treat it as opaque: new calls use a UUID, and older inbound calls keep a longer inbound-verification- identifier that still works here. Percent-encode it in the path.

List Calls

GET /background-check/v1/searches/{searchId}/calls
Calls are oldest first. startedAt is when the call connected (null for an outbound call nobody answered), endedAt is when either side hung up, and durationSeconds is the connected time in whole seconds (null when startedAt is). Outbound calls that never connected are listed with both flags false.

Get Transcript

GET /background-check/v1/searches/{searchId}/calls/{callId}/transcript
agent is SNH AI’s voice agent; caller is the other person on the line in either direction. Text is returned as transcribed, the same content as the recording, so it can include personal data about the applicant; handle it like the recording. An outbound transcript contains only what the other person said after the recording notice. redacted is true when the original transcript has been sealed under the retention policy below and the turns come from its redacted copy. GET /background-check/v1/searches/{searchId}/calls/{callId}/recording
Each request mints a new signed link. It is a plain HTTPS GET that works for anyone holding it until expiresAt (15 minutes by default, never more than 60). Download the file, then discard the link. Recordings and transcripts are kept under SNH AI’s voice data retention policy. Once a recording is sealed (encrypted for audit use only) or deleted, the recording route returns 404. Once an original transcript is sealed, the transcript route returns its redacted copy, or 404 if there is none.