Integrations
Last updated November 13, 2026

Embed Leaderboard URL

Embed Leaderboard URL

Every Live Tourney event has an /embed URL that returns a lightweight, polling-based leaderboard. Unlike the standard event page (which holds an open Firestore real-time connection), the embed page fetches updates from a cached JSON API on a fixed interval. This is the recommended URL for GPS systems, course displays, club websites, and any other integration that needs a leaderboard view without the bandwidth cost of a live connection.

Embed URL by Event Type

Event type URL
Tournament (single round) https://app.livetourney.com/tournament/[code]/embed
Multi-Round Tournament https://app.livetourney.com/event/[code]/embed
Round Robin https://app.livetourney.com/roundrobin/[code]/embed
Ryder Cup https://app.livetourney.com/rydercup/[code]/embed
Bracket https://app.livetourney.com/bracket/[code]/embed

[code] is the event code (or custom slug) — the same value used in your standard event URL.

The embed URL is public — anyone with the event code can view it. No login is required.

URL Parameters

The embed page accepts the following query parameters:

Param Type Default Behavior
poll integer seconds 60 How often the leaderboard fetches fresh data. Clamped to between 10 and 3600 seconds.
chrome true / false true When false, hides the top event header bar. Tab navigation (Leaderboard / Scorecard) stays visible.
theme light / dark light When dark, applies a dark color palette suitable for cart screens and low-light displays.
scorecardCode scorecard code none Opens the Scorecard tab with that group's scorecard already loaded, instead of the leaderboard.
hole hole number none Opens the loaded scorecard on that hole. See Opening Score Entry on a Specific Hole below.

Examples

Five-minute poll, dark theme, header hidden (a common GPS/cart configuration):

https://app.livetourney.com/tournament/12345/embed?poll=300&chrome=false&theme=dark

Ten-second poll for an active scoring TV:

https://app.livetourney.com/tournament/12345/embed?poll=10

Default behavior (60-second poll, light theme, header shown):

https://app.livetourney.com/tournament/12345/embed

Opening Score Entry on a Specific Hole

A GPS cart system can open score entry for the group in the cart, on the hole they just finished (for example, when the cart leaves the green).

Add scorecardCode and hole to the embed URL:

https://www.livetourney.com/tournament/12345/embed?chrome=false&theme=dark&scorecardCode=456789&hole=7
  • scorecardCode is the group's scorecard code, the same code players type to open their scorecard. In the partner API it is the scorecardId on each group of the pairings response.
  • hole is the hole number as it appears on the Live Tourney scorecard. It takes priority over the group's starting hole and over the hole the device last had open.
  • If the hole is not on that scorecard (for example, hole 14 on a front-nine card), it is ignored and the scorecard opens as it normally would.

Changing the hole without reloading

If your screen keeps the page open, change the URL fragment instead of loading a new URL:

https://www.livetourney.com/tournament/12345/embed?chrome=false&theme=dark&scorecardCode=456789#hole=8

Changing #hole= moves the open scorecard to that hole without a page reload. Any scores already entered are saved first. If the scorer is partway through entering the current hole, the change is ignored so they are not interrupted.

Both parameters also work on the standard event page URL.

Caching

The underlying JSON API sets the following cache headers:

Cache-Control: s-maxage=60, stale-while-revalidate=120

This means a single response is shared across all viewers for up to 60 seconds, with stale content served for an additional 120 seconds while the cache is refreshed. Setting poll below 60 seconds is allowed but will frequently return cached responses.

When to Use Embed vs the Standard Event Page

Use case Recommended URL
Player viewing on phone during their round Standard event page (real-time updates)
TV at the clubhouse for live event viewing TV leaderboard URL (see Setting Up a TV Leaderboard)
GPS cart screen or third-party leaderboard display Embed URL
Iframe on a club website Embed URL with ?chrome=false
Anywhere lower bandwidth matters more than instant updates Embed URL

For Integration Partners

If you are building a GPS, course-management, or display system that needs to consume Live Tourney leaderboard data, the embed URL is the supported entry point. The page is iframe-friendly (no X-Frame-Options restrictions) and the underlying API is documented in the codebase at src/pages/api/leaderboard/singleRound/README.md.

For direct API access without rendering the page, contact help@livetourney.com to discuss partner API keys. See API Keys and Integrations for the partner API process.

Was this article helpful?

© 2026 Live Tourney. All rights reserved.