Get Meeting by ID

#Overview

Retrieve detailed information about a specific meeting including its title, description, source, timestamps, and associated user information.

#Endpoint

GET /v1/meetings/{meetingId}

#Authentication

This endpoint requires authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer sk_your_api_key_here

#Path Parameters

Parameter	Type	Description
meetingId	string	The unique identifier of the meeting

#Response

Returns a meeting object with the following properties:

Field	Type	Description
id	string	Unique identifier for the meeting
title	string	Title of the meeting
description	string	Description of the meeting
external_id	string	External identifier from the source platform
source	string	Meeting source platform (e.g., google-meet, zoom, microsoft-teams)
link	string	URL to join the meeting
metadata_version	number	Version of the metadata schema
created_at	string	ISO 8601 timestamp when the meeting was created
updated_at	string	ISO 8601 timestamp when the meeting was last updated
user	object	Information about the user who created the meeting
user.id	string	User's unique identifier
user.first_name	string	User's first name
user.last_name	string	User's last name
user.email	string	User's email address
user.avatar_url	string	URL to the user's avatar image

#Example Request

curl https://api.bigmind.ai/v1/meetings/_X0HKGNCDsR3aVAoqNDBa \
  -H "Authorization: Bearer sk_your_api_key_here"

#Example Response

{
  "success": true,
  "data": {
    "id": "_X0HKGNCDsR3aVAoqNDBa",
    "title": "Impromptu meeting",
    "description": "",
    "external_id": "xyx-dfkd-ckk",
    "source": "google-meet",
    "link": "https://meet.google.com/xyx-dfkd-ckk",
    "metadata_version": 1,
    "created_at": "2025-10-10T19:49:36.506Z",
    "updated_at": "2025-10-10T19:49:36.506Z",
    "user": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "avatar_url": "https://example.com/avatars/johndoe.jpg"
    }
  }
}

#Error Responses

401 Unauthorized

Returned when the API key is missing or invalid.

{
  "success": false,
  "error": "Missing API key. Please provide a valid API key in the Authorization header."
}

404 Not Found

Returned when the meeting with the specified ID does not exist.

{
  "success": false,
  "error": "Meeting not found"
}

500 Internal Server Error

Returned when an unexpected error occurs on the server.

{
  "success": false,
  "error": "Failed to fetch meeting: [error details]"
}