How to get transcripts from the tl;dv API

Requirements

A plan with API access. tl;dv's API docs list API access when the meeting organizer is on Pro, Business or Enterprise; meetings organized by Free users are not exportable via the API, even if shared with you.
An API key from tldv.io/app/settings/personal-settings/api-keys.
Send the key in the x-api-key header.

Endpoints

Per tl;dv's API docs (base URL https://pasta.tldv.io/v1alpha1):

GET /meetings?page=1&pageSize=50&from=&to=
  → { page, pages, total, pageSize, results: [ { id, name, happenedAt, ... } ] }

GET /meetings/{meetingId}/transcript
  → { data: [ { speaker, text, startTime, endTime } ] }

A minimal loop

page = 1
repeat:
  list = GET /meetings?page={page}&pageSize=50
  for m in list.results:
    t = GET /meetings/{m.id}/transcript
    save(m, t.data)
  page += 1
until page > list.pages

Practical notes: back off and retry on HTTP 429 or 5xx; a 404 on a transcript usually means there is no completed transcript yet; the API is labeled alpha, so re-check the docs for changes.

Skip the code

MinuteHaul runs this loop in your browser and packages the result:

transcripts/: one Markdown file per meeting (title, date, organizer, participants, tl;dv link, speaker-labeled and timestamped transcript)
index.csv: one row per meeting (id, title, date, duration, organizer, participants, file, status)
all-transcripts.txt (optional): every transcript in one text file for ChatGPT, Claude or NotebookLM, split into parts of about 400k words if needed
all.jsonl (optional): raw meeting metadata plus transcript segments, one meeting per line

Each Markdown file can also include tl;dv's AI notes for that meeting when the API returns them.

Pre-order MinuteHaul: $29 one-time or try it free on your 10 most recent meetings

Pre-order: the exporter ships within 7 days of your purchase. If it is not delivered to you in that time, you get an automatic full refund. Requires a paid tl;dv plan with API access: per tl;dv's API docs, the meeting organizer must be on Pro, Business or Enterprise.

FAQ

Which tl;dv plan includes API access? tl;dv's API docs list API access for meetings whose organizer is on Pro, Business or Enterprise. Meetings organized by Free users can be viewed if shared but not exported via the API.

How do I authenticate with the tl;dv API? Send your API key in the x-api-key request header.

What does a transcript response contain? A data array of segments, each with speaker, text, startTime and endTime.

Is the tl;dv API stable? It is versioned v1alpha1, so treat it as alpha and check tl;dv's docs for changes.

Related guides

Last checked: Oct 17, 2026. tl;dv features and plans change; verify against tl;dv's own help center before relying on details here.