All Court Pro

API Reference

The All Court Pro API lets club owners and league managers automate what they already do in the product — members, socials, seasons, and divisions — over a stable HTTP interface. Leagues support a multi-sport catalog with profile-driven scoring (sets, race-to, final score, and win/loss).

Base URLhttps://www.allcourt.pro/api/v1

Rate limit60 requests / minute / key

Create a key in Settings → Developer API. Keys are shown once and hashed at rest. Use Copy for AI to paste this entire reference into ChatGPT, Cursor, or similar as Markdown.

Authentication

Authenticate with an API key using the Authorization header. You can also pass the key via X-Api-Key.

Scopes available on each key:

club:read
club:write
league:read
league:write
court:read
court:write

Each endpoint documents the required scope. Missing scopes return 403 with code forbidden.

Errors

All responses use a consistent envelope. Successful calls return data (and optional meta for pagination). Failures return an error object.

Code	Meaning
`unauthorized`	Missing or invalid API key
`forbidden`	Insufficient scope or permission
`not_found`	Resource does not exist
`bad_request`	Invalid parameters
`rate_limited`	Too many requests for this key

JSON

{
  "error": {
    "code": "forbidden",
    "message": "Only club owners can edit club details."
  }
}

SUCCESS

{
  "data": { … },
  "meta": {
    "page": 1,
    "page_size": 10,
    "total": 42
  }
}

Sports & scoring

Leagues and matches use a built-in sport catalog. Pass the sport id when creating or updating a league. Match results are stored as score_text; validation follows the sport’s default scoring profile (or the match’s scoring_profile_id when set). Formats such as singles, doubles, or team_5v5 are stored as format_id.

Scoring kinds

Kind	score_text examples	Used by
`sets` Best-of series of set or game lines. Stored as comma-separated pairs in score_text (optional tiebreak paren for tennis 7-6).	`6-4, 6-3` `21-18, 21-19` `25-22, 25-20, 15-13`	`tennispadelbadmintonsquashtable_tennisracquetballvolleyballbeach_volleyball`
`race_to` Games to a target score with a win-by margin (e.g. pickleball to 11, win by 2).	`11-7, 11-9` `12-10, 9-11, 11-8`	`pickleball`
`final_score` Single home–away total for the match. Higher score wins, except golf stroke play where lower wins. Draws only when the profile allows them.	`98-95` `2-1` `72-75`	`basketballfootballfutsalhockeyrugbyamerican_footballnetballgolfbowlingdarts`
`win_loss` Result without points: home win, away win, or draw (where allowed).	`W-L` `L-W` `DRAW` `1-0` `0-1`	`chess`

Supported sports

Racket

Id	Sport	Default scoring	Example score_text	Formats
`tennis`	Tennis	`sets` Best of 3 sets	`6-4, 6-3`	`singlesdoublestriples`
`padel`	Padel	`sets` Best of 3 sets	`6-4, 6-3`	`doublessingles`
`pickleball`	Pickleball	`race_to` Games to 11 (win by 2)	`11-9, 11-9`	`singlesdoublestriples`
`badminton`	Badminton	`sets` Best of 3 games to 21	`21-19, 21-19`	`singlesdoubles`
`squash`	Squash	`sets` Best of 5 games to 11	`11-9, 11-9, 11-9`	`singlesdoubles`
`table_tennis`	Table tennis	`sets` Best of 5 games to 11	`11-9, 11-9, 11-9`	`singlesdoubles`
`racquetball`	Racquetball	`sets` Best of 3 games to 15	`15-13, 15-13`	`singlesdoubles`

Court / net

Id	Sport	Default scoring	Example score_text	Formats
`volleyball`	Volleyball	`sets` Best of 5 sets to 25	`25-23, 25-23, 25-23`	`team_6v6`
`beach_volleyball`	Beach volleyball	`sets` Best of 3 sets to 21	`21-19, 21-19`	`doubles`

Team

Id	Sport	Default scoring	Example score_text	Formats
`basketball`	Basketball	`final_score` Final score	`2-1`	`team_5v5`
`football`	Football (soccer)	`final_score` Final score	`2-1`	`team_11v11team_7v7`
`futsal`	Futsal	`final_score` Final score	`2-1`	`team_5v5`
`hockey`	Hockey	`final_score` Final score	`2-1`	`team_6v6`
`rugby`	Rugby	`final_score` Final score	`2-1`	`team_15v15team_7v7`
`american_football`	American football	`final_score` Final score	`2-1`	`team_11v11`
`netball`	Netball	`final_score` Final score	`2-1`	`team_7v7`

