API reference / officials
officials
/api/v1/officials/rosterVolunteers who hold a current officiating credential, and can therefore be assigned to a game. Expired and inactive certifications are excluded: assigning a referee is a safeguarding decision as much as a scheduling one. Named /roster rather than /officials so it cannot shadow /credentials, /availability and /evaluations the way a bare :id segment would.
- Auth:
- required (min role: coach)
/api/v1/officials/assignmentsEvery official assignment in the org, newest game first, with the official and team named rather than referenced by id. Optional ?gameId= narrows to one game.
- Auth:
- required (min role: coach)
/api/v1/officials/assignmentsAssign an official to a game. Starts at `pending` — a director asking someone is not the same event as that person agreeing. Assigning the same person to the same game twice returns the existing row rather than creating a duplicate.
- Auth:
- required (min role: admin)