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, club socials, seasons, and divisions — over a stable HTTP interface. Any key owner can also create, list, and join Friendly Socials nearby games. 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 for the full Markdown reference, or Copy section on any endpoint for a single example (cURL, Node, Python, or HTTP).

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
social:read
social:write
profile:read

Each endpoint documents the required scope. Missing scopes return 403 with code forbidden. Operators can set DEVELOPER_API_WRITES_DISABLED=true to reject all API-key write methods (POST/PATCH/PUT/DELETE) while leaving reads available. Use DEVELOPER_API_POST_DISABLED=true or DEVELOPER_API_PATCH_DISABLED=true to block only that method.

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

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

Returns

Clubs the API key owner owns or admins (not a public discovery search). `{ data: { clubs: [{ id, name, slug, role, url }] } }`.

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 "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"
      }
    ]
  }
}

GET/clubs/search

Search clubs

Discover active clubs by fuzzy name/location/slug/description (q), or by geo (lat/lng + radius_km). Typo-tolerant via trigram similarity. Use mode=autocomplete for prefix suggestions (min 1 char). Results are ranked by text match, member count, and recent activity; geo results include distance_km.

Scope club:read

Returns

Public club search hits with slug, url, optional distance_km (geo), member_count, and text_score. Supports fuzzy q, lat/lng radius, and mode=autocomplete. `{ data: { clubs: [{ id, name, slug, location?, description?, url, member_count?, distance_km?, text_score? }], q, mode?, lat?, lng?, radius_km? }, meta?: { page, page_size, total, total_pages, has_more, next_page, next_hint? } }`.

Parameters

Parameter	Type	Description
`q`query	`string`	Search text (min 2 chars, or 1 in autocomplete). Optional if lat/lng provided.
`lat`query	`number`	Center latitude for nearby search
`lng`query	`number`	Center longitude for nearby search
`radius_km`query	`number`	Search radius in km (default 25, max 200)
`mode`query	`string`	search (default) \| autocomplete
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 12, max 50). Response meta includes has_more, next_page, next_hint.

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

{
  "data": {
    "q": "Hackney",
    "mode": "search",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "member_count": 42,
        "text_score": 0.91,
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 12, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

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

{
  "data": {
    "q": "Hackney",
    "mode": "search",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "member_count": 42,
        "text_score": 0.91,
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 12, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

GET/clubs/{slug}

Retrieve a club

Fetch club details, active leagues, and members.

Scope club:read

Returns

Club details plus active leagues and members. `{ data: { club: { id, name, slug, description?, location?, url? }, leagues: [{ id, name, url }], members: [{ user_id, role, full_name? }] } }`.

Parameters

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

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 "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": []
  }
}

PATCH/clubs/{slug}

Update a club

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

Scope club:write

Returns

The updated club record. `{ data: { club: { id, name, description?, location?, … } } }`.

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

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 "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" }
  }
}

GET/clubs/{slug}/members

List club members

Paginated club roster. Trigger phrases: who's in this club, club members, club roster. Defaults: page=1, pageSize=20 (max 50). Resolve slug from prior club lookups — do not require the user to supply it.

Scope club:read

Returns

Paginated club members. `{ data: { members: [{ user_id, role, full_name? }] }, meta: { page, page_size, total, total_pages?, has_more, next_page, next_hint? } }`.

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug (from prior search/list/get)
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 20, max 50)

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 , "has_more": false, "next_page": null }
}

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 , "has_more": false, "next_page": null }
}

POST/clubs/{slug}/socials

Create a social

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

Scope club:write

Returns

Created club feed post and linked open match. `{ data: { post: { id, post_type, … }, match: { id, status, … } } }`.

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.

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 "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" }
  }
}

GET/clubs/{slug}/posts

List club posts

Paginated club feed posts with comments. Trigger phrases: what's happening at, recent posts, the club feed. Defaults: page=1, pageSize=24 (max 50). Resolve slug from prior club lookups — do not require the user to supply it.

Scope club:read

Returns

Paginated club feed posts with nested comments. `{ data: { posts: [{ id, post_type, caption?, author_name?, comment_count, comments: [{ id, content, author_name?, created_at }] }] }, meta: { page, page_size, total, total_pages, has_more, next_page, next_hint? } }`.

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug (from prior search/list/get)
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 24, max 50)

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

