BigPanda Meetings & Transcripts API

openapi: 3.2.0
info:
  title: BigPanda Meetings & Transcripts API
  description: BigPanda Meetings & Transcripts operations, assembled verbatim from the OpenAPI fragments BigPanda publishes on its own API reference at https://api-docs.bigpanda.io/. Each operation carries x-source-url naming the exact provider page it was read from. BigPanda hosts each organization in a single data management region (US or EU); send requests to the base URL for your region.
  version: 1.0.0
  contact:
    name: BigPanda Support
    url: https://api-docs.bigpanda.io/
  license:
    name: Proprietary
    url: https://www.bigpanda.io/legal/
  x-provenance:
    method: searched
    source: https://api-docs.bigpanda.io/llms.txt
    harvested: '2026-09-04'
    assembly: 'Operations copied verbatim from the per-endpoint OpenAPI 3.0.1 fragments BigPanda publishes at https://api-docs.bigpanda.io/<endpoint>.md. Assembly-only normalizations: Apidog x-apidog security metadata stripped, securityScheme type "bearer" corrected to type http/scheme bearer, schema name collisions suffixed. No operation, parameter, schema or response was authored by API Evangelist.'
    operations: 4
servers:
- url: https://api.bigpanda.io
  description: US Region
- url: https://api.eu.bigpanda.io
  description: EU Region