Other

Id	Sport	Default scoring	Example score_text	Formats
`golf`	Golf	`final_score` Stroke play (lower wins)	`72-75`	`free_for_allmatch_play`
`bowling`	Bowling	`final_score` Final score	`2-1`	`free_for_all`
`darts`	Darts	`final_score` Final score	`2-1`	`singlesdoubles`
`chess`	Chess	`win_loss` Win / loss / draw	`W-L`	`singles`

Clubs

List and manage clubs you own or admin. Requires club:read or club:write.

GET/clubs

List clubs

Returns clubs where the API key owner is an owner or admin. Not a public discovery search.

Scope club:read

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "clubs": [
      {
        "id": "…",
        "name": "Official AllCourt Pro",
        "slug": "officialallcourtpro",
        "role": "owner",
        "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
      }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "clubs": [
      {
        "id": "…",
        "name": "Official AllCourt Pro",
        "slug": "officialallcourtpro",
        "role": "owner",
        "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
      }
    ]
  }
}

GET/clubs/search

Search clubs

Discover active All Court Pro clubs by name, location, slug, or description (e.g. q=Hackney). Use this for “find a club in …”, not GET /clubs.

Scope club:read

Parameters

Parameter	Type	Description
`q`requiredquery	`string`	Search query (min 2 characters)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/search \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "q": "Hackney",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/search \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "q": "Hackney",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  }
}

GET/clubs/{slug}

Retrieve a club

Fetch club details, active leagues, and members.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug / Club ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "club": { "id": "…", "name": "…", "slug": "…" },
    "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }],
    "members": []
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "club": { "id": "…", "name": "…", "slug": "…" },
    "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }],
    "members": []
  }
}

PATCH/clubs/{slug}

Update a club

Update club details (owner) or social links (owner/admin).

Scope club:write

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`name`body	`string`	Display name
`description`body	`string`	Club description
`location`body	`string`	Location label
`social_links`body	`object`	Social profile URLs

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Official AllCourt Pro",
  "description": "Community club"
}'

{
  "data": {
    "club": { "id": "…", "name": "Official AllCourt Pro" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Official AllCourt Pro",
  "description": "Community club"
}'

RESPONSE

{
  "data": {
    "club": { "id": "…", "name": "Official AllCourt Pro" }
  }
}

GET/clubs/{slug}/members

List club members

Paginated members for a club.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (max 50)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/members \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "members": [{ "user_id": "…", "role": "member" }] },
  "meta": { "page": 1, "page_size": 10, "total": 42 }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/members \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "members": [{ "user_id": "…", "role": "member" }] },
  "meta": { "page": 1, "page_size": 10, "total": 42 }
}

POST/clubs/{slug}/socials

Create a social

Create a club social event and feed post. Optional paid entry requires Stripe Connect.

Scope club:write

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`title`requiredbody	`string`	Event title
`game_date`requiredbody	`string`	YYYY-MM-DD
`game_time`requiredbody	`string`	HH:MM or HH:MM:SS
`location`requiredbody	`string`	Venue name
`open_rsvp`body	`boolean`	Open RSVP (default true)
`sport`body	`string`	Optional sport catalog id (defaults to tennis). See Sports & scoring.

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/socials \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Friday social",
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Queens Club",
  "open_rsvp": true,
  "sport": "padel"
}'

{
  "data": {
    "post": { "id": "…", "post_type": "social" },
    "match": { "id": "…", "status": "open" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/socials \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Friday social",
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Queens Club",
  "open_rsvp": true,
  "sport": "padel"
}'

RESPONSE

{
  "data": {
    "post": { "id": "…", "post_type": "social" },
    "match": { "id": "…", "status": "open" }
  }
}

GET/clubs/{slug}/posts

List club posts

Paginated club feed posts with comments.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`page`query	`integer`	Page number
`pageSize`query	`integer`	Page size

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "posts": [] },
  "meta": { "page": 1, "page_size": 24, "total": 0 }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "posts": [] },
  "meta": { "page": 1, "page_size": 24, "total": 0 }
}

POST/clubs/{slug}/posts

Create a post

Create an announcement or photo post. Photo posts require image URLs.

Scope club:write

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`post_type`requiredbody	`string`	photo \| announcement
`caption`body	`string`	Post text
`image_urls`body	`string[]`	Image URLs for photo posts

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "post_type": "announcement",
  "caption": "Courts reopen Monday"
}'

