HAhappyscribe
Meetings

List meetings

The meetings of one workspace, whether they came from a connected calendar or a bot. Upcoming meetings are listed soonest first; any other list, latest start first. Cancelled meetings are listed only with phase=cancelled.

get/meetings

Request

  • Base URL
    https://www.happyscribe.com/api/v1
  • Auth
    API key in header Authorization

Query parameters

workspace_idstring required
Example:wks_01k6a2r9s8x7c2dvq3m5n6p4ab

Workspace ID, beginning with wks_. Treat it as an opaque string. Integer workspace ids are still accepted.

member_idstring
Example:mem_01k0h4r9s8x7c2dvq3m5n6p4ab

Only meetings this member is on, as an invitee or as the sender of the bot.

phase'upcoming' | 'live' | 'past' | 'cancelled'

About time only; what happens after the call is in results.

  • upcoming: not started, and nothing recording yet.
  • live: a recording is active. An early start counts: activity beats the calendar.
  • past: the recording ended, or the scheduled end went by.
  • cancelled: the source event was cancelled. Listed only with phase=cancelled.

Defaults to every phase except cancelled.

starts_afterstring date-time

Only meetings starting at or after this time.

starts_beforestring date-time

Only meetings starting before this time.

limitinteger

Page size, 1 to 100.

cursorstring

Opaque. Follow _links.next.url rather than building it.

Response

One page of meetings.

objectstring

Always list.

has_moreboolean

Whether more results follow this page.

Example response

{
  "data": [
    {
      "id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
      "object": "meeting",
      "workspace_id": "wks_01k6a2r9s8x7c2dvq3m5n6p4ab",
      "source": "calendar_connection",
      "phase": "past",
      "title": "Weekly sync with Acme",
      "starts_at": "2026-09-29T09:00:00Z",
      "ends_at": "2026-09-29T09:30:00Z",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "platform": "meet",
      "organizer": {
        "name": "Marc",
        "email": "marc@gurusup.com",
        "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
      },
      "participants": [
        {
          "name": "Marc",
          "email": "marc@gurusup.com",
          "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
        },
        {
          "name": "Ana Ruiz",
          "email": "ana@acme.com",
          "member_id": null
        }
      ],
      "calendar_event": {
        "id": "cev_01k6a2r9s8x7c2dvq3m5n6p4ab",
        "object": "calendar_event",
        "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
        "ical_uid": "7kq2b@google.com",
        "recurring": true,
        "title": "Weekly sync with Acme",
        "starts_at": "2026-09-29T09:00:00Z",
        "ends_at": "2026-09-29T09:30:00Z",
        "meeting_url": "https://meet.google.com/abc-defg-hij",
        "organizer": {
          "name": "Marc",
          "email": "marc@gurusup.com",
          "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
        },
        "attendees": [
          {
            "name": "Marc",
            "email": "marc@gurusup.com",
            "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab",
            "response": "accepted"
          },
          {
            "name": "Ana Ruiz",
            "email": "ana@acme.com",
            "member_id": null,
            "response": "needs_action"
          }
        ],
        "source": "calendar_connection",
        "metadata": {},
        "cancelled_at": null,
        "created_at": "2026-09-22T08:00:00Z",
        "updated_at": "2026-09-29T09:31:10Z"
      },
      "policy": {},
      "effective_policy": {
        "recording": {
          "enabled": true,
          "enabled_because": "in_scope",
          "methods": {
            "bot": {
              "start": "on_join",
              "mode": "audio_and_video",
              "silence_detection": {
                "alert": true
              }
            }
          }
        },
        "transcription": {
          "language": "auto"
        },
        "summary": {
          "template": null,
          "language": "en"
        },
        "branding": {
          "brand_kit_id": null
        }
      },
      "recordings": [
        {
          "id": "bot_01k6b0r9s8x7c2dvq3m5n6p4ab",
          "type": "bot",
          "status": "completed",
          "started_at": "2026-09-29T09:00:00Z",
          "ended_at": "2026-09-29T09:31:10Z"
        }
      ],
      "results": {
        "status": "ready",
        "transcript": {
          "status": "ready",
          "language": "en"
        },
        "summary": {
          "status": "ready"
        },
        "media": {
          "status": "ready",
          "duration_seconds": 1834
        }
      },
      "metadata": {},
      "created_at": "2026-09-22T10:14:03Z",
      "updated_at": "2026-09-29T09:41:10Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.