Main Menu

PDGA REST API Services

Base URL: https://api.pdga.com

This service returns player data for all members current or expired. It does not return the player rating for members who are not current.

  • Endpoint/services/json/players
  • Method: GET

Headers

  • Cookie: session_name=sessid

Parameters

  • pdga_number
  • last_name
  • first_name
  • class P, A
  • city
  • state_prov (two to three character administrative area, region, state or province code)
  • country (two-letter country code)
  • last_modified YYYY-MM-DD
  • limit (default: 10; max: 200)
  • offset (default: 0)

Example

Request

curl "https://api.pdga.com/services/json/players?pdga_number=1"  \
     -H 'Cookie: session_name=sessid'

Response

{
  "sessid": "gulgLuoc523YfpbjJbndX_92P0yCzqZk4KUS3CaKcKA",
  "status": 0,
  "players": [
    {
      "first_name": "Steady Ed",
      "last_name": "Headrick",
      "pdga_number": "1",
      "membership_status": "current",
      "membership_expiration_date": "2200-12-31",
      "classification": "P",
      "city": "Watsonville",
      "state_prov": "CA",
      "country": "US",
      "rating": "1000",
      "rating_effective_date": "2020-08-11",
      "official_status": "yes",
      "official_expiration_date": "2023-11-09",
      "last_modified": "2020-07-09"
    }
  ]
}

Player Statistics

This service returns player statistics for active members who were current and participated in one or more events in a given year.

  • Endpoint: /services/json/player-statistics
  • Method: GET

Headers

  • Cookie: session_name=sessid

Parameters

  • year YYYY
  • class P, A
  • division_name
  • division_code (three to four character division code)
  • continent (two-letter continent code)
  • country (two-letter country code)
  • state_prov (two to three character administrative area, region, state or province code)
  • gender M, F
  • pdga_number
  • last_modified YYYY-MM-DD
  • limit (default: 10; max: 200)
  • offset (default: 0)

Example

Request

curl "https://api.pdga.com/services/json/player-statistics?year=2020&division_code=MPO"  \
     -H 'Cookie: session_name=sessid'

Response

{
  "sessid": "gulgLuoc523YfpbjJbndX_92P0yCzqZk4KUS3CaKcKA",
  "status": 0,
  "players": [
    {
      "first_name": "Emerson",
      "last_name": "Keith",
      "pdga_number": "47472",
      "rating": "1025",
      "year": "2020",
      "class": "P",
      "gender": "Male",
      "division_name": "Open",
      "division_code": "MPO",
      "country": "United States",
      "state_prov": "TX",
      "tournaments": "33",
      "rating_rounds_used": "86",
      "points": "19815",
      "prize": "21216.67",
      "last_modified": "2020-11-16"
    },
    ...
  ]
}

This service will return events matching the requested parameters.

  • Endpoint/services/json/event
  • Method: GET

Headers

  • Cookie: session_name=sessid

Parameters

  • tournament_id
  • event_name
  • start_date YYYY-MM-DD
  • end_date YYYY-MM-DD
  • country (two letter country code)
  • state (two letter administrative area, region, state or province code)
  • province (two letter administrative area, region, state or province code)
  • tier (comma separated list of tier codes)
  • classification Pro, Am, Pro-Am
  • limit (default: 10; max: 200)
  • offset (default: 0)

Example

Request

curl "https://api.pdga.com/services/json/event?tier=NT,M&start_date=2021-01-01&end_date=2021-12-31&limit=50"  \
     -H 'Cookie: session_name=sessid'

