API reference / officials

officials

GET/api/v1/officials/roster

Volunteers 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)
GET/api/v1/officials/assignments

Every 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)
POST/api/v1/officials/assignments

Assign 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)
officials API — Peer10 Developers