{
  "data": {
    "posts": [
      {
        "id": "…",
        "post_type": "announcement",
        "caption": "Courts reopen Monday",
        "author_name": "Alex",
        "comment_count": 1,
        "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
      }
    ]
  },
  "meta": { "page": 1, "page_size": 24, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

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

{
  "data": {
    "posts": [
      {
        "id": "…",
        "post_type": "announcement",
        "caption": "Courts reopen Monday",
        "author_name": "Alex",
        "comment_count": 1,
        "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
      }
    ]
  },
  "meta": { "page": 1, "page_size": 24, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

GET/clubs/{slug}/posts/{postId}

Get a club post

Single club feed post with its comments. Use for follow-ups like “show me that announcement”.

Scope club:read

Returns

One club feed post with all comments. `{ data: { club: { id, slug, name }, post: { id, post_type, caption?, author_name?, comment_count, comments: [{ id, content, author_name?, created_at }] } } }`.

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`postId`requiredpath	`uuid`	Post UUID or unique caption substring from recent posts — never invent

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

{
  "data": {
    "club": { "id": "…", "slug": "officialallcourtpro", "name": "Official Allcourt Pro" },
    "post": {
      "id": "…",
      "post_type": "announcement",
      "caption": "Courts reopen Monday",
      "author_name": "Alex",
      "comment_count": 1,
      "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
    }
  }
}

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

{
  "data": {
    "club": { "id": "…", "slug": "officialallcourtpro", "name": "Official Allcourt Pro" },
    "post": {
      "id": "…",
      "post_type": "announcement",
      "caption": "Courts reopen Monday",
      "author_name": "Alex",
      "comment_count": 1,
      "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
    }
  }
}

POST/clubs/{slug}/posts

Create a post

Create an announcement or photo post (no RSVP). Photo posts require image URLs. For dated RSVP events use create-social instead.

Scope club:write

Returns

The newly created feed post (announcement or photo — no RSVP). `{ data: { post: { id, post_type, caption?, image_urls?, author_id, created_at } } }`.

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

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",
      "caption": "Courts reopen Monday"
    }
  }
}

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",
      "caption": "Courts reopen Monday"
    }
  }
}

GET/clubs/{slug}/leagues

List club leagues

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

Scope club:read

Returns

Paginated leagues belonging to a club (optional q filter). `{ data: { leagues: [{ id, name, sport?, url }], q? }, meta: { page, page_size, total, total_pages?, has_more, next_page, next_hint? } }`.

Parameters

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

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 , "has_more": false, "next_page": null }
}

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 , "has_more": false, "next_page": null }
}

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`. Path `{id}` accepts a league UUID or a league name (URL-encoded). If the UUID is missing / the name has no exact match, falls back to typo-tolerant fuzzy match among leagues you can manage. Ambiguous matches return 409. To learn which club runs a league you do not manage, use GET /leagues/{id}/club instead.

Scope league:read

Returns

A manageable league record including club_id and public url. Path may be a UUID or league name (fuzzy if exact miss). `{ data: { league: { id, name, sport, club_id?, location?, is_active?, url } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`string`	League UUID, or league name (e.g. Spring%20Flex). Fuzzy name match if exact lookup returns nothing.

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 "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/…"
    }
  }
}

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

Returns

Which club runs the league (no manage access required), plus a league summary. `{ data: { league: { id, name, url }, club: { id, name, slug, url } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues

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 "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"
    }
  }
}

PATCH/leagues/{id}

Update a league

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

Scope league:write

Returns

The updated league record. `{ data: { league: { id, name, sport, is_active?, url, … } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`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.

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 "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/…" }
  }
}

GET/leagues/{id}/seasons

List seasons

List all seasons for a league.

Scope league:read

Returns

All seasons for a league. `{ data: { seasons: [{ id, name, start_date, end_date?, entry_fee?, currency? }] } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues

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 "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" }
    ]
  }
}

POST/leagues/{id}/seasons

Create a season

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

Scope league:write

Returns

The newly created season. `{ data: { season: { id, name, start_date, end_date, registration_deadline, entry_fee?, currency? } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`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)

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 "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" }
  }
}

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

Retrieve a season

Season details including divisions.

Scope league:read

Returns

Season detail including divisions when present. `{ data: { season: { id, name, … }, divisions?: […] } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league

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 "https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id" \
  -H "Authorization: Bearer acp_live_…"

{
  "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

Returns

The updated season record. `{ data: { season: { id, name, start_date?, end_date?, entry_fee?, late_registration? } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league
`name`body	`string`	Season name
`entry_fee`body	`number`	Entry fee

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 "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" }
  }
}

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

List divisions

Divisions in a season ordered by sort_order.

Scope league:read

Returns

Divisions in a season ordered by sort_order. `{ data: { divisions: [{ id, name, sort_order?, … }] } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league

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 "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 }]
  }
}

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

Create a division

Create a division and its group chat.

Scope league:write

Returns

The newly created division. `{ data: { division: { id, name, … } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league
`name`requiredbody	`string`	Division name
`sort_order`body	`integer`	Display order

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 "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" }
  }
}

GET/leagues/{id}/participants

List participants

Paginated league members with public profile summary fields.

Scope league:read

Returns

