List meetings
Meetings in your library with title, date, duration, your role and folder, newest first.
GET https://cotlet.dev/api/v1/tldv/meetings
read
Lists meetings in your tl;dv library, newest first. Filter by a text query, a date range or a folder. Each item shows your role on the meeting (admin, editor or viewer), which decides what you can change. Pages hold up to 50 meetings; pass next_cursor back as cursor for the next page. A meeting still being processed shows status processing.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Text to find in meeting titles. |
| from date | date | Only meetings on or after this date. |
| to date | date | Only meetings on or before this date. |
| folder_id string | string | Only meetings in this folder, from list_folders. |
| limit integer | integer | 1 to 50. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/tldv/meetings \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("tldv", "list_meetings") const result = await cotlet.call('tldv', 'list_meetings'); cotlet call tldv list_meetings Example response
{
"meetings": [
{
"meeting_id": "mt_4f21a9",
"title": "Acme discovery call",
"started_at": "2026-10-15T14:00:00Z",
"duration_minutes": 42,
"organizer": "You",
"role": "admin",
"participants": 3,
"folder": null,
"status": "ready"
}
],
"next_cursor": "eyJvZmZzZXQiOjUwfQ"
}