Get Meeting Session by ID

#Overview

Retrieve detailed information about a specific meeting session, including participants, status, timestamps, chapters, and associated user information. A meeting session represents a single instance or occurrence of a meeting.

#Endpoint

GET /v1/meetings/{meetingId}/sessions/{sessionId}

#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
sessionId	string	The unique identifier of the meeting session

#Response

Returns a meeting session object with the following properties:

Field	Type	Description
id	string	Unique identifier for the meeting session
meeting_id	string	The ID of the parent meeting
status	string	Current status of the session (e.g., "ended", "in_progress")
started_at	string	ISO 8601 timestamp when the session started
ended_at	string	ISO 8601 timestamp when the session ended
participants	array	List of participants in the meeting session
participants[].deviceId	string	Unique identifier for the participant's device
participants[].name	string	Name of the participant
participants[].avatarUrl	string	URL to the participant's avatar
participants[].isMe	boolean	Whether this participant is the authenticated user
participants[].deviceType	string	Type of device ("main" or "screenshare")
attendees	array | null	List of calendar event attendees (may be null)
chapters	array	Automatically generated chapters/segments of the meeting
chapters[].start	string	ISO 8601 timestamp when the chapter starts
chapters[].end	string	ISO 8601 timestamp when the chapter ends
chapters[].name	string	Title/name of the chapter
created_at	string	ISO 8601 timestamp when the session was created
updated_at	string	ISO 8601 timestamp when the session was last updated
user	object	Information about the user who created the session
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/sessions/mgl9fv5q \
  -H "Authorization: Bearer sk_your_api_key_here"

#Example Response

{
  "success": true,
  "data": {
    "id": "mgl9fv5q",
    "meeting_id": "_X0HKGNCDsR3aVAoqNDBa",
    "status": "ended",
    "started_at": "2025-10-10T19:49:37.139Z",
    "ended_at": "2025-10-10T19:49:48.244Z",
    "attendees": null,
    "chapters": [
      {
        "start": "2025-10-10T19:49:39.380Z",
        "end": "2025-10-10T19:49:47.732Z",
        "name": "Introduction and Testing"
      }
    ],
    "participants": [
      {
        "deviceId": "device-abc-123",
        "name": "John Doe",
        "avatarUrl": "https://example.com/avatars/johndoe.jpg",
        "isMe": true,
        "deviceType": "main"
      }
    ],
    "created_at": "2025-10-10T19:49:36.687Z",
    "updated_at": "2025-10-10T19:50:14.540Z",
    "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

400 Bad Request

Returned when the session does not belong to the specified meeting.

{
  "success": false,
  "error": "Meeting session does not belong to the specified meeting"
}

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 session with the specified ID does not exist.

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

500 Internal Server Error

Returned when an unexpected error occurs on the server.

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