Sportmonks · Schema

Sportmonks Player

Schema for a Sportmonks Football player entity returned by the /players endpoint.

CricketDataDeveloper-FriendlyFootballFormula 1LivescoresMotorsportReal-TimeSoccerSportsSports DataStatistics

Properties

Name Type Description
id integer Unique player identifier.
sport_id integer Sport identifier.
country_id integernull Country identifier.
nationality_id integernull Nationality identifier.
city_id integernull City of birth identifier.
position_id integernull Position identifier.
detailed_position_id integernull Detailed position identifier.
type_id integernull Player type identifier.
common_name string Common name.
firstname string First name.
lastname string Last name.
name string Full name.
display_name string Display name.
image_path string Player headshot URL.
height integernull Height in centimeters.
weight integernull Weight in kilograms.
date_of_birth stringnull Date of birth.
gender string Player gender.
View JSON Schema on GitHub

JSON Schema

sportmonks-player-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.sportmonks.com/schemas/player.json",
  "title": "Sportmonks Player",
  "description": "Schema for a Sportmonks Football player entity returned by the /players endpoint.",
  "type": "object",
  "required": ["id", "name", "sport_id"],
  "properties": {
    "id": { "type": "integer", "description": "Unique player identifier." },
    "sport_id": { "type": "integer", "description": "Sport identifier." },
    "country_id": { "type": ["integer", "null"], "description": "Country identifier." },
    "nationality_id": { "type": ["integer", "null"], "description": "Nationality identifier." },
    "city_id": { "type": ["integer", "null"], "description": "City of birth identifier." },
    "position_id": { "type": ["integer", "null"], "description": "Position identifier." },
    "detailed_position_id": { "type": ["integer", "null"], "description": "Detailed position identifier." },
    "type_id": { "type": ["integer", "null"], "description": "Player type identifier." },
    "common_name": { "type": "string", "description": "Common name." },
    "firstname": { "type": "string", "description": "First name." },
    "lastname": { "type": "string", "description": "Last name." },
    "name": { "type": "string", "description": "Full name." },
    "display_name": { "type": "string", "description": "Display name." },
    "image_path": { "type": "string", "format": "uri", "description": "Player headshot URL." },
    "height": { "type": ["integer", "null"], "description": "Height in centimeters." },
    "weight": { "type": ["integer", "null"], "description": "Weight in kilograms." },
    "date_of_birth": { "type": ["string", "null"], "format": "date", "description": "Date of birth." },
    "gender": { "type": "string", "enum": ["male", "female"], "description": "Player gender." }
  }
}