Public API v1
Public API v1

Get playable audio URL

Returns a time-limited presigned URL for the interview recording. The URL expires after 1 hour. Use with evidence timestamps from the scorecard (start_seconds, end_seconds) to seek to specific moments.

Example: if evidence shows start_seconds=872.3, open the URL and seek to 14:32.

Clips. Pass start and end (seconds) to get a URL for just that window — audio-only, cut server-side, cached, same one-hour life — instead of downloading the whole recording to play twenty seconds of it. Windows up to three minutes.

get/api/public/v1/interviews/{interview_id}/audio

Request

  • Base URL: https://api.thebetterhire.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.thebetterhire.ai/api/public/v1/interviews/{interview_id}/audio
  • Auth: HTTP bearer

Path parameters

interview_idstring required

Query parameters

startnumber nullable

Clip start, in seconds. Requires end.

endnumber nullable

Clip end, in seconds. Requires start.

formatstring

For a clip: audio (default, an .m4a of the window) or video (a small .mp4 of the window, scaled down, for showing the candidate's face). Needs start and end.

Response

Successful Response

urlstring required

Time-limited URL to the interview recording. Open in any browser or audio player. Use with evidence timestamps (start_seconds, end_seconds) from the scorecard to seek to specific moments.

expires_ininteger required

Seconds until the URL expires.

duration_secondsinteger nullable

Total recording duration in seconds, if known.

Example response

{
  "url": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=...",
  "expires_in": 3600,
  "duration_seconds": 2340
}

Changes

No recorded changes to this operation across all 1 revision of this API.