{
  "data": {
    "post": { "id": "…", "post_type": "announcement" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "post_type": "announcement",
  "caption": "Courts reopen Monday"
}'

RESPONSE

{
  "data": {
    "post": { "id": "…", "post_type": "announcement" }
  }
}

GET/clubs/{slug}/leagues

List club leagues

Paginated leagues belonging to a club. Optional search with q.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`q`query	`string`	Search name, location, or sport
`page`query	`integer`	Page number

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/leagues \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }], "q": "" },
  "meta": { "page": 1, "page_size": 10, "total": 0 }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/leagues \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }], "q": "" },
  "meta": { "page": 1, "page_size": 10, "total": 0 }
}

Leagues

Manage leagues, seasons, divisions, and participants. Requires league:read or league:write. League sport must be a catalog id (see Sports & scoring). League objects include a public `url` to the app page.

GET/leagues/{id}

Retrieve a league

Fetch a league you can manage (creator, club admin, or super-admin). Includes `url` and `club_id`. To learn which club runs a league you do not manage, use GET /leagues/{id}/club instead.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "league": {
      "id": "…",
      "name": "Spring Flex",
      "sport": "tennis",
      "club_id": "…",
      "url": "https://www.allcourt.pro/app/leagues/…"
    }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "league": {
      "id": "…",
      "name": "Spring Flex",
      "sport": "tennis",
      "club_id": "…",
      "url": "https://www.allcourt.pro/app/leagues/…"
    }
  }
}

GET/leagues/{id}/club

Get club that runs a league

Resolve which club owns/runs a league (and therefore its seasons). Requires league:read but does **not** require manage access — use this for “what club runs this league/season?”. Returns `club` with `name`, `slug`, and public `url`, plus the league summary.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/club \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "league": {
      "id": "…",
      "name": "Hackney · Tennis",
      "url": "https://www.allcourt.pro/app/leagues/…"
    },
    "club": {
      "id": "…",
      "name": "Official Allcourt Pro",
      "slug": "officialallcourtpro",
      "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
    }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/club \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "league": {
      "id": "…",
      "name": "Hackney · Tennis",
      "url": "https://www.allcourt.pro/app/leagues/…"
    },
    "club": {
      "id": "…",
      "name": "Official Allcourt Pro",
      "slug": "officialallcourtpro",
      "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
    }
  }
}

PATCH/leagues/{id}

Update a league

Update league metadata, privacy, sport, or club assignment.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`name`body	`string`	League name
`is_active`body	`boolean`	Active flag
`sport`body	`string`	Sport catalog id (tennis, padel, pickleball, badminton, squash, table_tennis, racquetball, volleyball, beach_volleyball, basketball, football, futsal, hockey, rugby, american_football, netball, golf, bowling, darts, chess). See Sports & scoring.

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring Flex",
  "is_active": true
}'

{
  "data": {
    "league": { "id": "…", "name": "Spring Flex", "url": "https://www.allcourt.pro/app/leagues/…" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring Flex",
  "is_active": true
}'

RESPONSE

{
  "data": {
    "league": { "id": "…", "name": "Spring Flex", "url": "https://www.allcourt.pro/app/leagues/…" }
  }
}

GET/leagues/{id}/seasons

List seasons

List all seasons for a league.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "seasons": [
      { "id": "…", "name": "Season 1", "start_date": "2026-04-01" }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "seasons": [
      { "id": "…", "name": "Season 1", "start_date": "2026-04-01" }
    ]
  }
}

POST/leagues/{id}/seasons

Create a season

Create a season. Paid entry fees require a connected Stripe account.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`start_date`requiredbody	`string`	YYYY-MM-DD
`end_date`requiredbody	`string`	YYYY-MM-DD
`registration_deadline`requiredbody	`string`	YYYY-MM-DD
`entry_fee`body	`number`	Fee amount (default 0)
`currency`body	`string`	ISO currency (default USD)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "start_date": "2026-06-01",
  "end_date": "2026-08-31",
  "registration_deadline": "2026-05-25",
  "entry_fee": 0
}'

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "start_date": "2026-06-01",
  "end_date": "2026-08-31",
  "registration_deadline": "2026-05-25",
  "entry_fee": 0
}'

RESPONSE

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

GET/leagues/{id}/seasons/{seasonId}

Retrieve a season

Season details including divisions.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" },
    "divisions": []
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" },
    "divisions": []
  }
}

PATCH/leagues/{id}/seasons/{seasonId}

Update a season