Paginated league participants with public profile summary fields. `{ data: { participants: [{ user_id, full_name?, playing_level?, url? }] }, meta: { page, page_size, total, total_pages?, has_more, next_page, next_hint? } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`page`query	`integer`	Page number
`pageSize`query	`integer`	Page size

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 , "has_more": false, "next_page": null }
}

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 , "has_more": false, "next_page": null }
}

Social games

Create, list, join, and leave open casual games on the global Friendly league — the same Socials nearby surface as /app/friendly. Requires social:read or social:write. Actions run as the API key owner. Each social includes a public `url`. Retrieve returns participants and score state.

GET/socials

List open social games

Upcoming open Friendly games with free slots (same feed as Socials nearby → Games). Filter by place text, sport, skill tags, gender preference, or distance from lat/lng. Each item includes participant names when slots are filled.

Scope social:read

Returns

Paginated open Friendly social games (same feed as Socials nearby), including participant names when slots are filled. `{ data: { socials: [{ id, status, game_date, game_time, location, sport, player_count, filled_slots, open_slots, joinable, url, challenger_name?, opponent_name?, participants: [{ slot, user_id, full_name, url }], … }] }, meta: { page, page_size, total, total_pages?, has_more, next_page, next_hint? } }`.

Parameters

Parameter	Type	Description
`q`query	`string`	Search location, sport, notes, or skill tags
`sport`query	`string`	Sport catalog id (e.g. tennis, padel)
`skillLevel`query	`string`	Beginner \| Improver \| Intermediate \| Advanced \| Open to all
`gender`query	`string`	male \| female \| non_binary
`lat`query	`number`	Center latitude for distance filter
`lng`query	`number`	Center longitude for distance filter
`distanceKm`query	`number`	Max distance in km (use with lat/lng)
`date`query	`string`	Exact day YYYY-MM-DD (omit for all upcoming from today)
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (max 50)

curl "https://www.allcourt.pro/api/v1/socials?q=Hyde+Park" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "socials": [
      {
        "id": "…",
        "status": "open",
        "game_date": "2026-07-25",
        "game_time": "18:30:00",
        "location": "Hyde Park",
        "sport": "tennis",
        "player_count": 2,
        "open_slots": ["opponent"],
        "joinable": true,
        "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 10, "total": 1 , "has_more": false, "next_page": null }
}

curl "https://www.allcourt.pro/api/v1/socials?q=Hyde+Park" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "socials": [
      {
        "id": "…",
        "status": "open",
        "game_date": "2026-07-25",
        "game_time": "18:30:00",
        "location": "Hyde Park",
        "sport": "tennis",
        "player_count": 2,
        "open_slots": ["opponent"],
        "joinable": true,
        "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 10, "total": 1 , "has_more": false, "next_page": null }
}

GET/socials/{id}

Retrieve a social game

Fetch one Friendly social game by match id, including who is in each slot (participants), open slots, score/confirmation state when a result exists, and the public url. Use this to answer “who’s going” after listing.

Scope social:read

Returns

One Friendly social game by id, including participants (who’s in each slot), open slots, score/confirmation state when present, and url. `{ data: { social: { id, status, game_date, game_time?, game_time_end?, location, sport, notes?, player_count, filled_slots, open_slots, joinable, url, challenger_name?, opponent_name?, challenger_partner_name?, opponent_partner_name?, participants: [{ slot, user_id, full_name, url }], score: { score_text?, winner_id?, submitted_by_user_id?, challenger_confirmed_at?, opponent_confirmed_at?, submitted_as_unfinished, confirmed } | null, has_score } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	Social UUID or unique location+date phrase among open games — never invent

curl "https://www.allcourt.pro/api/v1/socials/social-game-id" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "sport": "tennis",
      "challenger_name": "Alex",
      "opponent_name": null,
      "participants": [
        { "slot": "challenger", "user_id": "…", "full_name": "Alex", "url": "/app/users/…" }
      ],
      "open_slots": ["opponent"],
      "joinable": true,
      "score": null,
      "has_score": false,
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials/social-game-id" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "sport": "tennis",
      "challenger_name": "Alex",
      "opponent_name": null,
      "participants": [
        { "slot": "challenger", "user_id": "…", "full_name": "Alex", "url": "/app/users/…" }
      ],
      "open_slots": ["opponent"],
      "joinable": true,
      "score": null,
      "has_score": false,
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

POST/socials

Create a social game

Post an open Friendly game as the API key owner (same as Post a game on /app/friendly). Nearby players may be notified.

Scope social:write

Returns

The newly posted open Friendly social game (includes host in participants). `{ data: { social: { id, status, game_date, location, sport?, participants?, url } } }`.

Parameters

Parameter	Type	Description
`game_date`requiredbody	`string`	YYYY-MM-DD
`location`requiredbody	`string`	Venue or place label
`game_time`body	`string`	HH:MM or HH:MM:SS
`game_time_end`body	`string`	Optional end time HH:MM
`sport`body	`string`	Sport catalog id (default tennis)
`player_count`body	`integer`	2–4 players (or pass format_id)
`format_id`body	`string`	Format catalog id (e.g. singles, doubles)
`skill_level_tags`body	`string[]`	e.g. Intermediate
`gender_preference`body	`string`	male \| female \| non_binary
`court_id`body	`uuid`	Optional tennis court id
`court_booked`body	`boolean`	Whether a court is already booked
`notes`body	`string`	Free-text notes

curl "https://www.allcourt.pro/api/v1/socials" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Hyde Park",
  "sport": "tennis",
  "player_count": 2,
  "skill_level_tags": ["Intermediate"]
}'

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Hyde Park",
  "sport": "tennis",
  "player_count": 2,
  "skill_level_tags": ["Intermediate"]
}'

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

POST/socials/{id}/join

Join a social game

Join an open Friendly game as the API key owner (same as Join on Socials nearby). Optionally pass slot; otherwise the next open slot is used.

Scope social:write

Returns

