How to Use DiscGolfAPI Course Data in Your App, Site or Club

Fetch a paginated list of courses in Great Britain.

Sample request

fetch("https://io.discgolfapi.com/v1/courses?country=GB&limit=5&offset=0")
  .then(response => response.json())
  .then(data => console.log(data));

{
  "count": 5,
  "total": 30,
  "offset": 0,
  "courses": [
    {
      "id": "crs_ackers_adventure",
      "name": "Ackers Adventure",
      "country_code": "GB",
      "region_code": "ENG"
    }
  ]
}

Use limit and offset for maps, directories, and country pages that load in pages. Hole counts are currently sparse, so handle holes: null as “unknown”.

Fetch one course by its public ID.

Sample request

fetch("https://io.discgolfapi.com/v1/courses/crs_a6_discgolfpark")
  .then(response => response.json())
  .then(data => console.log(data));

{
  "count": 1,
  "courses": [
    {
      "id": "crs_a6_discgolfpark",
      "name": "A6 Discgolfpark",
      "country_code": "SE",
      "holes": 18,
      "confidence_score": 0.75,
      "verification_strength": "strong"
    }
  ]
}

Use this for course pages and detailed views.

Fetch countries currently represented in the API.

Sample request

fetch("https://io.discgolfapi.com/v1/countries")
  .then(response => response.json())
  .then(data => console.log(data));

{
  "countries": [
    {
      "country_code": "GB",
      "country_name": "United Kingdom",
      "course_count": 30,
      "updated_at": "2026-04-30T20:30:58.267177Z"
    }
  ]
}

Use this to build filters and navigation.

Fetch regions currently represented in the API.

Sample request

fetch("https://io.discgolfapi.com/v1/regions")
  .then(response => response.json())
  .then(data => console.log(data));

{
  "regions": [
    {
      "country_code": "GB",
      "region_code": "ENG",
      "region_name": "England",
      "course_count": 28,
      "updated_at": "2026-04-30T20:30:58.267177Z"
    }
  ]
}

Use this for regional pages, filters, and maps.

Submit a correction or flag a course data issue.

Sample request

fetch("https://io.discgolfapi.com/v1/report", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    course_id: "crs_a6_discgolfpark",
    type: "wrong_data",
    message: "The course has recently changed from 9 holes to 18 holes."
  })
})
  .then(response => response.json())
  .then(data => console.log(data));

{
  "ok": true,
  "id": "d1762815-c4f1-48e5-a89b-69c3a6932fbe"
}

Use this when you spot missing, outdated, or incorrect course data.