Skip to main content

​
Overview

The active_meetings query is designed to fetch a list of meetings that are currently active (in progress). This endpoint allows you to monitor ongoing meetings for users in your team.

​
Arguments

​
email
String
Filter active meetings by a specific user’s email address.Permission requirements:
  • Regular users: Can only query their own active meetings (must pass their own email or omit this field)
  • Admins: Can query active meetings for any user in their team
If this field is omitted, the query returns active meetings for the authenticated user.The email must be valid and belong to a user in the same team as the requester.

​
Schema

Fields available to the ActiveMeeting query

​
Usage Example

query ActiveMeetings($email: String) {
  active_meetings(input: { email: $email }) {
    id
    title
    organizer_email
    meeting_link
    start_time
    end_time
    privacy
  }
}

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer your_api_key" \
    --data '{ "query": "query ActiveMeetings { active_meetings { id title organizer_email meeting_link start_time } }" }' \
    https://api.fireflies.ai/graphql

{
  "data": {
    "active_meetings": [
      {
        "id": "meeting-id-1",
        "title": "Team Standup",
        "organizer_email": "user@example.com",
        "meeting_link": "https://zoom.us/j/123456789",
        "start_time": "2024-01-15T10:00:00.000Z"
      },
      {
        "id": "meeting-id-2",
        "title": "Client Review",
        "organizer_email": "user@example.com",
        "meeting_link": "https://meet.google.com/abc-defg-hij",
        "start_time": "2024-01-15T14:30:00.000Z"
      }
    ]
  }
}

​
Error Codes

List of possible error codes that may be returned by the active_meetings query. Full list of error codes can be found here.

The user email you are trying to query does not exist or is not in the same team as the requesting user.

You do not have permission to query active meetings for other users. Regular users can only query their own active meetings. Admin privileges are required to query other users’ active meetings.

​
Additional Resources

Transcripts

Query completed meetings and transcripts

Add to Live Meeting

Join an active meeting with Fireflies.ai bot