Chess.com team match API

Use the Chess.com team match API to retrieve chess match boards, competing-team information, record identities and titles, source-page links and reported status as structured JSON from Chess. Supply record identifier in the query. Use these results to prepare a match detail view and inspect its participants and recorded outcome. The documented source-page link form identifies the requested entry directly and lets you reuse an existing source-page reference. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.

Selected price
$0.002 / billing creditPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Match id or link (chess.com/club/matches/<id>, or /club/matches/live/<id>).
Optional parameters (6)
true for a live (not daily) team match id.
0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
1 skips the 24-hour cache and fetches live.
JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.
With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.

Sample response

{
  "boards": 54,
  "cached": false,
  "credits_used": 1,
  "end_time": "2010-01-10T07:38:24.000Z",
  "fetched_at": "2026-11-19T12:20:22.824Z",
  "id": "12803",
  "live": false,
  "name": "WORLD LEAGUE Round 5: Romania vs USA Southwest",
  "settings": {
    "autostart": false,
    "min_required_games": 0,
    "min_team_players": 1,
    "rules": "chess",
    "time_class": "daily",
    "time_control": "1/259200"
  },
  "site": "chesscom",
  "start_time": "2009-07-14T01:02:16.000Z",
  "status": "finished",
  "team1": {
    "fair_play_removals": [],
    "id": "team-romania",
    "name": "Team Romania",
    "players": [
      {
        "board": "45",
        "played_as_black": "checkmated",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/aayeah-bwoy/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "aayeah-bwoy"
      },
      {
        "board": "38",
        "played_as_black": "resigned",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/apopescu/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "apopescu"
      },
      {
        "board": "7",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/arpadkoblos/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "arpadkoblos"
      },
      {
        "board": "17",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/arsenedu/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "arsenedu"
      },
      {
        "board": "19",
        "played_as_black": "timeout",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/batranelu/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "batranelu"
      },
      {
        "board": "22",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/bcv1703/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "bcv1703"
      },
      {
        "board": "53",
        "played_as_black": "agreed",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/boantasandu/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "boantasandu"
      },
      {
        "board": "47",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/cardeala/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "cardeala"
      },
      {
        "board": "36",
        "played_as_black": "resigned",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/catalin_ionescu/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "catalin_ionescu"
      },
      {
        "board": "44",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/cooosti/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "cooosti"
      },
      {
        "board": "9",
        "played_as_black": "agreed",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/cornel/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "cornel"
      },
      {
        "board": "50",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/crystian/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "crystian"
      },
      {
        "board": "33",
        "played_as_black": "resigned",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/dana71/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "dana71"
      },
      {
        "board": "40",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/danezu/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "danezu"
      },
      {
        "board": "51",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/danoit/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "danoit"
      },
      {
        "board": "10",
        "played_as_black": "agreed",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/dxn/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "dxn"
      },
      {
        "board": "15",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/effe8/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "effe8"
      },
      {
        "board": "16",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/gimp_em/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "gimp_em"
      },
      {
        "board": "31",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/horiairimia/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "horiairimia"
      },
      {
        "board": "43",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/inactive_mattew/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "inactive_mattew"
      },
      {
        "board": "13",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/ionutzjo/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "ionutzjo"
      },
      {
        "board": "49",
        "played_as_black": "stalemate",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/johny71/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "johny71"
      },
      {
        "board": "52",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/justalinux/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "justalinux"
      },
      {
        "board": "29",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/lazyb/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "lazyb"
      },
      {
        "board": "11",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/macul/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "macul"
      },
      {
        "board": "35",
        "played_as_black": "checkmated",
        "played_as_white": "checkmated",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/maryn/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "maryn"
      },
      {
        "board": "4",
        "played_as_black": "resigned",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/mbmf3/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "mbmf3"
      },
      {
        "board": "23",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/mihai52/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "mihai52"
      },
      {
        "board": "48",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/mircea_1956/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "mircea_1956"
      },
      {
        "board": "24",
        "played_as_black": "agreed",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/mitik/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "mitik"
      },
      {
        "board": "28",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/neamircea/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "neamircea"
      },
      {
        "board": "18",
        "played_as_black": "agreed",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/nicu_57/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "nicu_57"
      },
      {
        "board": "25",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/onete/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "onete"
      },
      {
        "board": "14",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/orue/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "orue"
      },
      {
        "board": "21",
        "played_as_black": "win",
        "played_as_white": "checkmated",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/predaiulian/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "predaiulian"
      },
      {
        "board": "37",
        "played_as_black": "agreed",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/raghad/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "raghad"
      },
      {
        "board": "6",
        "played_as_black": "agreed",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/randy09/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "randy09"
      },
      {
        "board": "54",
        "played_as_black": "win",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/regele/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "regele"
      },
      {
        "board": "34",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/robinake/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "robinake"
      },
      {
        "board": "5",
        "played_as_black": "resigned",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/rodan/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "rodan"
      },
      {
        "board": "12",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/romanachisu/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "romanachisu"
      },
      {
        "board": "27",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/sabmardob68/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "sabmardob68"
      },
      {
        "board": "39",
        "played_as_black": "resigned",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/sadicus/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "sadicus"
      },
      {
        "board": "3",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/sah1234567/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "sah1234567"
      },
      {
        "board": "20",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/seabiscuit/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "seabiscuit"
      },
      {
        "board": "46",
        "played_as_black": "agreed",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/sganghel/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "sganghel"
      },
      {
        "board": "2",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/silechitila/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "silechitila"
      },
      {
        "board": "1",
        "played_as_black": "repetition",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/sorinel/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "sorinel"
      },
      {
        "board": "32",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/thebubu/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "thebubu"
      },
      {
        "board": "41",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/theonechampion/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "theonechampion"
      },
      {
        "board": "42",
        "played_as_black": "resigned",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/viknw/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "viknw"
      },
      {
        "board": "26",
        "played_as_black": "win",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/vindex/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "vindex"
      },
      {
        "board": "8",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/virgil_bv/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "virgil_bv"
      },
      {
        "board": "30",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/zsiga/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "zsiga"
      }
    ],
    "result": "win",
    "score": 61.5,
    "url": "https://www.chess.com/club/team-romania"
  },
  "team2": {
    "fair_play_removals": [],
    "id": "team-usa-southwest",
    "name": "Team USA - Southwest",
    "players": [
      {
        "board": "13",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/aiedale/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "aiedale"
      },
      {
        "board": "41",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/bluesage/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "bluesage"
      },
      {
        "board": "18",
        "played_as_black": "resigned",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/chamb/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "chamb"
      },
      {
        "board": "20",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/chesswoman/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "chesswoman"
      },
      {
        "board": "7",
        "played_as_black": "checkmated",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/chkm8r/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "chkm8r"
      },
      {
        "board": "29",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/cratercat/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "cratercat"
      },
      {
        "board": "11",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/daveshack/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "daveshack"
      },
      {
        "board": "17",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/dawgface420/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "dawgface420"
      },
      {
        "board": "10",
        "played_as_black": "agreed",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/desperadoes/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "desperadoes"
      },
      {
        "board": "2",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/doclove/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "doclove"
      },
      {
        "board": "35",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/dragonaccelerator/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "dragonaccelerator"
      },
      {
        "board": "23",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/dynogram/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "dynogram"
      },
      {
        "board": "39",
        "played_as_black": "agreed",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/erik/stats",
        "status": "staff",
        "timeout_percent": null,
        "username": "erik"
      },
      {
        "board": "12",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/eville/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "eville"
      },
      {
        "board": "47",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/fissurefan/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "fissurefan"
      },
      {
        "board": "52",
        "played_as_black": "resigned",
        "played_as_white": "checkmated",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/fixa/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "fixa"
      },
      {
        "board": "25",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/frank713/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "frank713"
      },
      {
        "board": "19",
        "played_as_black": "resigned",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/fuze22/stats",
        "status": "closed:abuse",
        "timeout_percent": null,
        "username": "fuze22"
      },
      {
        "board": "9",
        "played_as_black": "resigned",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/gmmelik/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "gmmelik"
      },
      {
        "board": "44",
        "played_as_black": "resigned",
        "played_as_white": "checkmated",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/hermitboy/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "hermitboy"
      },
      {
        "board": "51",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/hessianwarrior/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "hessianwarrior"
      },
      {
        "board": "30",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/jamesbond_007/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "jamesbond_007"
      },
      {
        "board": "48",
        "played_as_black": "checkmated",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/jantunes/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "jantunes"
      },
      {
        "board": "40",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/kcampman/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "kcampman"
      },
      {
        "board": "50",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/khang/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "khang"
      },
      {
        "board": "15",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/king_chapo/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "king_chapo"
      },
      {
        "board": "14",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/klimtsknight/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "klimtsknight"
      },
      {
        "board": "1",
        "played_as_black": "agreed",
        "played_as_white": "repetition",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/kllr/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "kllr"
      },
      {
        "board": "3",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/leiva2/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "leiva2"
      },
      {
        "board": "22",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/leobig/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "leobig"
      },
      {
        "board": "36",
        "played_as_black": "resigned",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/loki6/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "loki6"
      },
      {
        "board": "34",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/matter/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "matter"
      },
      {
        "board": "46",
        "played_as_black": "agreed",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/methusala/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "methusala"
      },
      {
        "board": "33",
        "played_as_black": "resigned",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/mlmiller/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "mlmiller"
      },
      {
        "board": "32",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/mtjstr9997/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "mtjstr9997"
      },
      {
        "board": "37",
        "played_as_black": "resigned",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/nummer1/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "nummer1"
      },
      {
        "board": "5",
        "played_as_black": "agreed",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/pawnshadow/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "pawnshadow"
      },
      {
        "board": "53",
        "played_as_black": "win",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/pdmura/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "pdmura"
      },
      {
        "board": "43",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/plongs-inactive/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "plongs-inactive"
      },
      {
        "board": "45",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/pmarty/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "pmarty"
      },
      {
        "board": "38",
        "played_as_black": "resigned",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/sascha1959/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "sascha1959"
      },
      {
        "board": "21",
        "played_as_black": "win",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/sonny/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "sonny"
      },
      {
        "board": "42",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/squidinnewmexico/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "squidinnewmexico"
      },
      {
        "board": "26",
        "played_as_black": "agreed",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/starjock/stats",
        "status": "closed",
        "timeout_percent": null,
        "username": "starjock"
      },
      {
        "board": "28",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/stevez/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "stevez"
      },
      {
        "board": "54",
        "played_as_black": "agreed",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/t64check/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "t64check"
      },
      {
        "board": "16",
        "played_as_black": "timeout",
        "played_as_white": "timeout",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/that70sjosh/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "that70sjosh"
      },
      {
        "board": "49",
        "played_as_black": "win",
        "played_as_white": "stalemate",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/theironduke/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "theironduke"
      },
      {
        "board": "4",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/trephine/stats",
        "status": "closed:fair_play_violations",
        "timeout_percent": null,
        "username": "trephine"
      },
      {
        "board": "6",
        "played_as_black": "resigned",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/ty_twadd/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "ty_twadd"
      },
      {
        "board": "31",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/waltc9/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "waltc9"
      },
      {
        "board": "24",
        "played_as_black": "win",
        "played_as_white": "agreed",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/warrior/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "warrior"
      },
      {
        "board": "8",
        "played_as_black": "win",
        "played_as_white": "win",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/white_rook/stats",
        "status": "basic",
        "timeout_percent": null,
        "username": "white_rook"
      },
      {
        "board": "27",
        "played_as_black": "resigned",
        "played_as_white": "resigned",
        "rating": null,
        "rd": null,
        "stats": "https://api.chess.com/pub/player/wolfpawn/stats",
        "status": "premium",
        "timeout_percent": null,
        "username": "wolfpawn"
      }
    ],
    "result": "lose",
    "score": 46.5,
    "url": "https://www.chess.com/club/team-usa-southwest"
  },
  "url": "https://www.chess.com/club/matches/12803"
}

Response result

Response structure

Inferred from examples
  • boardsinteger
  • cachedboolean
  • credits_usedinteger
  • end_timestring
  • fetched_atstring
  • idstring
  • liveboolean
  • namestring
  • settingsobject
    • autostartboolean
    • min_required_gamesinteger
    • min_team_playersinteger
    • rulesstring
    • time_classstring
    • time_controlstring
  • sitestring
  • start_timestring
  • statusstring
  • team1object
    • fair_play_removalsunknown[]
    • idstring
    • namestring
    • playersobject[]
      • boardstring
      • played_as_blackstring
      • played_as_whitestring
      • ratingnull
      • rdnull
      • statsstring
      • statusstring
      • timeout_percentnull
      • usernamestring
    • resultstring
    • scorenumber
    • urlstring
  • team2object
    • fair_play_removalsunknown[]
    • idstring
    • namestring
    • playersobject[]
      • boardstring
      • played_as_blackstring
      • played_as_whitestring
      • ratingnull
      • rdnull
      • statsstring
      • statusstring
      • timeout_percentnull
      • usernamestring
    • resultstring
    • scorenumber
    • urlstring
  • urlstring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use Chess.com team match API with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.