--> --> --> --> --> --> -->

Main Menu

PDGA REST API Services

Note: The PDGA Developer Program is currently closed. We are not accepting new applications for the PDGA Developer Program at this time. We do anticipate opening up the program again in the future once development of an updated version of the API is complete. 

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": "JacquartEventsLLC@gmail.com",
      "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": "Stevo@DynamicDiscs.com",
      "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

-->