Skip to content
Get a key
API reference / Golf
GET/golf/players/{id}

Get a golfer

Profile (country, birth date and place, PGA Tour rank and the provider's season earnings) and the season's tournaments from our leaderboards with a summary (events, wins, top 10s, cuts made, earnings)

In preview, not in plans yetPay per call without a key: $0.005 in USDC

Parameters

  • idinteger · pathrequired

    Player ID

  • seasoninteger · query

    Season (default: the latest the player has results in)

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataobject
  • birth_datestring
  • birth_placestring
  • countrystring
  • idinteger
  • namestring
  • pga_rankinteger
  • profile_earningsinteger

    the provider's figure

  • resultsarray of object
  • earningsinteger
  • holesarray of integer
  • playerobject
  • positioninteger
  • roundsarray of integer
  • statsarray of integer

    birdies, eagles, pars, bogeys, double_bogeys, driving_distance, driving_accuracy_pct, gir_pct, putts_per_gir, saves_pct

  • statusstring

    active, finished, cut, wd

  • thrustring
  • tiedboolean
  • to_parinteger
  • todayinteger
  • totalinteger
  • tournamentobject
  • seasoninteger
  • season_summaryobject
  • cuts_madeinteger
  • earningsinteger
  • eventsinteger
  • top10sinteger
  • winsinteger
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
404NOT_FOUNDNo record with that id.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?