5-Minute Setup
API Quick Start Guide
Get up and running with the Township Canada API in just a few minutes. Follow these steps to start converting legal land descriptions.
1
2
Subscribe to an API Plan
Choose an API tier that fits your needs. Start with Build for development and testing.
View Plans3
Generate an API Key
Go to the Developer Portal and create your first API key. Keep it secure!
Developer Portal4
Make Your First Request
Use the code examples below to convert your first legal land description.
Example Code
Request
// Your first API request
const API_KEY = 'tc_live_YOUR_API_KEY';
const response = await fetch(
'https://api.townshipcanada.com/v1/search?q=SW-25-24-1-W5',
{
headers: {
'Authorization': `Bearer ${API_KEY}`
}
}
);
const data = await response.json();
console.log('Legal Location:', data.legal_location);
console.log('Coordinates:', data.centroid);
console.log('Province:', data.province);
// Output:
// Legal Location: SW-25-024-01-W5
// Coordinates: 51.454928,-114.648933
// Province: AlbertaResponse
{
"search_term": "SW-25-24-1-W5",
"legal_location": "SW-25-024-01-W5",
"province": "Alberta",
"centroid": "51.454928,-114.648933",
"geometry": "POLYGON((-114.68239..., 51.44678...),...)",
"type": "qtr"
}Supported Input Formats
DLS (Prairies)
Alberta, Saskatchewan, Manitoba
- SW-25-24-1-W5
- NW 36-42-3 W5
- LSD 10-25-24-1-W5
NTS (BC/North)
British Columbia, Yukon, NWT
- 093G/14
- 093G14
- 082E/05
Ontario Townships
Ontario lot/concession system
- Lot 5, Con 3, King
- Lot 12, Concession 8
River Lots
Manitoba river lot system
- River Lot 25
- Parish of St. Norbert
Coordinates
Decimal degrees or DMS
- 51.0447, -114.0719
- 51°2'41"N 114°4'19"W
Addresses
Canadian street addresses
- 123 Main St, Calgary
- Edmonton, Alberta