tags:
- name: Meetings & Transcripts
paths:
  /generate:
    post:
      summary: Generate a transcript summary
      deprecated: false
      description: 'Generate a transcript summary by conferenceCallId or meetingUrl in the request body.


        > 🚧 **Authentication**

        >

        > All BigPanda APIs require Bearer Token Authorization in the call headers.

        >

        > This API uses the User API Key type of Authorization token.


        > ❗ **Rate limitations**

        >

        > To maintain quality of service, the Biggy API is limited to 100 requests per minute. Additional requests will return a 429 response code and the request will need to be retried.


        ## Required permissions


        To retrieve transcripts using this API, your account must have permission to execute the Transcribe a Meeting action plan. See the Manage Biggy Access Controls documentation for more information.


        ## Multiple matched meeting URLs


        If `meetingUrl` matches more than one of your organization''s conference call documents, the API uses the most recent match and returns a `matchedConferenceCallsCount` greater than 1.


        ## Transcript retention


        The Retrieve Transcripts API cannot retrieve any transcripts that are past the retention period set for your organization. See the Meeting Retention documentation for more information.'
      operationId: generate-summary
      tags:
      - Meetings & Transcripts
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                conferenceCallId:
                  type: string
                  description: Unique identifier of the conference call.
                  examples:
                  - 65f0c8f8d73b2b0012ab3456
                meetingUrl:
                  type: string
                  description: URL of the conference call meeting.
                  examples:
                  - https://meet.example.com/abc
                prompt:
                  type: string
                  description: Instructions for generating the call summary. Maximum 20,000 characters.
                  examples:
                  - Generate a concise summary geared towards an executive audience.
                includeRawTranscript:
                  type: boolean
                  description: Whether or not the raw transcript should be included in the response.
                  examples:
                  - false
                responseFormat:
                  type: string
                  description: Format the response should be returned in. One of `markdown` (default) or `plain-text`.
              x-apidog-orders:
              - conferenceCallId
              - meetingUrl
              - prompt
              - includeRawTranscript
              - responseFormat
              x-apidog-ignore-properties: []
            examples: {}
      responses:
        '201':
          x-apidog-ordering: 0
          description: '201'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generateatranscriptsummary201response'
          headers: {}
          x-apidog-name: ''
        '400':
          x-apidog-ordering: 1
          description: '400'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic400response'
          headers: {}
          x-apidog-name: ''
        '403':
          x-apidog-ordering: 2
          description: '403'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic403response'
          headers: {}
          x-apidog-name: ''
        '404':
          x-apidog-ordering: 3
          description: '404'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic404response'
          headers: {}
          x-apidog-name: ''
        '410':
          x-apidog-ordering: 4
          description: '410'
          content:
            application/json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: ''
      security:
      - BearerUser11: []
      x-publication-status: live
      x-run-in-apidog: https://app.apidog.com/web/project/1203004/apis/api-37769989-run
      x-source-url: https://api-docs.bigpanda.io/generate-a-transcript-summary-37769989e0.md
      x-source-page: Generate a transcript summary
  /meetings/join:
    post:
      summary: Invite Biggy to Join a Meeting
      deprecated: false
      description: 'Invite Biggy to join a meeting for transcription and summary purposes.


        > 🚧 **Authentication**

        >

        > All BigPanda APIs require Bearer Token Authorization in the call headers.

        >

        > This API uses the User API Key type of Authorization token.


        > ❗ **Rate limitations**

        >

        > To maintain quality of service, the Biggy API is limited to 100 requests per minute. Additional requests will return a 429 response code and the request will need to be retried.


        > 📘 **summaryDestination**

        >

        > In the summaryDestination field, click the downward facing arrow symbol (⌄) to select which platform you would like to send the meeting summary to. You can choose from MS Teams or Slack.

        >

        > When omitted, the bot still records and transcribes but does not post to any channel. The transcript is accessible via GET /transcripts endpoints.'
      operationId: join-a-meeting
      tags:
      - Meetings & Transcripts
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Biggy-meeting-object'
            examples: {}
      responses:
        '201':
          x-apidog-ordering: 0
          description: '201'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/joinameeting201response'
          headers: {}
          x-apidog-name: ''
        '409':
          x-apidog-ordering: 1
          description: '409'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/joinameeting409response'
          headers: {}
          x-apidog-name: ''
      security:
      - BearerUser11: []
      x-publication-status: live
      x-run-in-apidog: https://app.apidog.com/web/project/1203004/apis/api-37769988-run
      x-source-url: https://api-docs.bigpanda.io/invite-biggy-to-join-a-meeting-37769988e0.md
      x-source-page: Invite Biggy to Join a Meeting
  /transcripts:
    get:
      summary: List transcripts
      deprecated: false
      description: 'List all available meetings or calls that Biggy has transcribed for your organization, with pagination and filtering.


        > 🚧 **Authentication**

        >

        > All BigPanda APIs require Bearer Token Authorization in the call headers.

        >

        > This API uses the User API Key type of Authorization token.


        > ❗ **Rate limitations**

        >

        > To maintain quality of service, the Biggy API is limited to 100 requests per minute. Additional requests will return a 429 response code and the request will need to be retried.


        ## Required permissions


        To retrieve transcripts using this API, your account must have permission to execute the Transcribe a Meeting action plan. See the Manage Biggy Access Controls documentation for more information.


        ## Transcript retention


        The Retrieve Transcripts API cannot retrieve any transcripts that are past the retention period set for your organization. See the Meeting Retention documentation for more information.'
      operationId: retrieve-transcripts
      tags:
      - Meetings & Transcripts
      parameters:
      - name: page
        in: query
        description: The number of indexed pages to retrieve. Default is 1.
        required: false
        example: '1'
        schema:
          type: string
      - name: limit
        in: query
        description: Size of the page. Default is 20, maximum is 100.
        required: false
        example: '20'
        schema:
          type: string
      - name: search
        in: query
        description: Optional search string.
        required: false
        schema:
          type: string
      - name: platform
        in: query
        description: Filter by meeting platform.
        required: false
        example: Zoom
        schema:
          type: string
      - name: from
        in: query
        description: Include transcripts starting at this date/time in ISO format.
        required: false
        example: '2026-02-02T11:14:16.000Z'
        schema:
          type: string
      - name: to
        in: query
        description: Include transcripts up to this date/time in ISO format.
        required: false
        example: '2026-02-04T11:14:16.000Z'
        schema:
          type: string
      responses:
        '200':
          x-apidog-ordering: 0
          description: '200'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/retrievealltranscripts200response'
          headers: {}
          x-apidog-name: ''
        '400':
          x-apidog-ordering: 1
          description: '400'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic400response'
          headers: {}
          x-apidog-name: ''
        '403':
          x-apidog-ordering: 2
          description: '403'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic403response'
          headers: {}
          x-apidog-name: ''
        '404':
          x-apidog-ordering: 3
          description: '404'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic404response'
          headers: {}
          x-apidog-name: ''
        '410':
          x-apidog-ordering: 4
          description: '410'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/transcripts410response'
          headers: {}
          x-apidog-name: ''
      security:
      - BearerUser11: []
      x-publication-status: live
      x-run-in-apidog: https://app.apidog.com/web/project/1203004/apis/api-37769990-run
      x-source-url: https://api-docs.bigpanda.io/list-transcripts-37769990e0.md
      x-source-page: List transcripts
  /transcripts/raw:
    get:
      summary: Retrieve raw transcript
      deprecated: false
      description: 'Retrieve a raw transcript by conference call ID or meeting URL query parameter.


        If meetingUrl matches multiple calls, the most recent is used.


        Transcripts are returned as normalized text with the spoken transcript and chat interwoven chronologically.


        > 🚧 **Authentication**

        >

        > All BigPanda APIs require Bearer Token Authorization in the call headers.

        >

        > This API uses the User API Key type of Authorization token.


        > ❗ **Character limit**

        >

        > Transcripts are capped at 1,000,000 characters. If the transcript exceeds the limit, the API truncates it and sets the `transcriptTruncated` field to true`.


        > ❗ **Rate limitations**

        >

        > To maintain quality of service, the Biggy API is limited to 100 requests per minute. Additional requests will return a 429 response code and the request will need to be retried.


        ## Required permissions


        To retrieve transcripts using this API, your account must have permission to execute the Transcribe a Meeting action plan. See the Manage Biggy Access Controls documentation for more information.


        ## Transcript retention


        The Retrieve Transcripts API cannot retrieve any transcripts that are past the retention period set for your organization. See the Meeting Retention documentation for more information.'
      operationId: retrieve-raw-transcript
      tags:
      - Meetings & Transcripts
      parameters:
      - name: conferenceCallId
        in: query
        description: Unique identifier of the conference call.
        required: false
        example: 65f0c8f8d73b2b0012ab3456
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                meetingUrl:
                  type: string
                  description: URL of the meeting.
                  examples:
                  - https://meet.example.com/abc
              x-apidog-orders:
              - meetingUrl
              x-apidog-ignore-properties: []
            examples: {}
      responses:
        '200':
          x-apidog-ordering: 0
          description: '200'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/retrieverawtranscript200response'
          headers: {}
          x-apidog-name: ''
        '400':
          x-apidog-ordering: 1
          description: '400'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic400response'
          headers: {}
          x-apidog-name: ''
        '403':
          x-apidog-ordering: 2
          description: '403'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic403response'
          headers: {}
          x-apidog-name: ''
        '404':
          x-apidog-ordering: 3
          description: '404'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/generic404response'
          headers: {}
          x-apidog-name: ''
        '410':
          x-apidog-ordering: 4
          description: '410'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/transcripts410response'
          headers: {}
          x-apidog-name: ''
      security:
      - BearerUser11: []
      x-publication-status: live
      x-run-in-apidog: https://app.apidog.com/web/project/1203004/apis/api-37769991-run
      x-source-url: https://api-docs.bigpanda.io/retrieve-raw-transcript-37769991e0.md
      x-source-page: Retrieve raw transcript
components:
  schemas:
    Biggy-meeting-object:
      required:
      - meetingUrl
      - summaryDestination
      type: object
      properties:
        meetingUrl:
          type: string
          description: The full URL of the meeting. Must be from Zoom, MS Teams, Webex, or Google Meet.
          examples:
          - https://exampledomain.zoom.us/j/96583745555
        summaryDestination:
          description: Where the meeting summary will be sent.
          oneOf:
          - title: MS teams
            type: object
            properties:
              platform:
                type: string
                description: The platform hosting the meeting. One of MS Teams, Zoom, Webex, Google Meet.
                examples:
                - MS teams
              tenantId:
                type: string
                description: The Microsoft 365 tenant ID where the Teams conversation is located.
                examples:
                - 72f988bf-86f1-41af-91ab-2d7cd011ee88
              conversationType:
                type: string
                description: The type of conversation. One of personal, channel, groupChat.
                examples:
                - personal
              channelId:
                type: string
                description: The ID of the conversation, channel, or group chat where Biggy will post the summary.
                examples:
                - 19%3AlR675j1A7OfrPGfSTqHHHMKdjQ6AkG_uGYEdFXUgYw1%55thread.tacv2
              groupId:
                type: string
                description: The group ID associated with the MS Teams channel. This field is only used if the conversationType selected was 'channel' or 'groupChat'.
                examples:
                - dbb2bf1b-dade-4409-8c48-432ff49dacc7&
            required:
            - platform
            - tenantId
            - conversationType
            - channelId
            x-apidog-orders:
            - platform
            - tenantId
            - conversationType
            - channelId
            - groupId
            x-apidog-ignore-properties: []
          - title: Slack
            type: object
            properties:
              platform:
                type: string
                description: The platform hosting the meeting. One of MS Teams, Zoom, Webex, Google Meet.
                examples:
                - MS teams
              teamId:
                type: string
                description: Unique identifier of the Slack team.
                examples:
                - TOQ5MEKH5
              channelId:
                type: string
                description: Unique identifier of the Slack channel where Biggy will post the summary.
                examples:
                - C05H844GS82
              threadTs:
                type: string
                description: Unique identifier of the Slack thread where Biggy will post the summary.
                examples:
                - 12345.1234
            required:
            - platform
            - teamId
            - channelId
            x-apidog-orders:
            - platform
            - teamId
            - channelId
            - threadTs
            x-apidog-ignore-properties: []
        options:
          type: object
          properties:
            isScheduledJoin:
              type: boolean
              description: Whether or not the meeting is scheduled. If it is not scheduled, Biggy will join the meeting immediately.
              examples:
              - true
            joinTimeInMs:
              type: string
              description: The time that Biggy should join the meeting, in Unix epoch time in milliseconds. This field is only required if isScheduledJoin is set to 'true'.
              examples:
              - 1734566400000
          x-apidog-orders:
          - isScheduledJoin
          - joinTimeInMs
          x-apidog-ignore-properties: []
      x-apidog-orders:
      - meetingUrl
      - summaryDestination
      - options
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    transcripts410response:
      type: object
      description: 'Transcript has expired and is no longer available (media retention ended)

        '
      properties:
        status:
          type: integer
          examples:
          - 410
        errors:
          type: array
          items:
            type: string
            examples:
            - 'Transcript has expired and is no longer available (media retention ended)    '
      x-apidog-orders:
      - status
      - errors
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    joinameeting409response:
      type: object
      properties:
        statusCode:
          type: object
          properties: {}
        error:
          type: string
        message:
          type: string
        existingStatus:
          type: string
      x-apidog-orders:
      - statusCode
      - error
      - message
      - existingStatus
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    generic404response:
      type: object
      description: 'Requested endpoint or resource is not found.

        '
      properties:
        status:
          type: integer
          examples:
          - 404
        errors:
          type: array
          items:
            type: string
            examples:
            - Requested endpoint or resource is not found.
      x-apidog-orders:
      - status
      - errors
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    generic403response:
      type: object
      description: 'Forbidden

        '
      properties:
        statusCode:
          type: integer
          examples:
          - 403
        error:
          type: string
          examples:
          - Forbidden
        message:
          type: string
          examples:
          - Forbidden - insufficient permissions
      x-apidog-orders:
      - statusCode
      - error
      - message
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    retrieverawtranscript200response:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              conferenceCallId:
                type: string
                description: Unique ID of the conference call.
                examples:
                - 65f0c8f8d73b2b0012ab3412
              meetingTitle:
                type: string
                description: Title of the meeting.
                examples:
                - Incident Review
              meetingUrl:
                type: string
                description: URL of the meeting.
                examples:
                - https://meet.example.com/abc
              meetingPlatform:
                type: string
                description: Platform where the meeting took place.
                examples:
                - Zoom
              timeStarted:
                type: string
                description: The ISO date/time when the meeting started.
                examples:
                - '2026-02-01T17:00:00.000Z'
              timeEnded:
                type: string
                description: The ISO date/time when the meeting ended.
                examples:
                - '2026-02-01T17:30:00.000Z'
              transcript:
                type: string
                description: Raw transcript of the call.
                examples:
                - null
              matchedConferenceCallsCount:
                type: string
                description: Number of conference calls that matched the request.
                examples:
                - 1
              transcriptTruncated:
                type: boolean
                description: Whether or not the transcript was truncated.
                examples:
                - false
              transcriptCharLimit:
                type: string
                description: Character limit of the returned transcript.
                examples:
                - 1000000
              transcriptOriginalCharCount:
                type: string
                description: Number of characters in the original raw transcript.
                examples:
                - 12345
              transcriptReturnedCharCount:
                type: string
                description: Number of characters returned.
                examples:
                - 12345
            x-apidog-orders:
            - conferenceCallId
            - meetingTitle
            - meetingUrl
            - meetingPlatform
            - timeStarted
            - timeEnded
            - transcript
            - matchedConferenceCallsCount
            - transcriptTruncated
            - transcriptCharLimit
            - transcriptOriginalCharCount
            - transcriptReturnedCharCount
            x-apidog-ignore-properties: []
      x-apidog-orders:
      - items
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    joinameeting201response:
      type: object
      properties:
        conferenceCallId:
          type: string
          description: Unique identifier of the conference call.
          examples:
          - 650f1a8b2c4b7e89abc12123
        status:
          type: string
          description: The join status of the call.
          examples:
          - joining
      x-apidog-orders:
      - conferenceCallId
      - status
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    retrievealltranscripts200response:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              conferenceCallId:
                type: string
                description: Unique ID of the conference call.
                examples:
                - 65f0c8f8d73b2b0012ab3412
              meetingTitle:
                type: string
                description: Title of the meeting.
                examples:
                - Incident Review
              meetingUrl:
                type: string
                description: URL of the meeting.
                examples:
                - https://meet.example.com/abc
              meetingPlatform:
                type: string
                description: Platform where the meeting took place.
                examples:
                - Zoom
              timeStarted:
                type: string
                description: The ISO date/time when the meeting started.
                examples:
                - '2026-02-01T17:00:00.000Z'
              timeEnded:
                type: string
                description: The ISO date/time when the meeting ended.
                examples:
                - '2026-02-01T17:30:00.000Z'
            x-apidog-orders:
            - conferenceCallId
            - meetingTitle
            - meetingUrl
            - meetingPlatform
            - timeStarted
            - timeEnded
            x-apidog-ignore-properties: []
        pagination:
          type: array
          items:
            type: object
            properties:
              page:
                type: string
                description: The maximum number of pages.
                examples:
                - 1
              limit:
                type: string
                description: The maximum page size.
                examples:
                - 20
              hasMore:
                type: boolean
                description: Whether or not additional transcripts are available.
                examples:
                - true
            x-apidog-orders:
            - page
            - limit
            - hasMore
            x-apidog-ignore-properties: []
      x-apidog-orders:
      - items
      - pagination
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    generic400response:
      type: object
      description: 'Call is missing parameters or malformed.

        '
      properties:
        status:
          type: integer
          examples:
          - 400
        errors:
          type: array
          items:
            type: string
            examples:
            - Call is missing parameters or malformed.
      x-apidog-orders:
      - status
      - errors
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    generateatranscriptsummary201response:
      type: object
      properties:
        conferenceCallId:
          type: string
          description: Unique ID of the conference call.
          examples:
          - 65f0c8f8d73b2b0012ab3412
        meetingTitle:
          type: string
          description: User-assigned title of the meeting.
          examples:
          - Weekly Incident Review
        summary:
          type: string
          description: Generated summary of the meeting.
          examples:
          - Summary text...
        rawTranscript:
          type: string
          description: Raw transcript text. Only returned if `includeRawTranscripts` was set to `true`.
          examples:
          - Raw transcript text.
        matchedConferenceCallsCount:
          type: string
          description: Number of conference calls that matched the request.
          examples:
          - 1
        transcriptTruncated:
          type: boolean
          description: Whether or not the transcript was truncated.
          examples:
          - false
        transcriptCharLimit:
          type: string
          description: Character limit of the returned transcript.
          examples:
          - 1000000
        transcriptOriginalCharCount:
          type: string
          description: Number of characters in the original raw transcript.
          examples:
          - 12345
        transcriptReturnedCharCount:
          type: string
          description: Number of characters returned.
          examples:
          - 12345
      x-apidog-orders:
      - conferenceCallId
      - meetingTitle
      - summary
      - rawTranscript
      - matchedConferenceCallsCount
      - transcriptTruncated
      - transcriptCharLimit
      - transcriptOriginalCharCount
      - transcriptReturnedCharCount
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
  securitySchemes:
    BearerUser11:
      type: http
      scheme: bearer
      description: 'Format: "Bearer {User API Key}" BigPanda recommends adding

        [Authentication](https://docs.bigpanda.io/reference/introduction#authentication-and-headers)

        headers only in the secure tool you use to make API calls

        '
x-server-notes:
- US host https://api.bigpanda.io verified live 2026-09-04 (HTTP 401 Authorization Required on an unauthenticated request).
- EU host https://api.eu.bigpanda.io is the value BigPanda publishes at https://api-docs.bigpanda.io/regions. It did NOT resolve in DNS on 2026-09-04. The live EU host observed on that date is https://eu-api.bigpanda.io (401 Authorization Required). The per-endpoint fragments on the same site declare a third EU value, https://eu-api.biggy.io, which also does not resolve. Recorded as published; not corrected.