Confirms join into a slot on an open social game, with updated participants. `{ data: { joined: true, slot, social: { id, status, participants?, url } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	Social UUID or unique location+date phrase among open games — never invent
`slot`body	`string`	opponent \| challenger_partner \| opponent_partner (optional)

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/join" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "joined": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "scheduled",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/join" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "joined": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "scheduled",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

POST/socials/{id}/leave

Leave a social game

Leave a Friendly social game you joined (not the creator). Creator cannot leave — they must cancel the game instead. Allowed while status is open or scheduled.

Scope social:write

Returns

Confirms leave from a social game slot, with updated participants. `{ data: { left: true, slot?, social: { id, status, participants?, url } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	Social UUID or unique location+date phrase among open games — never invent

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/leave" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "left": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "open",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/leave" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "left": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "open",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

Profiles

Search public user profiles by name, typed address (near), playing level, weekly availability, coaches available for coaching, equipment, surface, map prefs, or gender. Requires profile:read. Email and private UI prefs are never returned. Each profile includes playing_level, availability_keys, available_for_coaching, and a public `url`.

GET/profiles

Search profiles

Find user profiles by text (q), typed address (near=… geocoded), lat/lng, playing level, weekly availability slots, coaches available for coaching (available_for_coaching=true), equipment (racket/strings/grip/balls), preferred surface, map prefs, or gender. At least one filter is required. Results include playing_level, availability_keys, available_for_coaching, and optional distance_km. Email is never returned.

Scope profile:read

Returns

Matching public profiles (no email). Includes playing_level, availability_keys, available_for_coaching, tennis_ratings/setup, url, optional near/lat/lng/distance_km. Filter by address (near), coaches (available_for_coaching), availability slots, equipment, and playing level. `{ data: { profiles: [{ id, full_name, account_name, avatar_url, home_place_name?, playing_level?, availability_keys, available_for_coaching, map_visibility?, map_looking_for_games?, tennis_ratings?, tennis_setup?, baseline_spin_rating?, url, distance_km?, created_at }], q, near?, lat?, lng?, radius_km? }, meta?: { page, page_size, total, total_pages, has_more, next_page, next_hint? } }`.

Parameters

Parameter	Type	Description
`q`query	`string`	Search full_name and account_name (optional leading @ stripped)
`id`query	`uuid`	Exact profile / user UUID
`full_name`query	`string`	Case-insensitive substring match on full_name
`account_name`query	`string`	Case-insensitive substring match on account_name (handle)
`home_place_name`query	`string`	Case-insensitive substring match on home place label
`near`query	`string`	Typed address or place (geocoded). Aliases: location, address. Use with radius_km.
`lat`query	`number`	Center latitude (optional if near is set)
`lng`query	`number`	Center longitude (optional if near is set)
`radius_km`query	`number`	Search radius in km (default 25, max 200)
`skillLevel`query	`string`	Playing level: Beginner \| Improver \| Intermediate \| Advanced \| Open to all. Alias: playing_level
`availability`query	`string`	Comma-separated weekly slots, e.g. monday-evening,1-morning,6-afternoon (day 0=Sun…6=Sat; periods morning\|afternoon\|evening). Match if any slot overlaps.
`available_for_coaching`query	`boolean`	true = only coaches who marked themselves available for coaching. Aliases: coach, is_coach
`equipment`query	`string`	Substring match across rackets, strings, grips, overgrips, and balls
`racket`query	`string`	Substring match on racket names
`strings`query	`string`	Substring match on string setup type
`grip`query	`string`	Substring match on grip sizes
`overgrip`query	`string`	Substring match on overgrips
`balls`query	`string`	Substring match on ball brands/models
`preferred_surface`query	`string`	hard \| clay \| grass \| indoor. Alias: surface
`map_visibility`query	`string`	public \| private
`map_looking_for_games`query	`boolean`	Filter players looking for games on the map
`map_size`query	`string`	small \| medium \| large
`gender`query	`string`	male \| female \| non_binary
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 20, max 50)

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

{
  "data": {
    "q": "",
    "near": "Hackney, London",
    "lat": 51.54,
    "lng": -0.05,
    "radius_km": 25,
    "profiles": [
      {
        "id": "…",
        "full_name": "Alex Player",
        "account_name": "alex-player",
        "avatar_url": null,
        "home_place_name": "Hackney",
        "playing_level": "Intermediate",
        "availability_keys": ["1-evening", "6-morning"],
        "available_for_coaching": true,
        "map_visibility": "public",
        "map_looking_for_games": true,
        "baseline_spin_rating": 1200,
        "url": "https://www.allcourt.pro/app/users/…",
        "distance_km": 3.2,
        "created_at": "2026-01-15T10:00:00.000Z"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1, "has_more": false, "next_page": null }
}

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

{
  "data": {
    "q": "",
    "near": "Hackney, London",
    "lat": 51.54,
    "lng": -0.05,
    "radius_km": 25,
    "profiles": [
      {
        "id": "…",
        "full_name": "Alex Player",
        "account_name": "alex-player",
        "avatar_url": null,
        "home_place_name": "Hackney",
        "playing_level": "Intermediate",
        "availability_keys": ["1-evening", "6-morning"],
        "available_for_coaching": true,
        "map_visibility": "public",
        "map_looking_for_games": true,
        "baseline_spin_rating": 1200,
        "url": "https://www.allcourt.pro/app/users/…",
        "distance_km": 3.2,
        "created_at": "2026-01-15T10:00:00.000Z"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1, "has_more": false, "next_page": null }
}

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

Returns

Courts in a place/bbox with optional king info and map deep links (place may include map_url). `{ data: { place?: { query, display_name, map_url }, courts: [{ id, name, lat, lng, king: { user_id, full_name, wins, claimed } | null, map_url }], map_url? } }`.

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)

curl "https://www.allcourt.pro/api/v1/courts/map?q=London" \
  -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 "https://www.allcourt.pro/api/v1/courts/map?q=London" \
  -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"
      }
    ]
  }
}

