> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Joinable Video Conferences

> Lists the video conferences running now that you can join, including calls you are already in and calls that are ringing for you. Empty calls are not listed. Requests are limited to 30 per minute per client IP address.

### Changelog
| Version | Description |
| ------- | ----------- |
| 8.9.0   | Added       |

## OpenAPI

````json GET /api/v1/video-conference.joinable
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Settings"
  },
  "servers": [
    {
      "url": "https://apiexplorer.support.rocket.chat"
    }
  ],
  "tags": [
    {
      "name": "Settings"
    },
    {
      "name": "Audit"
    },
    {
      "name": "Cloud"
    },
    {
      "name": "DNS"
    },
    {
      "name": "E2E"
    },
    {
      "name": "Import"
    },
    {
      "name": "Bulk User Import"
    },
    {
      "name": "Instances"
    },
    {
      "name": "Federation"
    },
    {
      "name": "Moderation"
    },
    {
      "name": "Device Management"
    },
    {
      "name": "Password policy"
    },
    {
      "name": "Video Conference"
    },
    {
      "name": "Media Calls"
    }
  ],
  "paths": {
    "/api/v1/video-conference.joinable": {
      "get": {
        "tags": [
          "Video Conference"
        ],
        "summary": "Get Joinable Video Conferences",
        "description": "Lists the video conferences running now that you can join, including calls you are already in and calls that are ringing for you. Empty calls are not listed. Requests are limited to 30 per minute per client IP address.\n\n### Changelog\n| Version | Description |\n| ------- | ----------- |\n| 8.9.0   | Added       |",
        "operationId": "get-api-v1-video-conference.joinable",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-User-Id"
          },
          {
            "$ref": "#/components/parameters/X-Auth-Token"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "calls": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "callId": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string",
                            "description": "The conference title, or the room name if the conference has no title."
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "usersCount": {
                            "type": "integer",
                            "description": "The number of people in the call now."
                          },
                          "participants": {
                            "type": "array",
                            "description": "Some of the people in the call. The list is capped by the server; use `usersCount` for the total.",
                            "items": {
                              "type": "object",
                              "properties": {
                                "_id": {
                                  "type": "string"
                                },
                                "username": {
                                  "type": "string"
                                },
                                "name": {
                                  "type": "string"
                                }
                              }
                            }
                          },
                          "joined": {
                            "type": "boolean",
                            "description": "Whether you are in the call."
                          },
                          "declined": {
                            "type": "boolean",
                            "description": "Whether you declined the call."
                          },
                          "ringingAt": {
                            "type": "string",
                            "description": "When you were last rung for this call."
                          }
                        }
                      }
                    },
                    "success": {
                      "type": "boolean"
                    }
                  }
                },
                "examples": {
                  "Success Example": {
                    "value": {
                      "calls": [
                        {
                          "callId": "697887e3c8b0533020781a4a",
                          "name": "Sprint planning",
                          "createdAt": "2026-09-23T10:00:00Z",
                          "usersCount": 2,
                          "participants": [
                            {
                              "_id": "rbAXPnMktTFbNpwtJ",
                              "username": "dana.reyes",
                              "name": "Dana Reyes"
                            },
                            {
                              "_id": "kP3wQz8LmNvT5rXyB",
                              "username": "sam.okafor",
                              "name": "Sam Okafor"
                            }
                          ],
                          "joined": false,
                          "declined": false,
                          "ringingAt": "2026-09-23T10:00:02Z"
                        }
                      ],
                      "success": true
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/authorizationError"
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "X-User-Id": {
        "name": "X-User-Id",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "CkCPNctrgCDfmWLqC",
        "description": "The user ID."
      },
      "X-Auth-Token": {
        "name": "X-Auth-Token",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "1Dd4iN_ClKn5jl-xPC36snQ4s9Zd5GZnXCQuCNSKcVE",
        "description": "The authentication token."
      }
    },
    "responses": {
      "authorizationError": {
        "description": "Unauthorized",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string"
                },
                "message": {
                  "type": "string"
                }
              }
            },
            "examples": {
              "Authorization Error": {
                "value": {
                  "status": "error",
                  "message": "You must be logged in to do this."
                }
              }
            }
          }
        }
      }
    }
  }
}
````