Chess.com · Schema

Chess.com Player

Public Chess.com player profile as returned by /pub/player/{username}.

ChessGamingOnline GamesSportsCommunityEducation

Properties

Name	Type	Description
@id	string	Canonical API URL for the player.
url	string	Player profile URL on chess.com.
username	string	All-lowercase username.
player_id	integer	Non-changing Chess.com identifier.
name	string
title	string	FIDE title abbreviation (GM, IM, etc.)
status	string
avatar	string
location	string
country	string	URL to the country resource.
joined	integer	Unix timestamp.
last_online	integer
followers	integer
is_streamer	boolean
twitch_url	string
fide	integer	FIDE rating, when available.
verified	boolean

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/chess-com/main/json-schema/chess-com-player-schema.json",
  "title": "Chess.com Player",
  "description": "Public Chess.com player profile as returned by /pub/player/{username}.",
  "type": "object",
  "required": ["@id", "url", "username", "player_id"],
  "properties": {
    "@id": {
      "type": "string",
      "format": "uri",
      "description": "Canonical API URL for the player."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Player profile URL on chess.com."
    },
    "username": {
      "type": "string",
      "description": "All-lowercase username."
    },
    "player_id": {
      "type": "integer",
      "description": "Non-changing Chess.com identifier."
    },
    "name": { "type": "string" },
    "title": {
      "type": "string",
      "description": "FIDE title abbreviation (GM, IM, etc.)",
      "enum": ["GM", "WGM", "IM", "WIM", "FM", "WFM", "NM", "WNM", "CM", "WCM"]
    },
    "status": {
      "type": "string",
      "enum": ["closed", "closed:fair_play_violations", "basic", "premium", "mod", "staff"]
    },
    "avatar": { "type": "string", "format": "uri" },
    "location": { "type": "string" },
    "country": {
      "type": "string",
      "format": "uri",
      "description": "URL to the country resource."
    },
    "joined": { "type": "integer", "description": "Unix timestamp." },
    "last_online": { "type": "integer" },
    "followers": { "type": "integer" },
    "is_streamer": { "type": "boolean" },
    "twitch_url": { "type": "string", "format": "uri" },
    "fide": { "type": "integer", "description": "FIDE rating, when available." },
    "verified": { "type": "boolean" }
  },
  "additionalProperties": true
}