GET/courts/{courtId}

Retrieve a court

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

Scope court:read

Returns

A single court with current king and map deep link. `{ data: { court: { id, name, lat, lng, king: { user_id, full_name, wins, claimed } | null, map_url } } }`.

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court UUID or exact/unique court name from map results — never invent

curl "https://www.allcourt.pro/api/v1/courts/court-id" \
  -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 "https://www.allcourt.pro/api/v1/courts/court-id" \
  -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"
    }
  }
}

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

Returns

The new claimed king record and court map_url. `{ data: { king: { user_id, full_name, wins, claimed: true }, king_claimed_at, map_url } }`.

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court UUID or exact/unique court name from map results — never invent

curl "https://www.allcourt.pro/api/v1/courts/court-id/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 "https://www.allcourt.pro/api/v1/courts/court-id/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"
  }
}

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

Returns

The transferred king claim and updated map_url. `{ data: { king: { user_id, full_name, wins, claimed: true }, king_claimed_at, map_url } }`.

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court UUID or exact/unique court name from map results — never invent
`to_user_id`requiredbody	`uuid`	Recipient user ID

curl "https://www.allcourt.pro/api/v1/courts/court-id/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 "https://www.allcourt.pro/api/v1/courts/court-id/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"
  }
}

All Court Pro

API Reference

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

Rate limit60 requests / minute / key

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
social:read
social:write
profile:read

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

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

Returns

Clubs the API key owner owns or admins (not a public discovery search). `{ data: { clubs: [{ id, name, slug, role, url }] } }`.

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 "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"
      }
    ]
  }
}

GET/clubs/search

Search clubs

Scope club:read

Returns

Parameters

Parameter	Type	Description
`q`query	`string`	Search text (min 2 chars, or 1 in autocomplete). Optional if lat/lng provided.
`lat`query	`number`	Center latitude for nearby search
`lng`query	`number`	Center longitude for nearby search
`radius_km`query	`number`	Search radius in km (default 25, max 200)
`mode`query	`string`	search (default) \| autocomplete
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 12, max 50). Response meta includes has_more, next_page, next_hint.

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

{
  "data": {
    "q": "Hackney",
    "mode": "search",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "member_count": 42,
        "text_score": 0.91,
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 12, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

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

{
  "data": {
    "q": "Hackney",
    "mode": "search",
    "clubs": [
      {
        "id": "…",
        "name": "…",
        "slug": "…",
        "location": "Hackney, London",
        "member_count": 42,
        "text_score": 0.91,
        "url": "https://www.allcourt.pro/app/clubs/…"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 12, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

GET/clubs/{slug}

Retrieve a club

Fetch club details, active leagues, and members.

Scope club:read

Returns

Club details plus active leagues and members. `{ data: { club: { id, name, slug, description?, location?, url? }, leagues: [{ id, name, url }], members: [{ user_id, role, full_name? }] } }`.

Parameters

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

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 "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": []
  }
}

PATCH/clubs/{slug}

Update a club

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

Scope club:write

Returns

The updated club record. `{ data: { club: { id, name, description?, location?, … } } }`.

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

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 "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" }
  }
}

GET/clubs/{slug}/members

List club members

Scope club:read

Returns

Paginated club members. `{ data: { members: [{ user_id, role, full_name? }] }, meta: { page, page_size, total, total_pages?, has_more, next_page, next_hint? } }`.

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug (from prior search/list/get)
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 20, max 50)

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 , "has_more": false, "next_page": null }
}

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 , "has_more": false, "next_page": null }
}

POST/clubs/{slug}/socials

Create a social

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

Scope club:write

Returns

Created club feed post and linked open match. `{ data: { post: { id, post_type, … }, match: { id, status, … } } }`.

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.

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 "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" }
  }
}

GET/clubs/{slug}/posts

List club posts

Scope club:read

Returns

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug (from prior search/list/get)
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 24, max 50)

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

