sessions_get_attendance

Read who's enrolled in **one event** (a single session of a class) and their current attendance, so you can show the list and then mark it. Pass an event_id; the tool returns each enrolled attendee, their current attendance value (if already marked), and per-row context the LLM needs to mark attendance correctly: allowed_statuses[] (the statuses the **current caller** is permitted to set for THIS attendee), is_trial / is_last_trial_session flags, warnings about cross-company or cascade-sensitive (full2) cases, and — for open-type registrations only — entrance_voucher info (how many unused vouchers the attendee has, and whether one is already spent on this event). Use this **before** sessions_mark_attendance whenever the user has not already dictated the full list of attendees and marks — typically: "open attendance for X," "who's enrolled in tomorrow's class," "show me Monday's attendance." If the event's course has attendance tracking disabled, the tool returns an attendance_tracking_disabled error rather than an empty list. This tool is read-only — it never writes attendance, notes, or summaries.

**Talking to the user — vocabulary.** Zooza's customers are activity brands — dance, swim, language, sport, STEAM schools. Call this **"attendance," "the attendance list," "the class list," or "who's coming."** Don't expose the tool name or use sports/HR jargon ("roster") — it reads as foreign to these businesses. When the user asks to "see attendance" / "open the register" / "who's in Monday's class," just call this tool and render the list directly.

**Attendee vs client (critical for children's-class programmes).** Each row carries TWO people:

• attendee — who actually shows up to the session. Often a child (Zooza data-model name: customer). May have user_id: 0 when they aren't a registered account holder, which is normal for children. attendee.date_of_birth is available.
• client — the account holder / payer (Zooza data-model name: buyer). Usually the parent. Has a real user_id. Contact info (email, phone) lives on the client when the attendee is a child; copy from client when speaking to / messaging the family.
• display_name — a pre-formatted one-line label. When attendee == client (adult attending themselves), just the one name. When they differ, attendee_name (client_name) — e.g. "Jozko Jozko (Martin Rapavy)". Use this when listing attendees; the LLM doesn't need to compose it from scratch.

Response shape notes:

• allowed_statuses[] already factors in the caller's role, company.trainer_attendance_management, and the row's cross-company state. Do not propose a status not in this array — refuse locally and explain instead of calling sessions_mark_attendance to discover the constraint.
• is_last_trial_session is currently null in V1 (derivation requires either a new api-v1 field or extra per-row lookups; deferred). Treat is_trial=true as the trigger for caution — a future enrichment will tighten this.
• entrance_voucher is non-null only when course.registration_type="open". Check it before setting sessions_mark_attendance's use_voucher=true on a going write.
• summary block at the top level surfaces whether this event already has a public / internal session summary (public_set / internal_set), whether the public one is locked, and whether the caller's role is permitted to write summaries (writable_by_caller). After the user has marked attendance, the LLM can use this to offer sessions_add_summary as a follow-up when appropriate.