Athletes App Public API

All endpoints live under https://athletes.app/api/public/* and return JSON. They're designed for read-only embedding — list your events on a school site, render a roster on a club page, link straight to a hosted registration checkout — without ever needing to authenticate or store credentials in client-side code.

Find your account ID

Every endpoint requires an account_id query parameter. Find yours in the dashboard under Settings → Account. It's a UUID and it's safe to expose publicly — it acts as a tenant identifier, not a secret.

Base URL

https://athletes.app/api/public

None. The public API is unauthenticated by design. Only data explicitly marked public in the dashboard is returned:

• Events with is_published = true
• Teams with is_public = true, is_active = true, and level = varsity
• People with is_public = true on a public team

Anything else stays private even if you have the right account_id. Toggle visibility per-record from the dashboard.

All public endpoints respond with Access-Control-Allow-Origin: * and handle OPTIONS preflight requests. You can call them directly from any browser on any domain — no proxy server needed.

Responses are served with Cache-Control: public, s-maxage=60, stale-while-revalidate=300. CDNs and browsers cache results for 60 seconds, and may serve stale-but-fresh-enough responses for up to 5 minutes while the cache revalidates in the background. Updates you make in the dashboard typically appear within a minute.

Errors return a JSON body with an error field and a standard HTTP status code:

{
  "error": "account_id query parameter is required"
}

Three endpoints, all GET, all under /api/public.

• GET/api/public/events

  List published events with hosted registration URLs.

• GET/api/public/players

  List public players with profiles, awards, and stats.

• GET/api/public/teams

  List public teams with rosters and staff.

Browser / JavaScript

const ACCOUNT_ID = "00000000-0000-0000-0000-000000000000"

const res = await fetch(
  `https://athletes.app/api/public/events?account_id=${ACCOUNT_ID}`
)
const { events } = await res.json()

for (const event of events) {
  console.log(event.name, event.register_url)
}

React component

import { useEffect, useState } from "react"

const ACCOUNT_ID = "00000000-0000-0000-0000-000000000000"

export function UpcomingEvents() {
  const [events, setEvents] = useState([])

  useEffect(() => {
    fetch(`https://athletes.app/api/public/events?account_id=${ACCOUNT_ID}`)
      .then((r) => r.json())
      .then((data) => setEvents(data.events))
  }, [])

  return (
    <ul>
      {events.map((event) => (
        <li key={event.id}>
          <strong>{event.name}</strong>
          {event.registration_open && (
            <a href={event.register_url}> Register →</a>
          )}
        </li>
      ))}
    </ul>
  )
}

Server-side (Node)

const ACCOUNT_ID = process.env.ATHLETES_APP_ACCOUNT_ID

const res = await fetch(
  `https://athletes.app/api/public/players?account_id=${ACCOUNT_ID}`,
  { next: { revalidate: 60 } } // Next.js ISR
)
const { players } = await res.json()

Embed a registration link in HTML

For the simplest case — linking to a single event from a static site — skip the API entirely. Use the registration URL directly:

<a href="https://yourname.athletes.app/register/summer-camp-2026">
  Register for Summer Camp →
</a>

Or use /api/public/events?slug=summer-camp-2026 to fetch metadata first if you want to show the price, capacity, or disable the link when registration is closed.

• 2026-05-01GET /api/public/events: registration fields (fee_amount, capacity, register_url, etc.) are now populated for both camp and other events, not just camps. An other event with a fee or registration window is now exposed as registerable.
• 2026-05-01Extended GET /api/public/events to cover team-level practices and games. New filters: event_type, team_id, team_slug, starts_after, starts_before, limit. Each event now includes event_type, team, arrival_time, and (for games) opponent_name + is_home.
• 2026-04-28Added GET /api/public/events with register_url for hosted checkout embedding.
• EarlierInitial release of GET /api/public/players and GET /api/public/teams.