Update dates, fees, name, or late registration.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID
`name`body	`string`	Season name
`entry_fee`body	`number`	Entry fee

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "late_registration": true
}'

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "late_registration": true
}'

RESPONSE

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

GET/leagues/{id}/seasons/{seasonId}/divisions

List divisions

Divisions in a season ordered by sort_order.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "divisions": [{ "id": "…", "name": "Division A", "sort_order": 0 }]
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "divisions": [{ "id": "…", "name": "Division A", "sort_order": 0 }]
  }
}

POST/leagues/{id}/seasons/{seasonId}/divisions

Create a division

Create a division and its group chat.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID
`name`requiredbody	`string`	Division name
`sort_order`body	`integer`	Display order

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Division A",
  "sort_order": 0
}'

{
  "data": {
    "division": { "id": "…", "name": "Division A" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Division A",
  "sort_order": 0
}'

RESPONSE

{
  "data": {
    "division": { "id": "…", "name": "Division A" }
  }
}

GET/leagues/{id}/participants

List participants

Paginated league members with public profile summary fields.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`page`query	`integer`	Page number
`pageSize`query	`integer`	Page size

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/participants \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "participants": [] },
  "meta": { "page": 1, "page_size": 20, "total": 0 }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/participants \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "participants": [] },
  "meta": { "page": 1, "page_size": 20, "total": 0 }
}

Courts & Kings of the Court

Read the Kings of the Court map and claim or pass crowns. Requires court:read or court:write. Each court includes `map_url` — a deep link into the friendly map centered on that court.

GET/courts/map

List courts in a map area

Return tennis courts near a place or inside a bounding box (same pins as /app/friendly). Prefer `q` (e.g. London) for place search — fast sample with claimed kings. Explicit bbox uses the full kings RPC. Each court includes `king` (or null) and `map_url`.

Scope court:read

Parameters

Parameter	Type	Description
`q`query	`string`	City or place name (preferred). Geocoded to a bbox.
`south`query	`number`	South latitude (if not using q)
`north`query	`number`	North latitude (if not using q)
`west`query	`number`	West longitude (if not using q)
`east`query	`number`	East longitude (if not using q)
`zoom`query	`number`	Map zoom (controls result limit)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/map \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "place": {
      "query": "London",
      "display_name": "London, Greater London, England, United Kingdom",
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.507&share_lng=-0.128&share_z=12"
    },
    "courts": [
      {
        "id": "…",
        "name": "Queens Club Court 1",
        "lat": 51.487,
        "lng": -0.212,
        "king": {
          "user_id": "…",
          "full_name": "Alex",
          "wins": 3,
          "claimed": false
        },
        "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
      }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/map \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "place": {
      "query": "London",
      "display_name": "London, Greater London, England, United Kingdom",
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.507&share_lng=-0.128&share_z=12"
    },
    "courts": [
      {
        "id": "…",
        "name": "Queens Club Court 1",
        "lat": 51.487,
        "lng": -0.212,
        "king": {
          "user_id": "…",
          "full_name": "Alex",
          "wins": 3,
          "claimed": false
        },
        "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
      }
    ]
  }
}

GET/courts/{courtId}

Retrieve a court

Fetch a single court with its current king and map deep link.

Scope court:read

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/{courtId} \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "court": {
      "id": "…",
      "name": "Queens Club Court 1",
      "lat": 51.487,
      "lng": -0.212,
      "king": null,
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
    }
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/{courtId} \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "court": {
      "id": "…",
      "name": "Queens Club Court 1",
      "lat": 51.487,
      "lng": -0.212,
      "king": null,
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
    }
  }
}

POST/courts/{courtId}/claim-king

Claim king of the court

Claim an unclaimed court as the API key owner. Fails if the court already has a king or wins-based king from completed matches.

Scope court:write

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/{courtId}/claim-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:00:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/{courtId}/claim-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

RESPONSE

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:00:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}

POST/courts/{courtId}/pass-king

Pass the crown

Transfer the king claim to another player. Only the current claim holder can pass (unless super-admin). Wins-based kings cannot be passed.

Scope court:write

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court ID
`to_user_id`requiredbody	`uuid`	Recipient user ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/{courtId}/pass-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "to_user_id": "user-uuid"
}'

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:05:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/{courtId}/pass-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "to_user_id": "user-uuid"
}'

RESPONSE

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:05:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}

All Court Pro

API Reference

Base URLhttps://www.allcourt.pro/api/v1

Rate limit60 requests / minute / key

