Read current facility status
curl --fail-with-body \ 'https://server2.gp-lights.com/api/v1/YOUR_ORG_ID/effective-status'This public GET route validates the organization identifier. A nonexistent organization returns 404. The response includes ok, plan metadata, serverNow, facility, and an areas map keyed by area ID. The backend sets Cache-Control: public, max-age=30.
For an area, read current.status, current.displayNote, nextTransitionAt, and occupancy. current can be null. Keep unknown statuses forward-compatible and never turn unavailable occupancy into zero.
Transition timestamps are UTC instants. Display dates in the organization timezone if formatting them yourself. Measurement freshness and open/closed state answer different questions; do not present an old occupancy value as live merely because the facility is open.
The response contains plan details in addition to current status. Do not assume the entire payload is a flat list of areas. Use the returned current segment instead of independently resolving raw schedules.