← Converter · Contact · Terms · Privacy

Developer API

Use the same conversions as the website from your own software, spreadsheets, GIS or AI assistant. JSON over HTTPS, CORS enabled. Machine-readable spec: openapi.json.

// result appears here

Endpoints

RequestWhat it does
GET /api/convert?q=…Convert one land description, lat, long or UTM.
POST /api/convertBatch: {"queries": ["…", "…"]}, up to 1,000 per request.
GET /api/reverse?lat=…&lon=…The township/section/quarter, quarter section/LSD, NTS unit or grid unit at a point.
GET /api/wells?bbox=w,s,e,n · GET /api/wells?q=…Oil & gas wells (BC, Saskatchewan) in a box (max 0.6°), or search by UWI, licence or name. Open data, attributed in each response.
GET /api/geocode?q=…Address and place search, US and Canada.
POST /api/share · GET /api/share?id=…Create and read team share links.
POST /api/mcpModel Context Protocol endpoint for AI assistants.
GET /api/healthStatus and data version.

Examples

curl "https://townshipconverter.app/api/convert?q=NW%2032%2038%2008%20W3"

curl -X POST "https://townshipconverter.app/api/convert" -H "Content-Type: application/json" \
  -d '{"queries":["12-32-038-08W5","Sec 14 T2N R68W 6th PM CO","13T 502522 4443147"]}'

curl "https://townshipconverter.app/api/reverse?lat=52.3155&lon=-107.1128"

curl "https://townshipconverter.app/api/wells?bbox=-120.30,56.20,-120.10,56.32"
curl "https://townshipconverter.app/api/wells?q=12345"

Google Sheets: =IMPORTDATA("https://townshipconverter.app/api/convert?q="&ENCODEURL(A2)) returns JSON; use Apps Script UrlFetchApp for full control.

AI assistant connector (MCP)

Add https://townshipconverter.app/api/mcp as a custom connector in Claude (Settings → Connectors → Add custom connector) or another MCP-capable assistant. Tools: convert_land_description, convert_batch, reverse_lookup.

Keys & limits

If this deployment requires keys, send X-API-Key: <key> (or ?key=). Requests are rate-limited per IP; contact hello@example.com for higher volumes. Results are for reference only, not a legal survey.