Create a key in Settings → Developer API. Keys are shown once and hashed at rest. Use Copy for AI to paste this entire reference into ChatGPT, Cursor, or similar as Markdown.

Authentication

Authenticate with an API key using the Authorization header. You can also pass the key via X-Api-Key.

Scopes available on each key:

club:read
club:write
league:read
league:write
court:read
court:write

Each endpoint documents the required scope. Missing scopes return 403 with code forbidden.

Errors

All responses use a consistent envelope. Successful calls return data (and optional meta for pagination). Failures return an error object.

Code	Meaning
`unauthorized`	Missing or invalid API key
`forbidden`	Insufficient scope or permission
`not_found`	Resource does not exist
`bad_request`	Invalid parameters
`rate_limited`	Too many requests for this key

JSON

{
  "error": {
    "code": "forbidden",
    "message": "Only club owners can edit club details."
  }
}

SUCCESS

{
  "data": { … },
  "meta": {
    "page": 1,
    "page_size": 10,
    "total": 42
  }
}

Sports & scoring

Scoring kinds

Kind	score_text examples	Used by
`sets` Best-of series of set or game lines. Stored as comma-separated pairs in score_text (optional tiebreak paren for tennis 7-6).	`6-4, 6-3` `21-18, 21-19` `25-22, 25-20, 15-13`	`tennispadelbadmintonsquashtable_tennisracquetballvolleyballbeach_volleyball`
`race_to` Games to a target score with a win-by margin (e.g. pickleball to 11, win by 2).	`11-7, 11-9` `12-10, 9-11, 11-8`	`pickleball`
`final_score` Single home–away total for the match. Higher score wins, except golf stroke play where lower wins. Draws only when the profile allows them.	`98-95` `2-1` `72-75`	`basketballfootballfutsalhockeyrugbyamerican_footballnetballgolfbowlingdarts`
`win_loss` Result without points: home win, away win, or draw (where allowed).	`W-L` `L-W` `DRAW` `1-0` `0-1`	`chess`

Supported sports

Racket

Id	Sport	Default scoring	Example score_text	Formats
`tennis`	Tennis	`sets` Best of 3 sets	`6-4, 6-3`	`singlesdoublestriples`
`padel`	Padel	`sets` Best of 3 sets	`6-4, 6-3`	`doublessingles`
`pickleball`	Pickleball	`race_to` Games to 11 (win by 2)	`11-9, 11-9`	`singlesdoublestriples`
`badminton`	Badminton	`sets` Best of 3 games to 21	`21-19, 21-19`	`singlesdoubles`
`squash`	Squash	`sets` Best of 5 games to 11	`11-9, 11-9, 11-9`	`singlesdoubles`
`table_tennis`	Table tennis	`sets` Best of 5 games to 11	`11-9, 11-9, 11-9`	`singlesdoubles`
`racquetball`	Racquetball	`sets` Best of 3 games to 15	`15-13, 15-13`	`singlesdoubles`

Court / net

Id	Sport	Default scoring	Example score_text	Formats
`volleyball`	Volleyball	`sets` Best of 5 sets to 25	`25-23, 25-23, 25-23`	`team_6v6`
`beach_volleyball`	Beach volleyball	`sets` Best of 3 sets to 21	`21-19, 21-19`	`doubles`

Team

Id	Sport	Default scoring	Example score_text	Formats
`basketball`	Basketball	`final_score` Final score	`2-1`	`team_5v5`
`football`	Football (soccer)	`final_score` Final score	`2-1`	`team_11v11team_7v7`
`futsal`	Futsal	`final_score` Final score	`2-1`	`team_5v5`
`hockey`	Hockey	`final_score` Final score	`2-1`	`team_6v6`
`rugby`	Rugby	`final_score` Final score	`2-1`	`team_15v15team_7v7`
`american_football`	American football	`final_score` Final score	`2-1`	`team_11v11`
`netball`	Netball	`final_score` Final score	`2-1`	`team_7v7`

Other

Id	Sport	Default scoring	Example score_text	Formats
`golf`	Golf	`final_score` Stroke play (lower wins)	`72-75`	`free_for_allmatch_play`
`bowling`	Bowling	`final_score` Final score	`2-1`	`free_for_all`
`darts`	Darts	`final_score` Final score	`2-1`	`singlesdoubles`
`chess`	Chess	`win_loss` Win / loss / draw	`W-L`	`singles`

Clubs

List and manage clubs you own or admin. Requires club:read or club:write.

GET/clubs

List clubs

Returns clubs where the API key owner is an owner or admin. Not a public discovery search.