{
  "data": {
    "posts": [
      {
        "id": "…",
        "post_type": "announcement",
        "caption": "Courts reopen Monday",
        "author_name": "Alex",
        "comment_count": 1,
        "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
      }
    ]
  },
  "meta": { "page": 1, "page_size": 24, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

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

{
  "data": {
    "posts": [
      {
        "id": "…",
        "post_type": "announcement",
        "caption": "Courts reopen Monday",
        "author_name": "Alex",
        "comment_count": 1,
        "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
      }
    ]
  },
  "meta": { "page": 1, "page_size": 24, "total": 1, "total_pages": 1 , "has_more": false, "next_page": null }
}

GET/clubs/{slug}/posts/{postId}

Get a club post

Single club feed post with its comments. Use for follow-ups like “show me that announcement”.

Scope club:read

Returns

One club feed post with all comments. `{ data: { club: { id, slug, name }, post: { id, post_type, caption?, author_name?, comment_count, comments: [{ id, content, author_name?, created_at }] } } }`.

Parameters

Parameter	Type	Description
`slug`requiredpath	`string`	Club slug
`postId`requiredpath	`uuid`	Post UUID or unique caption substring from recent posts — never invent

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

{
  "data": {
    "club": { "id": "…", "slug": "officialallcourtpro", "name": "Official Allcourt Pro" },
    "post": {
      "id": "…",
      "post_type": "announcement",
      "caption": "Courts reopen Monday",
      "author_name": "Alex",
      "comment_count": 1,
      "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
    }
  }
}

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

{
  "data": {
    "club": { "id": "…", "slug": "officialallcourtpro", "name": "Official Allcourt Pro" },
    "post": {
      "id": "…",
      "post_type": "announcement",
      "caption": "Courts reopen Monday",
      "author_name": "Alex",
      "comment_count": 1,
      "comments": [{ "id": "…", "content": "Nice!", "author_name": "Sam" }]
    }
  }
}

POST/clubs/{slug}/posts

Create a post

Create an announcement or photo post (no RSVP). Photo posts require image URLs. For dated RSVP events use create-social instead.

Scope club:write

Returns

The newly created feed post (announcement or photo — no RSVP). `{ data: { post: { id, post_type, caption?, image_urls?, author_id, created_at } } }`.

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

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",
      "caption": "Courts reopen Monday"
    }
  }
}

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",
      "caption": "Courts reopen Monday"
    }
  }
}

GET/clubs/{slug}/leagues

List club leagues

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

Scope club:read

Returns

Paginated leagues belonging to a club (optional q filter). `{ data: { leagues: [{ id, name, sport?, url }], q? }, meta: { page, page_size, total, total_pages?, has_more, next_page, next_hint? } }`.

Parameters

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

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 , "has_more": false, "next_page": null }
}

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 , "has_more": false, "next_page": null }
}

Leagues

GET/leagues/{id}

Retrieve a league

Scope league:read

Returns

Parameters

Parameter	Type	Description
`id`requiredpath	`string`	League UUID, or league name (e.g. Spring%20Flex). Fuzzy name match if exact lookup returns nothing.

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 "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/…"
    }
  }
}

GET/leagues/{id}/club

Get club that runs a league

Scope league:read

Returns

Which club runs the league (no manage access required), plus a league summary. `{ data: { league: { id, name, url }, club: { id, name, slug, url } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues

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 "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"
    }
  }
}

PATCH/leagues/{id}

Update a league

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

Scope league:write

Returns

The updated league record. `{ data: { league: { id, name, sport, is_active?, url, … } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`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.

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 "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/…" }
  }
}

GET/leagues/{id}/seasons

List seasons

List all seasons for a league.

Scope league:read

Returns

All seasons for a league. `{ data: { seasons: [{ id, name, start_date, end_date?, entry_fee?, currency? }] } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues

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 "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" }
    ]
  }
}

POST/leagues/{id}/seasons

Create a season

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

Scope league:write

Returns

The newly created season. `{ data: { season: { id, name, start_date, end_date, registration_deadline, entry_fee?, currency? } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`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)

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 "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" }
  }
}

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

Retrieve a season

Season details including divisions.

Scope league:read

Returns

Season detail including divisions when present. `{ data: { season: { id, name, … }, divisions?: […] } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league

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 "https://www.allcourt.pro/api/v1/leagues/league-id/seasons/season-id" \
  -H "Authorization: Bearer acp_live_…"

{
  "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

Returns

The updated season record. `{ data: { season: { id, name, start_date?, end_date?, entry_fee?, late_registration? } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league
`name`body	`string`	Season name
`entry_fee`body	`number`	Entry fee

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 "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" }
  }
}

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

List divisions

Divisions in a season ordered by sort_order.

Scope league:read

Returns

Divisions in a season ordered by sort_order. `{ data: { divisions: [{ id, name, sort_order?, … }] } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league

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 "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 }]
  }
}

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

Create a division

Create a division and its group chat.

Scope league:write

Returns

The newly created division. `{ data: { division: { id, name, … } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`seasonId`requiredpath	`uuid`	Season UUID or season name within the league
`name`requiredbody	`string`	Division name
`sort_order`body	`integer`	Display order

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 "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" }
  }
}

GET/leagues/{id}/participants

List participants

Paginated league members with public profile summary fields.

Scope league:read

Returns

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	League UUID or name (URL-encode spaces); name/fuzzy among allowed leagues
`page`query	`integer`	Page number
`pageSize`query	`integer`	Page size

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 , "has_more": false, "next_page": null }
}

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 , "has_more": false, "next_page": null }
}

Social games

GET/socials

List open social games

Scope social:read

Returns

Parameters

