---
title: "Roster Status"
method: GET
path: "/chatrooms/{room_name}/roster-status"
tags: ["chatrooms"]
---

# Roster Status

`GET /chatrooms/{room_name}/roster-status`

Which people in this class are actually on the section roster. HOST ONLY.

Angie, describing how the first classes will really go (2026-08-24): most
students click the link without signing up, so the teacher spends the start
of the lesson fixing it, and by the second class wants to check by NAME.
They cannot do that today. The roster panel shows who is in the room; it has
no idea which of them the register will actually record.

Three states, and the middle one is the one nobody expects:

  * `registered: false`  — an anonymous guest. Their attendance cannot be
    matched to anybody, because a guest join mints a fresh anon id per visit.
  * `in_section: false`  — a REAL account, signed in, and still not on this
    section's roster. Looks completely normal on the stage and is silently
    absent from the register. This is the state that produces "but I was
    there" a fortnight later.
  * both true — counted.

Host-gated because it is a statement about named people's enrolment, which is
the teacher's business and not the class's. `is_room_host` covers the room
creator, promoted co-hosts, org staff and admins.

Takes the identities currently in the LiveKit room rather than returning the
section roster, so nothing here can be used to enumerate a school's students:
the caller only learns about people already visibly in the room with them.

## Path parameters

- `room_name` string, required

## Query parameters

- `identities` string

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/ebade541eaa4/schema)