tl;dv

tl;dv Meetings API

List, retrieve, import and download meetings

GitHub OpenAPI

Operations 4

GET /v1alpha1/meetings List meetings #
POST /v1alpha1/meetings/import Import a meeting #
GET /v1alpha1/meetings/{meetingId} Retrieve a meeting #
GET /v1alpha1/meetings/{meetingId}/download Download a meeting recording #

Documentation

📖
Authentication
https://artifacts.apis.io/tl-dv/authentication/tl-dv-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/tl-dv/openapi/tl-dv-meetings-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/tl-dv/asyncapi/tl-dv-webhooks.yml

Other Resources

🔗
Webhooks
https://artifacts.apis.io/tl-dv/asyncapi/tl-dv-webhooks.yml
🔗
Conventions
https://artifacts.apis.io/tl-dv/conventions/tl-dv-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/tl-dv/errors/tl-dv-problem-types.yml
🔗
Lifecycle
https://artifacts.apis.io/tl-dv/lifecycle/tl-dv-lifecycle.yml
🔗
DataModel
https://artifacts.apis.io/tl-dv/data-model/tl-dv-data-model.yml
🔗
Conformance
https://artifacts.apis.io/tl-dv/conformance/tl-dv-conformance.yml
🔗
APIsJSON
https://artifacts.apis.io/tl-dv/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tl-dv:tl-dv-meetings-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tl-dv-meetings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: tl;dv Meetings API
  version: v1alpha1
  description: Public API for tl;dv, the AI meeting notetaker for Zoom, Google Meet and Microsoft Teams. Programmatic access to recorded meetings, transcripts and AI-generated notes, plus meeting import and webhook event delivery.
  contact:
    name: tl;dv Developer Support
    email: dev@tldv.io
    url: https://doc.tldv.io
  x-apievangelist-generated: true
servers:
- url: https://pasta.tldv.io
  description: Production
security:
- ApiKeyAuth: []
tags:
- name: Meetings
  description: List, retrieve, import and download meetings
paths:
  /v1alpha1/meetings:
    get:
      operationId: getMeetings
      summary: List meetings
      description: Returns a paginated list of meetings for the authenticated account.
      tags:
      - Meetings
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
        description: Page number of results to return.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Number of results per page.
      - name: meetingType
        in: query
        required: false
        schema:
          type: string
          enum:
          - internal
          - external
        description: Filter meetings by type.
      responses:
        '200':
          description: A paginated list of meetings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingList'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/ServerError'
  /v1alpha1/meetings/import:
    post:
      operationId: importMeeting
      summary: Import a meeting
      description: Import a meeting recording from an external URL for processing.
      tags:
      - Meetings
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImportMeetingRequest'
      responses:
        '200':
          description: Import job accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportMeetingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/ServerError'
  /v1alpha1/meetings/{meetingId}:
    get:
      operationId: getMeeting
      summary: Retrieve a meeting
      description: Retrieve a single meeting by its identifier.
      tags:
      - Meetings
      parameters:
      - $ref: '#/components/parameters/MeetingId'
      responses:
        '200':
          description: The requested meeting.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Meeting'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
  /v1alpha1/meetings/{meetingId}/download:
    get:
      operationId: downloadRecording
      summary: Download a meeting recording
      description: Returns a 302 redirect whose Location header points at a signed URL for the meeting recording file.
      tags:
      - Meetings
      parameters:
      - $ref: '#/components/parameters/MeetingId'
      responses:
        '302':
          description: Redirect to the signed recording URL.
          headers:
            Location:
              schema:
                type: string
                format: uri
              description: Signed URL of the recording file.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    MeetingList:
      type: object
      properties:
        page:
          type: integer
        pages:
          type: integer
        total:
          type: integer
        pageSize:
          type: integer
        results:
          type: array
          items:
            $ref: '#/components/schemas/Meeting'
    ValidationError:
      type: object
      properties:
        message:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              property:
                type: string
              constraints:
                type: object
                additionalProperties:
                  type: string
    Person:
      type: object
      properties:
        name:
          type: string
        email:
          type: string
          format: email
    ImportMeetingRequest:
      type: object
      properties:
        url:
          type: string
          format: uri
          description: URL of the recording to import.
        name:
          type: string
        happenedAt:
          type: string
          format: date-time
    Meeting:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        happenedAt:
          type: string
          format: date-time
        url:
          type: string
          format: uri
        duration:
          type: number
          description: Meeting duration in seconds.
        organizer:
          $ref: '#/components/schemas/Person'
        invitees:
          type: array
          items:
            $ref: '#/components/schemas/Person'
        template:
          type: string
        extraProperties:
          type: object
          properties:
            conferenceId:
              type: string
    ImportMeetingResponse:
      type: object
      properties:
        success:
          type: boolean
        jobId:
          type: string
        message:
          type: string
    Error:
      type: object
      properties:
        name:
          type: string
        message:
          type: string
  responses:
    BadRequest:
      description: Validation error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationError'
    ServerError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The API key is not permitted to access this resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    MeetingId:
      name: meetingId
      in: path
      required: true
      schema:
        type: string
      description: Unique identifier of the meeting.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API key issued from tl;dv account settings (https://tldv.io/app/settings/personal-settings/api-keys), sent on the x-api-key request header.

        '