Scope club:read

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "clubs": [
      {
        "id": "…",
        "name": "Official AllCourt Pro",
        "slug": "officialallcourtpro",
        "role": "owner",
        "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
      }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "clubs": [
      {
        "id": "…",
        "name": "Official AllCourt Pro",
        "slug": "officialallcourtpro",
        "role": "owner",
        "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
      }
    ]
  }
}

GET/clubs/search

Search clubs

Discover active All Court Pro clubs by name, location, slug, or description (e.g. q=Hackney). Use this for “find a club in …”, not GET /clubs.

Scope club:read

Parameters

Parameter	Type	Description
`q`requiredquery	`string`	Search query (min 2 characters)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/search \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "q": "Hackney",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/search \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "q": "Hackney",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  }
}

GET/clubs/{slug}

Retrieve a club

Fetch club details, active leagues, and members.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug / Club ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "club": { "id": "…", "name": "…", "slug": "…" },
    "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }],
    "members": []
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "club": { "id": "…", "name": "…", "slug": "…" },
    "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }],
    "members": []
  }
}

PATCH/clubs/{slug}

Update a club

Update club details (owner) or social links (owner/admin).

Scope club:write

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`name`body	`string`	Display name
`description`body	`string`	Club description
`location`body	`string`	Location label
`social_links`body	`object`	Social profile URLs

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Official AllCourt Pro",
  "description": "Community club"
}'

{
  "data": {
    "club": { "id": "…", "name": "Official AllCourt Pro" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Official AllCourt Pro",
  "description": "Community club"
}'

RESPONSE

{
  "data": {
    "club": { "id": "…", "name": "Official AllCourt Pro" }
  }
}

GET/clubs/{slug}/members

List club members

Paginated members for a club.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (max 50)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/members \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "members": [{ "user_id": "…", "role": "member" }] },
  "meta": { "page": 1, "page_size": 10, "total": 42 }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/members \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "members": [{ "user_id": "…", "role": "member" }] },
  "meta": { "page": 1, "page_size": 10, "total": 42 }
}

POST/clubs/{slug}/socials

Create a social

Create a club social event and feed post. Optional paid entry requires Stripe Connect.

Scope club:write

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`title`requiredbody	`string`	Event title
`game_date`requiredbody	`string`	YYYY-MM-DD
`game_time`requiredbody	`string`	HH:MM or HH:MM:SS
`location`requiredbody	`string`	Venue name
`open_rsvp`body	`boolean`	Open RSVP (default true)
`sport`body	`string`	Optional sport catalog id (defaults to tennis). See Sports & scoring.

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/socials \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Friday social",
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Queens Club",
  "open_rsvp": true,
  "sport": "padel"
}'

{
  "data": {
    "post": { "id": "…", "post_type": "social" },
    "match": { "id": "…", "status": "open" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/socials \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Friday social",
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Queens Club",
  "open_rsvp": true,
  "sport": "padel"
}'

RESPONSE

{
  "data": {
    "post": { "id": "…", "post_type": "social" },
    "match": { "id": "…", "status": "open" }
  }
}

GET/clubs/{slug}/posts

List club posts

Paginated club feed posts with comments.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`page`query	`integer`	Page number
`pageSize`query	`integer`	Page size

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "posts": [] },
  "meta": { "page": 1, "page_size": 24, "total": 0 }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "posts": [] },
  "meta": { "page": 1, "page_size": 24, "total": 0 }
}

POST/clubs/{slug}/posts

Create a post

Create an announcement or photo post. Photo posts require image URLs.

Scope club:write

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`post_type`requiredbody	`string`	photo \| announcement
`caption`body	`string`	Post text
`image_urls`body	`string[]`	Image URLs for photo posts

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "post_type": "announcement",
  "caption": "Courts reopen Monday"
}'

{
  "data": {
    "post": { "id": "…", "post_type": "announcement" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/posts \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "post_type": "announcement",
  "caption": "Courts reopen Monday"
}'

RESPONSE

{
  "data": {
    "post": { "id": "…", "post_type": "announcement" }
  }
}

GET/clubs/{slug}/leagues

List club leagues

Paginated leagues belonging to a club. Optional search with q.

Scope club:read

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`q`query	`string`	Search name, location, or sport
`page`query	`integer`	Page number

curlRESPONSE

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/leagues \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }], "q": "" },
  "meta": { "page": 1, "page_size": 10, "total": 0 }
}

curl

