SharedScoresOpen the app
Public read API

Put the live score
anywhere.

Read any supported sport as JSON or subscribe to the same live score events used by the viewer page. Public endpoints are read-only and support cross-origin requests.

Snapshot

Get current score

GET /api/v1/matches/{code}

Returns the sport, two sides, current score, segment history, match status, and a monotonically increasing version.

Live stream

Subscribe to changes

GET /api/v1/matches/{code}/events

A Server-Sent Events stream. Listen for score events and read the match object from each event.

Browser exampleOpenAPI JSON
const source = new EventSource(
  "https://scores.fairway3games.com/api/v1/matches/ABC123/events"
);

source.addEventListener("score", (event) => {
  const { match } = JSON.parse(event.data);
  renderScore(match);
});