Skip to main content

Your first request

Search for golf clubs within 50 km of Hamburg:

curl 'https://api.eae.golf/v1/clubs?near=Hamburg&country=DE&radius_km=50&limit=20' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

The API resolves Hamburg to coordinates, applies the radius and orders matching clubs by distance. The optional country=DE prevents confusion with places of the same name in other countries.

Successful response​

{
  "data": [
    {
      "id": "86fa999f-d341-4d77-81fa-7810e3d46568",
      "slug": "golfclub-hamburg-gut-waldhof",
      "name": "Golfclub Hamburg Gut Waldhof",
      "location": {
        "town": "Kisdorf",
        "postalCode": "24629",
        "latitude": 53.815292,
        "longitude": 10.087273,
        "distanceMeters": 30184
      },
      "access": {
        "publicAccess": false,
        "independentPlayersAllowed": true,
        "dogsAllowed": true
      },
      "courses": {
        "count": 2
      },
      "greenFees": {
        "minimum": 45,
        "maximum": 89
      }
    }
  ],
  "pagination": {
    "hasMore": false,
    "nextCursor": null
  },
  "meta": {
    "apiVersion": "v1",
    "plan": "fairway",
    "accessStatus": "active",
    "dataAccess": "core",
    "trialEndsAt": null,
    "search": {
      "mode": "place",
      "input": "Hamburg",
      "resolvedName": "Hamburg, Germany",
      "countryCode": "DE",
      "latitude": 53.5511,
      "longitude": 9.9937,
      "radiusKm": 50
    }
  }
}

The club can be registered in a surrounding town and still match because near performs a geographic search. Use town=Hamburg only when the stored postal town itself must be Hamburg.

Add filters​

For example, limit the results to clubs whose known maximum green fee is €80:

curl 'https://api.eae.golf/v1/clubs?near=Hamburg&country=DE&radius_km=50&maximum_green_fee=80&limit=20' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Common errors​

  • 400 Bad Request: Invalid parameters or a place that could not be resolved
  • 401 Unauthorized: Missing, invalid or revoked API key
  • 403 Forbidden: Insufficient permissions or expired access
  • 429 Too Many Requests: Client rate limit exceeded
  • 502 Bad Gateway: Temporary location-provider failure
  • 503 Service Unavailable: Place resolution is not configured

Continue with place and radius search or inspect the API reference.