---
title: "Public queue snapshot for a location (no PII)"
method: GET
path: "/api/rightos/locations/{locationId}/queue"
tags: ["locations"]
---

# Public queue snapshot for a location (no PII)

`GET /api/rightos/locations/{locationId}/queue`

## Request

- Base URL: `https://rightos.i-s3.com`
- URL: `https://rightos.i-s3.com/api/rightos/locations/{locationId}/queue`
- Auth: none required

Returns active/waiting counts and optional aheadCount for a tokenId query param. Reference only — RightOS does not auto-call or assign staff.

## Path parameters

- `locationId` string, required

## Query parameters

- `tokenId` string

## Response `200`

Queue snapshot

- LocationQueueSnapshot: Public queue state for a location (no PII). Reference only — RightOS does not auto-call or assign staff (ADR-0024).
  - `locationId` string
  - `locationName` string: Public store/location name (not PII); used by the display board
  - `locationActive` boolean
  - `activeCount` integer: issued + verified (not expired)
  - `waitingCount` integer: issued only
  - `verifiedCount` integer: verified only
  - `issueSequenceToday` integer: Max priorityNumber issued today (issue sequence, not queue position)
  - `headQueuePosition` integer, nullable: Front queue position among waiting (issued) tokens, if any
  - `estimatedWaitMinutes` integer, nullable: Estimated wait from recent used tokens; null if insufficient samples
  - `aheadCount` integer: Present when tokenId query param is set
  - `queuePosition` integer: Present when tokenId query param is set

## Other responses

- `404`: Location not found

---

[API](https://skmtc.dev/i-s3/apis/rightos-right-api.md) · [All operations](https://skmtc.dev/i-s3/apis/rightos-right-api/llms.txt) · [OpenAPI document](https://skmtc.dev/i-s3/apis/rightos-right-api/revisions/10020536e345?raw)