API Documentation

Integrate GRID into your applications. Convert Legal Subdivision identifiers to coordinates programmatically.

Base URL

https://api.goodw1n.ca

Get Started in 30 Seconds

  1. 1

    Create an account

    Sign up for free to get access to the API.

  2. 2

    Generate an API key

    Go to Developer Settings and create a key.

  3. 3

    Make your first request

    bashcurl -H "X-API-Key: lsd_live_your_key_here" \
      https://api.goodw1n.ca/convert/08-15-052-04W5

Response Format

All endpoints return JSON. A successful conversion returns the LSD polygon coordinates, centroid, and metadata.

json{
  "lsd": 8, "section": 15, "township": 52,
  "range": 4, "meridian": "W5",
  "province": "Alberta",
  "centroid": { "lat": 52.1234, "lng": -114.5678 },
  "corners": {
    "sw": { "lat": 52.122, "lng": -114.569 },
    "se": { "lat": 52.122, "lng": -114.566 },
    "ne": { "lat": 52.125, "lng": -114.566 },
    "nw": { "lat": 52.125, "lng": -114.569 }
  },
  "utm": {
    "zone": 11, "letter": "U",
    "easting": 567890, "northing": 5778901
  }
}