curl https://www.allcourt.pro/api/v1/clubs/your-club-slug/leagues \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "leagues": [{ "id": "…", "name": "…", "url": "https://www.allcourt.pro/app/leagues/…" }], "q": "" },
  "meta": { "page": 1, "page_size": 10, "total": 0 }
}

Leagues

GET/leagues/{id}

Retrieve a league

Fetch a league you can manage (creator, club admin, or super-admin). Includes `url` and `club_id`. To learn which club runs a league you do not manage, use GET /leagues/{id}/club instead.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "league": {
      "id": "…",
      "name": "Spring Flex",
      "sport": "tennis",
      "club_id": "…",
      "url": "https://www.allcourt.pro/app/leagues/…"
    }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "league": {
      "id": "…",
      "name": "Spring Flex",
      "sport": "tennis",
      "club_id": "…",
      "url": "https://www.allcourt.pro/app/leagues/…"
    }
  }
}

GET/leagues/{id}/club

Get club that runs a league

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/club \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "league": {
      "id": "…",
      "name": "Hackney · Tennis",
      "url": "https://www.allcourt.pro/app/leagues/…"
    },
    "club": {
      "id": "…",
      "name": "Official Allcourt Pro",
      "slug": "officialallcourtpro",
      "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
    }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/club \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "league": {
      "id": "…",
      "name": "Hackney · Tennis",
      "url": "https://www.allcourt.pro/app/leagues/…"
    },
    "club": {
      "id": "…",
      "name": "Official Allcourt Pro",
      "slug": "officialallcourtpro",
      "url": "https://www.allcourt.pro/app/clubs/officialallcourtpro"
    }
  }
}

PATCH/leagues/{id}

Update a league

Update league metadata, privacy, sport, or club assignment.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`name`body	`string`	League name
`is_active`body	`boolean`	Active flag
`sport`body	`string`	Sport catalog id (tennis, padel, pickleball, badminton, squash, table_tennis, racquetball, volleyball, beach_volleyball, basketball, football, futsal, hockey, rugby, american_football, netball, golf, bowling, darts, chess). See Sports & scoring.

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring Flex",
  "is_active": true
}'

{
  "data": {
    "league": { "id": "…", "name": "Spring Flex", "url": "https://www.allcourt.pro/app/leagues/…" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring Flex",
  "is_active": true
}'

RESPONSE

{
  "data": {
    "league": { "id": "…", "name": "Spring Flex", "url": "https://www.allcourt.pro/app/leagues/…" }
  }
}

GET/leagues/{id}/seasons

List seasons

List all seasons for a league.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "seasons": [
      { "id": "…", "name": "Season 1", "start_date": "2026-04-01" }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "seasons": [
      { "id": "…", "name": "Season 1", "start_date": "2026-04-01" }
    ]
  }
}

POST/leagues/{id}/seasons

Create a season

Create a season. Paid entry fees require a connected Stripe account.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`start_date`requiredbody	`string`	YYYY-MM-DD
`end_date`requiredbody	`string`	YYYY-MM-DD
`registration_deadline`requiredbody	`string`	YYYY-MM-DD
`entry_fee`body	`number`	Fee amount (default 0)
`currency`body	`string`	ISO currency (default USD)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "start_date": "2026-06-01",
  "end_date": "2026-08-31",
  "registration_deadline": "2026-05-25",
  "entry_fee": 0
}'

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "start_date": "2026-06-01",
  "end_date": "2026-08-31",
  "registration_deadline": "2026-05-25",
  "entry_fee": 0
}'

RESPONSE

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

GET/leagues/{id}/seasons/{seasonId}

Retrieve a season

Season details including divisions.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" },
    "divisions": []
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" },
    "divisions": []
  }
}

PATCH/leagues/{id}/seasons/{seasonId}

Update a season

Update dates, fees, name, or late registration.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID
`name`body	`string`	Season name
`entry_fee`body	`number`	Entry fee

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "late_registration": true
}'

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id \
  -X PATCH \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Summer 2026",
  "late_registration": true
}'

RESPONSE

{
  "data": {
    "season": { "id": "…", "name": "Summer 2026" }
  }
}

GET/leagues/{id}/seasons/{seasonId}/divisions

List divisions

Divisions in a season ordered by sort_order.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "divisions": [{ "id": "…", "name": "Division A", "sort_order": 0 }]
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "divisions": [{ "id": "…", "name": "Division A", "sort_order": 0 }]
  }
}

POST/leagues/{id}/seasons/{seasonId}/divisions

Create a division

Create a division and its group chat.

