# Transcripts

Transcribe call recordings and meetings, view results, and access AI coaching. Use POST /transcripts/transcribe to kick off transcription from any audio URL. Coaching results are under /transcripts/coaching.

**Base URL:** `https://api.trustpager.com/functions/v1/api/v1`

## Endpoints

### POST /transcripts/transcribe

Kick off an audio transcription via TrustPager AI (Whisper). Pass a publicly fetchable recording URL or a Twilio recording URL plus recording_auth. The transcript lands in /inbox/phone-calls (type=phone_call or legacy alias type=call) or /inbox/meetings (type=meeting) and auto-links to contacts and opportunities matching participant email or phone number. Files over 25 MB are automatically chunked at MP3 frame boundaries. Requires transcripts:write scope. Costs 12 credits per minute.

**Scopes:** `transcripts:write` — [full detail](./transcripts/post-transcripts-transcribe.md)

### GET /transcripts

List all transcripts with optional filters for type, source, transcription_status, date range, participant email, or booking_id. Each record includes transcription_status (not_applicable, pending, complete) and booking_id (populated for TrustPager Notetaker recordings, links the transcript to a scheduling_bookings row). Filter type=phone_call to see browser softphone call transcripts.

**Scopes:** `calls:read` — [full detail](./transcripts/get-transcripts.md)

### GET /transcripts/:id

Retrieve a transcript with full text, participants, linked entities, and transcription_status. Check transcription_status=complete before using transcript_text for AI analysis.

**Scopes:** `calls:read` — [full detail](./transcripts/get-transcripts-id.md)

### DELETE /transcripts/:id

Delete a transcript and its linked entity relationships.

**Scopes:** `calls:read` — [full detail](./transcripts/delete-transcripts-id.md)

### GET /transcripts/:id/coaching

Get all coaching results for a specific transcript.

**Scopes:** `calls:read` — [full detail](./transcripts/get-transcripts-id-coaching.md)

### GET /transcripts/coaching

List all AI coaching results across all transcripts. Filter by framework, source_type, or team_member_id.

**Scopes:** `calls:read` — [full detail](./transcripts/get-transcripts-coaching.md)

### GET /transcripts/coaching/:id

Retrieve a specific AI coaching result by ID.

**Scopes:** `calls:read` — [full detail](./transcripts/get-transcripts-coaching-id.md)