Response

    "events": [
    {
      "tournament_id": "47877",
      "tournament_name": "DGPT - Las Vegas Challenge presented by Innova",
      "city": "Henderson",
      "state_prov": "NV",
      "country": "United States",
      "latitude": "36.0376448",
      "longitude": "-115.0762536",
      "start_date": "2021-02-25",
      "end_date": "2021-02-28",
      "class": "Pro",
      "tier": "NT",
      "status": "sanctioned",
      "format": "singles",
      "tournament_director": "Jeff Jacquart",
      "tournament_director_pdga_number": "10749",
      "asst_tournament_director": "Chris Arnold",
      "asst_tournament_director_pdga_number": "79313",
      "event_email": "[email protected]",
      "event_phone": "702-249-0387",
      "event_url": "https://www.pdga.com/tour/event/47877",
      "website_url": "http://www.lvcdg.com",
      "registration_url": "https://www.discgolfscene.com/tournaments/2021_Las_Vegas_Challenge_presented_by_Innova_DGPT_Elite_Series/register",
      "last_modified": "2020-11-05"
    },
    {
      "tournament_id": "47512",
      "tournament_name": "26th Annual Texas State Disc Golf Championship Presented by Latitude 64 - National Tour",
      "city": "Tyler",
      "state_prov": "TX",
      "country": "United States",
      "latitude": "32.3243856",
      "longitude": "-95.2997959",
      "start_date": "2021-03-25",
      "end_date": "2021-03-28",
      "class": "Pro",
      "tier": "NT",
      "status": "sanctioned",
      "format": "singles",
      "tournament_director": "Steven Storrie",
      "tournament_director_pdga_number": "44083",
      "asst_tournament_director": "Ryan Draper",
      "asst_tournament_director_pdga_number": "55587",
      "event_email": "[email protected]",
      "event_phone": "940-453-0197",
      "event_url": "https://www.pdga.com/tour/event/47512",
      "website_url": "http://TexasStatesDG.com",
      "registration_url": "https://www.discgolfscene.com/tournaments/2021_Texas_State_Disc_Golf_Championships_Presented_by_Latitude_64/register",
      "last_modified": "2020-10-23"
    },
    ...
  ]
}

This service will return courses matching the requested parameters.

  • Endpoint/services/json/course
  • Method: GET

Headers

  • Cookie: session_name=sessid

Parameters

  • course_name
  • postal_code
  • city
  • country (two-letter country code)
  • state_prov (two to three character administrative area, region, state or province code)
  • latitude
  • longitude
  • course_id
  • limit (default: 10; max: 200)
  • offset (default: 0)

Example

Request

curl "https://api.pdga.com/services/json/course?state_prov=VA"  \
     -H 'Cookie: session_name=sessid'

Response

  "sessid": "gulgLuoc523YfpbjJbndX_92P0yCzqZk4KUS3CaKcKA",
  "status": 0,
  "courses": [
    {
      "course_id": "2146",
      "course_node_nid": "25393",
      "course_name": "Bluemont Park",
      "course_type": "Permanent",
      "course_description": "Tight fairways, hills, trees, and a creek all come into play. 3 cement tees and 4 pin placements on every hole. Plays like 27.",
      "distance": "",
      "latitude": "38.868250000000",
      "longitude": "-77.130619000000",
      "location_type": "tee",
      "city": "Arlington",
      "street": "329 N. Manchester St.",
      "street2": "",
      "state_province": "VA",
      "postal_code": "22201",
      "state_province_name": "Virginia",
      "country": "United States",
      "holes": "9",
      "directions": "I-495 (Capital Beltway west of DC) to Rte. 50 E (Arlington Blvd.), 4.5 miles, left on N. Manchester St., right into park. Park at far right end of parking lot. 1st tee past restrooms, kiddy playland and basketball court",
      "basket_types": "Mach3",
      "tee_types": "Concrete",
      "total_length_of_course": "1960",
      "total_length_of_alternate": "3000",
      "number_of_holes_less_than_300": "8",
      "number_of_holes_between_300_and_400": "1",
      "number_of_holes_greater_than_400": "0",
      "camping": "no",
      "facilities": "yes",
      "fees": "no",
      "handicap": "no",
      "private": "no",
      "signage": "yes",
      "contact_name": "Tim Beron",
      "contact_pdga_number": "3956",
      "contact_home_phone": "703-256-5191",
      "course_foliage": "5",
      "course_elevation": "5",
      "legacy_course_courseid": "2146",
      "year_established": "1980",
      "external_link_1_url": "http://www.novadiscgolf.org",
      "external_link_1_title": "NOVA Disc Golf Association",
      "created": "9/2/2009",
      "update": "10/18/2016"
    },
    ...
  ]
}

Developer Program