Scope league:write

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`seasonId`requiredpath	`uuid`	Season ID
`name`requiredbody	`string`	Division name
`sort_order`body	`integer`	Display order

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Division A",
  "sort_order": 0
}'

{
  "data": {
    "division": { "id": "…", "name": "Division A" }
  }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id/divisions \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Division A",
  "sort_order": 0
}'

RESPONSE

{
  "data": {
    "division": { "id": "…", "name": "Division A" }
  }
}

GET/leagues/{id}/participants

List participants

Paginated league members with public profile summary fields.

Scope league:read

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League ID
`page`query	`integer`	Page number
`pageSize`query	`integer`	Page size

curlRESPONSE

curl https://www.allcourt.pro/api/v1/leagues/league-id/participants \
  -H "Authorization: Bearer acp_live_…"

{
  "data": { "participants": [] },
  "meta": { "page": 1, "page_size": 20, "total": 0 }
}

curl

curl https://www.allcourt.pro/api/v1/leagues/league-id/participants \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": { "participants": [] },
  "meta": { "page": 1, "page_size": 20, "total": 0 }
}

Courts & Kings of the Court

Read the Kings of the Court map and claim or pass crowns. Requires court:read or court:write. Each court includes `map_url` — a deep link into the friendly map centered on that court.

GET/courts/map

List courts in a map area

Scope court:read

Parameters

Parameter	Type	Description
`q`query	`string`	City or place name (preferred). Geocoded to a bbox.
`south`query	`number`	South latitude (if not using q)
`north`query	`number`	North latitude (if not using q)
`west`query	`number`	West longitude (if not using q)
`east`query	`number`	East longitude (if not using q)
`zoom`query	`number`	Map zoom (controls result limit)

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/map \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "place": {
      "query": "London",
      "display_name": "London, Greater London, England, United Kingdom",
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.507&share_lng=-0.128&share_z=12"
    },
    "courts": [
      {
        "id": "…",
        "name": "Queens Club Court 1",
        "lat": 51.487,
        "lng": -0.212,
        "king": {
          "user_id": "…",
          "full_name": "Alex",
          "wins": 3,
          "claimed": false
        },
        "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
      }
    ]
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/map \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "place": {
      "query": "London",
      "display_name": "London, Greater London, England, United Kingdom",
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.507&share_lng=-0.128&share_z=12"
    },
    "courts": [
      {
        "id": "…",
        "name": "Queens Club Court 1",
        "lat": 51.487,
        "lng": -0.212,
        "king": {
          "user_id": "…",
          "full_name": "Alex",
          "wins": 3,
          "claimed": false
        },
        "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
      }
    ]
  }
}

GET/courts/{courtId}

Retrieve a court

Fetch a single court with its current king and map deep link.

Scope court:read

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/{courtId} \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "court": {
      "id": "…",
      "name": "Queens Club Court 1",
      "lat": 51.487,
      "lng": -0.212,
      "king": null,
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
    }
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/{courtId} \
  -H "Authorization: Bearer acp_live_…"

RESPONSE

{
  "data": {
    "court": {
      "id": "…",
      "name": "Queens Club Court 1",
      "lat": 51.487,
      "lng": -0.212,
      "king": null,
      "map_url": "https://www.allcourt.pro/app/friendly?share_lat=51.487&share_lng=-0.212&share_z=16"
    }
  }
}

POST/courts/{courtId}/claim-king

Claim king of the court

Claim an unclaimed court as the API key owner. Fails if the court already has a king or wins-based king from completed matches.

Scope court:write

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/{courtId}/claim-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:00:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/{courtId}/claim-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

RESPONSE

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:00:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}

POST/courts/{courtId}/pass-king

Pass the crown

Transfer the king claim to another player. Only the current claim holder can pass (unless super-admin). Wins-based kings cannot be passed.

Scope court:write

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court ID
`to_user_id`requiredbody	`uuid`	Recipient user ID

curlRESPONSE

curl https://www.allcourt.pro/api/v1/courts/{courtId}/pass-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "to_user_id": "user-uuid"
}'

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:05:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}

curl

curl https://www.allcourt.pro/api/v1/courts/{courtId}/pass-king \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "to_user_id": "user-uuid"
}'

RESPONSE

{
  "data": {
    "king": { "user_id": "…", "full_name": "…", "wins": 0, "claimed": true },
    "king_claimed_at": "2026-07-20T14:05:00.000Z",
    "map_url": "https://www.allcourt.pro/app/friendly?share_lat=…&share_lng=…&share_z=16"
  }
}