Parameter	Type	Description
`q`query	`string`	Search location, sport, notes, or skill tags
`sport`query	`string`	Sport catalog id (e.g. tennis, padel)
`skillLevel`query	`string`	Beginner \| Improver \| Intermediate \| Advanced \| Open to all
`gender`query	`string`	male \| female \| non_binary
`lat`query	`number`	Center latitude for distance filter
`lng`query	`number`	Center longitude for distance filter
`distanceKm`query	`number`	Max distance in km (use with lat/lng)
`date`query	`string`	Exact day YYYY-MM-DD (omit for all upcoming from today)
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (max 50)

curl "https://www.allcourt.pro/api/v1/socials?q=Hyde+Park" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "socials": [
      {
        "id": "…",
        "status": "open",
        "game_date": "2026-07-25",
        "game_time": "18:30:00",
        "location": "Hyde Park",
        "sport": "tennis",
        "player_count": 2,
        "open_slots": ["opponent"],
        "joinable": true,
        "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 10, "total": 1 , "has_more": false, "next_page": null }
}

curl "https://www.allcourt.pro/api/v1/socials?q=Hyde+Park" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "socials": [
      {
        "id": "…",
        "status": "open",
        "game_date": "2026-07-25",
        "game_time": "18:30:00",
        "location": "Hyde Park",
        "sport": "tennis",
        "player_count": 2,
        "open_slots": ["opponent"],
        "joinable": true,
        "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 10, "total": 1 , "has_more": false, "next_page": null }
}

GET/socials/{id}

Retrieve a social game

Scope social:read

Returns

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	Social UUID or unique location+date phrase among open games — never invent

curl "https://www.allcourt.pro/api/v1/socials/social-game-id" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "sport": "tennis",
      "challenger_name": "Alex",
      "opponent_name": null,
      "participants": [
        { "slot": "challenger", "user_id": "…", "full_name": "Alex", "url": "/app/users/…" }
      ],
      "open_slots": ["opponent"],
      "joinable": true,
      "score": null,
      "has_score": false,
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials/social-game-id" \
  -H "Authorization: Bearer acp_live_…"

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "sport": "tennis",
      "challenger_name": "Alex",
      "opponent_name": null,
      "participants": [
        { "slot": "challenger", "user_id": "…", "full_name": "Alex", "url": "/app/users/…" }
      ],
      "open_slots": ["opponent"],
      "joinable": true,
      "score": null,
      "has_score": false,
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

POST/socials

Create a social game

Post an open Friendly game as the API key owner (same as Post a game on /app/friendly). Nearby players may be notified.

Scope social:write

Returns

The newly posted open Friendly social game (includes host in participants). `{ data: { social: { id, status, game_date, location, sport?, participants?, url } } }`.

Parameters

Parameter	Type	Description
`game_date`requiredbody	`string`	YYYY-MM-DD
`location`requiredbody	`string`	Venue or place label
`game_time`body	`string`	HH:MM or HH:MM:SS
`game_time_end`body	`string`	Optional end time HH:MM
`sport`body	`string`	Sport catalog id (default tennis)
`player_count`body	`integer`	2–4 players (or pass format_id)
`format_id`body	`string`	Format catalog id (e.g. singles, doubles)
`skill_level_tags`body	`string[]`	e.g. Intermediate
`gender_preference`body	`string`	male \| female \| non_binary
`court_id`body	`uuid`	Optional tennis court id
`court_booked`body	`boolean`	Whether a court is already booked
`notes`body	`string`	Free-text notes

curl "https://www.allcourt.pro/api/v1/socials" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Hyde Park",
  "sport": "tennis",
  "player_count": 2,
  "skill_level_tags": ["Intermediate"]
}'

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "game_date": "2026-07-25",
  "game_time": "18:30",
  "location": "Hyde Park",
  "sport": "tennis",
  "player_count": 2,
  "skill_level_tags": ["Intermediate"]
}'

