Posted on February 6, 2024

Legal Land Description API Integration Guide

Integrate Township Canada's legal land description services directly into your applications and workflows. Our REST APIs enable LLD-to-coordinate conversion, autocomplete search, batch processing, and interactive grid maps—all with simple JSON responses.

API integration

Quick start

  1. Get an API key: Log into your Township Canada account, go to "My Account" → "API Access", select a plan
  2. Make your first request: Add your API key to the request header
  3. Parse the response: All APIs return JSON with coordinates, legal descriptions, and metadata

For full documentation and code examples, visit the developers page.

API endpoints

Township Canada offers four distinct API endpoints: Search, Autocomplete, Batch, and Maps.

  • Search API: Convert legal land descriptions to geographic coordinates and vice versa. Supports DLS, NTS, Geographic Townships, and FPS formats.
  • Autocomplete API: Search legal land descriptions with partial text. Returns up to 10 matching results with coordinates—ideal for search boxes and type-ahead interfaces.
  • Batch API: Process up to 100 records per request. Convert lists of legal land descriptions to coordinates or coordinates to legal land descriptions.
  • Maps API: Display legal survey grids on maps in your web or mobile applications. Vector tiles format compatible with Mapbox GL, Leaflet, and other mapping libraries.

Common integration patterns

Real Estate Applications

Add legal land description lookup to property search interfaces. Use the Autocomplete API for type-ahead search and the Search API for coordinate conversion.

Oil & Gas Software

Integrate batch conversion for well location management. Use the Maps API to display DLS/NTS grids in custom mapping applications.

Mobile Field Apps

Add LLD search and coordinate conversion for field workers. The APIs work with any mobile development framework (React Native, Flutter, native iOS/Android).

GIS Platforms

Enhance ArcGIS, QGIS, or custom GIS tools with legal land description support. Batch API enables bulk coordinate conversion for spatial analysis.

Agriculture Technology

Add quarter section and LSD lookup to farm management software. Combine with soil and boundary data for precision agriculture applications.

Getting an API key

To use Township Canada's APIs, an API key is required. Obtain yours by:

  • Logging into your Township Canada account.
  • Navigating to "API Access" under "My Account" in the main menu.
  • Selecting the desired tier and billing cycle for the API endpoint, then clicking "Select Plan".
  • Upon plan selection, you'll receive a unique API key for your account, necessary for API request authentication.

API pricing tiers

Each API (Search, Autocomplete, Batch, Maps) has separate subscription plans with different quotas and concurrent request limits. Choose monthly or annual billing, upgrade or downgrade anytime. See complete API pricing on the developers page.

Managing API subscriptions

Manage your API subscriptions in the "API Access" section. Choose from various tiers for monthly or annual subscriptions. Each tier has a limit on concurrent requests and a monthly quota for API calls. Exceeding the quota results in HTTP 429 Too Many Requests until the next cycle. Regularly check your API usage and adjust your tier as needed in the "API Usage" section. Subscription updates, tier changes, or cancellations are manageable anytime, with API access continuing until the end of the current billing cycle.

Checking system health

For the current status of Township Canada's APIs, including uptime, response time, and incident history, visit status.townshipcanada.com. This site provides real-time updates on API system health.

Need help with your integration? Contact us for technical support and custom API solutions.