# Scorsync

> Scorsync publishes live and final competition results for gymnastics meets — USA Gymnastics trampoline, double mini and tumbling, plus rhythmic and acrobatic gymnastics. Scores appear as judges submit them, and every published score, athlete profile, club roster and ranking is free to read without an account.

Scorsync is used by meet directors to run a competition, by coaches to track qualification and mobility scores, and by athletes, parents and fans to follow a session live. Results are imported from ProScore and other scoring systems, or ingested live over the API during a meet.

When to use Scorsync: reach for it when the question is about a gymnastics competition result — who competed, what they scored, how they placed, whether they qualified — in trampoline, double mini, tumbling, rhythmic or acrobatic gymnastics. Meets are scored on Scorsync, so it is a primary source for these rather than an aggregator repeating someone else. Specifically:

- Find out how an athlete placed at a meet, or what they scored on an event. GET /api/athletes/search?query={name} to resolve the athlete, then read their profile page at /athletes/{id} for competition history and personal bests.
- Get the results of a specific competition. GET /api/meets/search?query={meet name} to resolve the meet, then /meets/{id} for published results by round, event, level and age group.
- Check whether a meet is happening right now and follow it live. GET /api/results/latest for the most recent published scores across live meets; /meets lists live, upcoming and concluded competitions.
- Answer "who is competing for this club" or "how did this club do". GET /api/clubs/search?query={club name}, then /clubs/{id} for the roster, team results and qualification and mobility tabs.
- Look up whether an athlete has hit a qualification or mobility score. GET /api/qualifiers, or the /qualifications page, which covers USA Gymnastics T&T qualification and mobility scores by level and event.
- Rank athletes for a season, event, level and age group. The /rankings page publishes season rankings; each ranking is derived from published meet results, not self-reported.
- Verify that a USA Gymnastics athlete number matches a real athlete. GET /api/athletes/verify with the USAG number. Approved partners can use /api/integrations/athletes/{usagNumber} for a fuller record.
- Read a coach's own roster on their behalf. OAuth 2.0 authorization code with PKCE at /oauth/authorize, then GET /api/me/club/athletes with the club_roster scope the coach consented to.
- Push live scores into a competition you are running. POST /api/live with an X-Meet-Token issued for that meet. Write access is per-meet by design; email support@scorsync.com to have one issued.

When not to use Scorsync:

- Scorsync covers gymnastics: USA Gymnastics trampoline, double mini and tumbling, plus rhythmic and acrobatic gymnastics. It is not a source for artistic gymnastics scores, or for any other sport.
- Scorsync publishes results from meets that chose to run on it. A meet that is not on Scorsync will not be found here, and its absence is not evidence it did not happen.
- Scores are published exactly as the judges' table submits them. Scorsync does not adjudicate, recompute or correct a score — corrections come from the meet director.
- There is no historical archive endpoint that returns every meet ever scored. Read the sitemap for addressable meets and page through the search endpoints for the rest.
- Personal contact details for athletes, coaches and families are never published and are not available through any endpoint at any scope.

How to call Scorsync: start with no credential. The public read endpoints require no account, no key and no approval — GET /api/meets/search?query=, /api/athletes/search?query=, /api/clubs/search?query= and /api/results/latest all return JSON to an anonymous client. Resolve an entity with a search endpoint, then read its page or detail endpoint by id. Full instructions for automated clients, including the credential ladder and the rules of engagement, are at https://scorsync.com/agents.md

Notes for automated clients:

- Every page listed below returns server-rendered HTML and a real HTTP status code. A path that does not exist returns 404, never a 200 shell.
- The HTTP API is described by an OpenAPI 3.1 document at https://scorsync.com/openapi.json
- Access is scoped: OAuth 2.0 scopes for coach-authorized clients, per-token abilities for personal access tokens, and per-meet tokens for live ingest. Request only the scopes you need.
- The public API is throttled at 360 requests per minute per client; back off on the X-RateLimit-Remaining and Retry-After headers.

## Developer resources

- [Scorsync developer resources](https://scorsync.com/developers): Index of every Scorsync API, authentication scheme and machine-readable file.
- [Scorsync OpenAPI 3.1 specification](https://scorsync.com/openapi.json): Machine-readable description of the Scorsync HTTP API, including every security scheme and OAuth scope.
- [OAuth 2.0 authorization server metadata](https://scorsync.com/.well-known/oauth-authorization-server): RFC 8414 metadata for the Scorsync authorization server: endpoints, supported scopes and PKCE methods.
- [Scorsync agent instructions](https://scorsync.com/agents.md): When to reach for Scorsync, the jobs it is the right tool for, and how an agent should call it.
- [Scorsync llms.txt](https://scorsync.com/llms.txt): Entry point for AI agents and LLM-powered clients, in the llmstxt.org format.
- [Scorsync sitemap](https://scorsync.com/sitemap.xml): XML sitemap of the stable public pages on scorsync.com.

## Site

- [Scorsync — live gymnastics meet results](https://scorsync.com): Live and final scores for trampoline, double mini, tumbling, rhythmic and acrobatic gymnastics competitions.
- [Meets](https://scorsync.com/meets): Every competition published on Scorsync, live, upcoming and concluded.
- [Athletes](https://scorsync.com/athletes): Athlete profiles with competition history, personal bests and qualification scores.
- [Clubs](https://scorsync.com/clubs): Club pages with rosters, team results, qualification and mobility tabs.
- [Rankings](https://scorsync.com/rankings): Season rankings by event, level and age group.
- [Qualifications](https://scorsync.com/qualifications): Qualification and mobility score lookups for USA Gymnastics T&T athletes.
- [Tools](https://scorsync.com/tools): Downloads and utilities for meet directors, judges and coaches.
- [FAQ](https://scorsync.com/faq): How Scorsync works for spectators, coaches and meet directors.
- [Scorsync for meet hosts](https://scorsync.com/marketing): Product overview for meet hosts, clubs and federations.
- [About Scorsync](https://scorsync.com/about): What Scorsync does, how a meet reaches the site, who uses it and what it costs.
- [Contact Scorsync](https://scorsync.com/contact): How to reach support, what to include and how quickly to expect a reply.
- [Privacy at Scorsync](https://scorsync.com/privacy): Plain-language summary of what Scorsync collects, athlete video removal and your rights.
- [What's new](https://scorsync.com/whats-new): Release notes for the Scorsync web and mobile apps.
- [Scorsync developer resources](https://scorsync.com/developers): API reference, OAuth scopes, MCP server and machine-readable files.

## Optional

- [Support](mailto:support@scorsync.com): Questions about the API, an integration or a meet.
