FullOut Partner API & Embeds

GET/api/v1/scores/recent

The freshest score updates (the same feed behind our live page), newest first. Params: limit (1–50, default 20), cursor (from meta.nextCursor), after (ISO timestamp; only newer items).

{
  "data": [
    {
      "id": "…", "sortAt": "2026-07-04T16:20:00.000Z", "round": "Finals", "placement": 1,
      "team": { "id": "…", "name": "Cheetahs", "gym": { "name": "Cheer Athletics", … } },
      "competition": { "id": "…", "name": "The Summit", "slug": "the-summit-2026", "date": "…" },
      "division": { "name": "L5 Senior Small", "level": "L5", … },
      "score": { "totalScore": 98.75, "finalScore": 98.4, "totalDeductions": 0.25 }
    }
  ],
  "meta": { "nextCursor": "2026-07-04T15:58:11.000Z" }
}

GET/api/v1/competitions

Competition listings. Params: status (upcoming | recent), state (e.g. TX), producer (producer slug, e.g. varsity), discipline (name from /api/v1/disciplines, case-insensitive), limit (1–100), cursor. Filters combine.

# Upcoming Varsity events in Texas
GET /api/v1/competitions?producer=varsity&state=TX&status=upcoming

# Recent All Star Cheer competitions
GET /api/v1/competitions?discipline=All%20Star%20Cheer&status=recent

GET/api/v1/competitions/{'{id-or-slug}'}

One competition with full results grouped by division: placement, team, gym, round, scores, and each division's discipline. Add ?division=<id | slug | exact name> to return just one division. 404 if unknown.

# All divisions
GET /api/v1/competitions/the-summit-2026

# One division only
GET /api/v1/competitions/the-summit-2026?division=L5%20Senior%20Small

GET/api/v1/disciplines

Reference list of active disciplines (All Star Cheer, School Cheer, College Cheer, Dance, STUNT, …) — the valid values for the discipline filter.

GET/api/v1/people/search

Scope: profiles:read. Params: q (required, 2–64 characters), limit (1–50, default 10), opaque cursor, optional gym slug gym and gym state. Public profiles are ordered by creation time, newest first. Keep the filters unchanged when following meta.nextCursor. Cache: 10 minutes.

{ "data": [{ "id": "opaque-person-id", "name": "Katie Smith", "profileSlug": "katie-smith",
  "gym": { "name": "Cheer Athletics", "slug": "cheer-athletics" },
  "teams": [{ "name": "Cheetahs", "level": "L5", "season": "2025-26", "isCurrent": false }],
  "avatarUrl": null, "matchedAt": "2026-07-04T16:20:00.000Z" }], "meta": { "nextCursor": null } }

IDs are FullOut’s existing opaque IDs; do not assume a prefix. profileSlug is the profile username, falling back to its ID. matchedAt is the most recent public result posting or material score change during the person’s recorded team tenure, or null. Gym, avatar and level may also be null. Name search is for display and never establishes identity.

GET/api/v1/people/lookup?email=

Requires both profiles:read and identity:link. Exact, case-insensitive account email only. Returns the account’s own public person profile, never a child merely sharing its owner account. Missing, ambiguous or non-public identities return 404 not_found. No caching.

{ "data": { "id": "opaque-person-id", "name": "Katie Smith", "profileSlug": "katie-smith", "accountEmailVerified": true }, "meta": {} }

GET/api/v1/people/{id}

Scope: profiles:read. Accepts a person ID or profile slug. Returns the search profile fields, teams with isCurrent, and public placements with competition (name, slug, date), division (name, level), round, placement, and score (totalScore, finalScore). Private or unknown profiles return 404 not_found. Confidential producer results are always excluded. Cache: 10 minutes.

POST/api/v1/connect/sessions

Scope: identity:link. Redeem a code generated under Settings → Connections → Connect to Sessions in FullOut. Sessions must derive the account headers from its authenticated athlete account, never from a name search. Percent-encode the display-name header for non-ASCII text. No caching.

curl -X POST https://fullout.energy/api/v1/connect/sessions \
  -H "Authorization: Bearer fo_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Sessions-Account-Id: sessions-athlete-id" \
  -H "X-Sessions-Display-Name: Katie%20Smith" \
  -d '{"code":"K7QX-4M2P"}'

{ "data": { "person": { "id": "opaque-person-id", "name": "Katie Smith" },
  "linkedAccount": { "product": "sessions", "displayName": "Katie Smith" } }, "meta": {} }

POST/api/v1/connect/sessions/codes

To start in Sessions, send { "externalAccountId": "sessions-athlete-id", "displayName": "Katie Smith" } with the same scope and first-party key. Returns code, expiresAt, and a server-only receipt. The user enters the code in FullOut for their selected profile; a parent may select a child they manage.

GET/api/v1/connect/sessions

Poll a Sessions-issued code using the issuing key and X-Sessions-Receipt. Returns { "status": "pending" } or status: linked with person and linkedAccount. Poll before the ten-minute expiry; the receipt is not a reusable credential. No caching.