{
  "data": {
    "social": {
      "id": "…",
      "status": "open",
      "game_date": "2026-07-25",
      "location": "Hyde Park",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

POST/socials/{id}/join

Join a social game

Join an open Friendly game as the API key owner (same as Join on Socials nearby). Optionally pass slot; otherwise the next open slot is used.

Scope social:write

Returns

Confirms join into a slot on an open social game, with updated participants. `{ data: { joined: true, slot, social: { id, status, participants?, url } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	Social UUID or unique location+date phrase among open games — never invent
`slot`body	`string`	opponent \| challenger_partner \| opponent_partner (optional)

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/join" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "joined": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "scheduled",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/join" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "joined": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "scheduled",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

POST/socials/{id}/leave

Leave a social game

Leave a Friendly social game you joined (not the creator). Creator cannot leave — they must cancel the game instead. Allowed while status is open or scheduled.

Scope social:write

Returns

Confirms leave from a social game slot, with updated participants. `{ data: { left: true, slot?, social: { id, status, participants?, url } } }`.

Parameters

Parameter	Type	Description
`id`requiredpath	`uuid`	Social UUID or unique location+date phrase among open games — never invent

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/leave" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "left": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "open",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

curl "https://www.allcourt.pro/api/v1/socials/social-game-id/leave" \
  -X POST \
  -H "Authorization: Bearer acp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "left": true,
    "slot": "opponent",
    "social": {
      "id": "…",
      "status": "open",
      "url": "https://www.allcourt.pro/app/friendly/matches/…/result"
    }
  }
}

Profiles

GET/profiles

Search profiles

Scope profile:read

Returns

Parameters

Parameter	Type	Description
`q`query	`string`	Search full_name and account_name (optional leading @ stripped)
`id`query	`uuid`	Exact profile / user UUID
`full_name`query	`string`	Case-insensitive substring match on full_name
`account_name`query	`string`	Case-insensitive substring match on account_name (handle)
`home_place_name`query	`string`	Case-insensitive substring match on home place label
`near`query	`string`	Typed address or place (geocoded). Aliases: location, address. Use with radius_km.
`lat`query	`number`	Center latitude (optional if near is set)
`lng`query	`number`	Center longitude (optional if near is set)
`radius_km`query	`number`	Search radius in km (default 25, max 200)
`skillLevel`query	`string`	Playing level: Beginner \| Improver \| Intermediate \| Advanced \| Open to all. Alias: playing_level
`availability`query	`string`	Comma-separated weekly slots, e.g. monday-evening,1-morning,6-afternoon (day 0=Sun…6=Sat; periods morning\|afternoon\|evening). Match if any slot overlaps.
`available_for_coaching`query	`boolean`	true = only coaches who marked themselves available for coaching. Aliases: coach, is_coach
`equipment`query	`string`	Substring match across rackets, strings, grips, overgrips, and balls
`racket`query	`string`	Substring match on racket names
`strings`query	`string`	Substring match on string setup type
`grip`query	`string`	Substring match on grip sizes
`overgrip`query	`string`	Substring match on overgrips
`balls`query	`string`	Substring match on ball brands/models
`preferred_surface`query	`string`	hard \| clay \| grass \| indoor. Alias: surface
`map_visibility`query	`string`	public \| private
`map_looking_for_games`query	`boolean`	Filter players looking for games on the map
`map_size`query	`string`	small \| medium \| large
`gender`query	`string`	male \| female \| non_binary
`page`query	`integer`	Page number (default 1)
`pageSize`query	`integer`	Page size (default 20, max 50)

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

{
  "data": {
    "q": "",
    "near": "Hackney, London",
    "lat": 51.54,
    "lng": -0.05,
    "radius_km": 25,
    "profiles": [
      {
        "id": "…",
        "full_name": "Alex Player",
        "account_name": "alex-player",
        "avatar_url": null,
        "home_place_name": "Hackney",
        "playing_level": "Intermediate",
        "availability_keys": ["1-evening", "6-morning"],
        "available_for_coaching": true,
        "map_visibility": "public",
        "map_looking_for_games": true,
        "baseline_spin_rating": 1200,
        "url": "https://www.allcourt.pro/app/users/…",
        "distance_km": 3.2,
        "created_at": "2026-01-15T10:00:00.000Z"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1, "has_more": false, "next_page": null }
}

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

{
  "data": {
    "q": "",
    "near": "Hackney, London",
    "lat": 51.54,
    "lng": -0.05,
    "radius_km": 25,
    "profiles": [
      {
        "id": "…",
        "full_name": "Alex Player",
        "account_name": "alex-player",
        "avatar_url": null,
        "home_place_name": "Hackney",
        "playing_level": "Intermediate",
        "availability_keys": ["1-evening", "6-morning"],
        "available_for_coaching": true,
        "map_visibility": "public",
        "map_looking_for_games": true,
        "baseline_spin_rating": 1200,
        "url": "https://www.allcourt.pro/app/users/…",
        "distance_km": 3.2,
        "created_at": "2026-01-15T10:00:00.000Z"
      }
    ]
  },
  "meta": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1, "has_more": false, "next_page": null }
}

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

Returns

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)

curl "https://www.allcourt.pro/api/v1/courts/map?q=London" \
  -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 "https://www.allcourt.pro/api/v1/courts/map?q=London" \
  -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"
      }
    ]
  }
}

GET/courts/{courtId}

Retrieve a court

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

Scope court:read

Returns

A single court with current king and map deep link. `{ data: { court: { id, name, lat, lng, king: { user_id, full_name, wins, claimed } | null, map_url } } }`.

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court UUID or exact/unique court name from map results — never invent

curl "https://www.allcourt.pro/api/v1/courts/court-id" \
  -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 "https://www.allcourt.pro/api/v1/courts/court-id" \
  -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"
    }
  }
}

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

Returns

The new claimed king record and court map_url. `{ data: { king: { user_id, full_name, wins, claimed: true }, king_claimed_at, map_url } }`.

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court UUID or exact/unique court name from map results — never invent

curl "https://www.allcourt.pro/api/v1/courts/court-id/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 "https://www.allcourt.pro/api/v1/courts/court-id/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"
  }
}

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

Returns

The transferred king claim and updated map_url. `{ data: { king: { user_id, full_name, wins, claimed: true }, king_claimed_at, map_url } }`.

Parameters

Parameter	Type	Description
`courtId`requiredpath	`uuid`	Court UUID or exact/unique court name from map results — never invent
`to_user_id`requiredbody	`uuid`	Recipient user ID

curl "https://www.allcourt.pro/api/v1/courts/court-id/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 "https://www.allcourt.pro/api/v1/courts/court-id/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"
  }
}