Summarized from tl;dv's API docs (v1alpha1, checked Oct 17, 2026). The API is alpha; always confirm against the docs.
https://pasta.tldv.io/v1alpha1 (HTTPS only)x-api-key: YOUR_API_KEY| Param | Meaning |
|---|---|
query | Search text |
page | Page number, default 1 |
limit | Results per page, default 50, max 100. Total results can't exceed 10,000; narrow the date range if needed |
from, to | Date range |
onlyParticipated | Only meetings you participated in (default false) |
meetingType | internal or external (default both) |
Response: { page, pages, total, pageSize, results: [Meeting] }
| Field | Type |
|---|---|
id | string |
name | string |
happenedAt | date string |
url | link to the meeting in tl;dv |
duration | number (seconds) |
organizer | { name, email } |
invitees | [{ name, email }] |
template | string |
extraProperties | { conferenceId } |
phoneNumber, metadata | values set on import |
Single meeting: GET /meetings/{meetingId} returns the same object.
Returned only when the transcript is complete.
{ "id": "...", "meetingId": "...",
"data": [ { "speaker": "...", "text": "...", "startTime": 0, "endTime": 5 } ] }
{ "structuredNotes": [ { "segmentId", "timestamp", "text", "topicId" } ],
"markdownContent": "...",
"topics": [ { "id", "order", "title", "summary" } ] }
The older /highlights endpoint is deprecated in favor of /notes.
GET /meetings/{id}/download: redirects to a signed recording URL that expires after 6 hoursPOST /meetings/import: import media from a public URLGET /healthMeetingReady and TranscriptReady400 validation errors return { message, errors: [{ property, constraints }] }. Other errors (401, 403, 404, 500) return { name, message }.
Want the whole loop done for you? See how to pull transcripts from the API, or use MinuteHaul below.
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.
What is the tl;dv API base URL? https://pasta.tldv.io/v1alpha1, with the API key sent in the x-api-key header.
How many meetings can I list per page? Use the limit parameter: default 50, maximum 100. The total result set can't exceed 10,000, so narrow the date range if you need more.
Can I get tl;dv AI notes through the API? Yes. GET /meetings/{id}/notes returns structured notes, Markdown content and topics.
Which plans have API access? tl;dv's API docs list API access when the meeting organizer is on Pro, Business or Enterprise, and none for Free.
Last checked: Oct 17, 2026. tl;dv features and plans change; verify against tl;dv's own help center before relying on details here.