--- title: Monitor waiting room status description: Monitor active users and queue status in real time. image: https://developers.cloudflare.com/core-services-preview.png --- > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/waiting-room/llms.txt > Use this file to discover all available pages before exploring further. [Skip to content](#%5Ftop) # Monitor waiting room status You can monitor the status of your waiting rooms using the [dashboard](#status-in-the-dashboard) or the [API](#status-in-the-api). Note that the **Total active users** and **Queued users** shown in the dashboard, as well as through API endpoints are estimates. That data corresponding to each of these metrics is cached for around 30 seconds after the time it takes to be synced from all data centers globally. Therefore, the status will range between 20-50 seconds in the past, depending on the exact moment the data was queried, aggregated, as well as the age of the cache. Refer to [Waiting Room Analytics](https://developers.cloudflare.com/waiting-room/waiting-room-analytics/) for more details about the traffic going through your waiting room. ## Status in the dashboard Open the **Waiting Room** dashboard to view the list of your waiting rooms. The **Status** column displays the current state of the waiting room: * **Not queueing**: * Waiting room enabled, but has not reached traffic threshold to send visitors to waiting room. * Shows estimated number of users in the application. * **Queueing**: * Waiting room enabled and sending visitors to waiting room. * Shows estimated number of users in the queue. * On hover, shows maximum wait time expected for users. * **Disabled**: The waiting room is suspended. * **Queue-all**: * Forces all traffic to queue in the waiting room. * On hover, shows estimated number of users in the queue. ## Status in the API [Check whether traffic is queueing in a configured waiting room](https://developers.cloudflare.com/api/resources/waiting%5Frooms/subresources/statuses/methods/get/) by appending the following endpoint to the Cloudflare API base URL: Required API token permissions At least one of the following [token permissions](https://developers.cloudflare.com/fundamentals/api/reference/permissions/)is required: * `Waiting Rooms Read` * `Waiting Rooms Write` Get waiting room status ``` curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms/$WAITING_ROOM_ID/status" \ --request GET \ --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` The response is: * `queueing` if visitors are currently queueing in the waiting room. * `not_queueing` if the room is empty or if the waiting room is suspended. To check whether a configured waiting room is suspended or whether the traffic is force-queued to the waiting room, append the following endpoint to the Cloudflare API base URL. Required API token permissions At least one of the following [token permissions](https://developers.cloudflare.com/fundamentals/api/reference/permissions/)is required: * `Waiting Rooms Read` * `Waiting Rooms Write` Waiting room details ``` curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms/$WAITING_ROOM_ID" \ --request GET \ --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` The endpoint above [fetches all settings](https://developers.cloudflare.com/api/resources/waiting%5Frooms/methods/get/) for a configured waiting room: Terminal window ``` "success": true, "errors": [], "messages": [], "result": { "id": "REDACTED", "created_on": "2014-01-01T05:20:00.12345Z", "modified_on": "2014-01-01T05:20:00.12345Z", "name": "shop_waiting_room", "description": "Waiting room for webshop", "suspended": false, "host": "shop.example.com", "path": "/shop", "queue_all": true, "new_users_per_minute": 200, "total_active_users": 300, "session_duration": 1, "disable_session_renewal": false, "json_response_enabled": false, "queueing_method": "random", "cookie_attributes": { "samesite": "auto", "secure": "auto" }, "custom_page_html": "{{#waitTimeKnown}} {{waitTime}} mins {{/waitTimeKnown}} {{^waitTimeKnown}} Queue all enabled {{/waitTimeKnown}}" } ``` The value of `suspended` indicates whether a waiting room is activated or suspended: * `false`: The waiting room is activated. * `true`: The waiting room is suspended. The value of `queue_all` indicates whether all traffic is forced to queue in the waiting room: * `false`: Visitors are diverted to the waiting room only if traffic exceeds the configured threshold. * `true`: All traffic is forced to queue in the waiting room, and no traffic passes from the waiting room to the origin. ## Queueing activation Waiting Room queues traffic at the data-center level to increase scalability, letting each data center make decisions independently. Because of this design, the configured traffic limits of a waiting room are target values which your waiting room will work to keep your traffic volumes near. A waiting room might queue traffic from a specific data center before the waiting room reaches its limit of `new_users_per_minute` or `total_active_users`. Waiting Room also continuously monitors the rate of users entering throughout each minute, and not just at the end of the minute. Therefore, if at the beginning of your minute, a large fraction of your set `new_users_per_minute` value already joined, we may start queueing users, even if the overall `new_users_per_minute` value that is reached for that minute is not hit. To help prevent a waiting room from active queueing, increase the values for `new_users_per_minute` and/or `total_active_users`. For more information about how Waiting Room makes queueing decisions, review our [blogpost ↗](https://blog.cloudflare.com/how-waiting-room-queues). Note Note that Waiting Room is designed to handle legitimate traffic. If you notice frequent or abnormal queueing behavior, ensure that you are properly handling malicious and automated traffic using Cloudflare security products. ```json {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/waiting-room/","name":"Waiting Room"}},{"@type":"ListItem","position":3,"item":{"@id":"/waiting-room/how-to/","name":"How to"}},{"@type":"ListItem","position":4,"item":{"@id":"/waiting-room/how-to/monitor-waiting-room/","name":"Monitor waiting room status"}}]} ```