API v1 · Stable

Legal Land Description API for Developers

Convert PLSS township, range, and section to GPS coordinates with simple HTTP requests. Batch processing, autocomplete suggestions, and map tile overlays. Supports 30+ states and all 37 principal meridians.

Get API Key →
Convert LLD to Coordinates
// npm install townshipamerica
import { TownshipClient } from 'townshipamerica'

const client = new TownshipClient({ apiKey: 'your_api_key' })
const result = await client.search('14S 15E 6th Meridian')
console.log(result.latitude, result.longitude)
Powering land data workflows in
Oil & Gas
Real Estate
Insurance
Agriculture
Getting Started

Quick Start

Start converting legal land descriptions to GPS coordinates in under 5 minutes.

1

Create an Account

Sign up at townshipamerica.com/app and navigate to your account settings.

2

Get Your API Key

Generate an API key from your dashboard. Keep it secure — it's your access token.

Official SDKs Available

Install the official client for your language — full types, batch endpoints, and error handling included.

npm install townshipamerica
npm →
pip install townshipamerica
PyPI →
3

Make Your First Request

Use your API key to convert a legal land description:

terminal
curl "https://developer.townshipamerica.com/search/legal-location?location=14S 15E 6th Meridian" \
  -H "X-API-Key: your_api_key"

Code Examples

cURL
curl "https://developer.townshipamerica.com/search/legal-location?location=14S+15E+6th+Meridian" \
  -H "X-API-Key: 1234567890abcdefghij"
TypeScript SDK npm →
// npm install townshipamerica
import { TownshipClient } from 'townshipamerica'

const client = new TownshipClient({ apiKey: '1234567890abcdefghij' })
const result = await client.search('14S 15E 6th Meridian')
console.log(result.latitude, result.longitude)
Python SDK PyPI →
# pip install townshipamerica
from townshipamerica import TownshipAmerica

client = TownshipAmerica(api_key="your_api_key")
result = client.search("14S 15E 6th Meridian")
print(result.features[0].properties)

Try It Now

Live Demo
GET/search/legal-location?location=NENE%2025%205N%2030E%20Mount%20Diablo%20Meridian
Response
Response will appear here...
Security

Authentication

All API requests require authentication using your API key.

Include your API key in the request header:

X-API-Key: your_api_key

Base URL:https://developer.townshipamerica.com

Convert Coordinates to Legal Description

Get the legal land description for any GPS coordinate.

GET/search/coordinates
Autocomplete API

Smart Suggestions

Real-time suggestions as users type legal descriptions.

GET/autocomplete/legal-location
Maps API

Map Tiles API

PLSS grid overlay tiles for your mapping applications.

Tile URL Pattern

https://maps.townshipamerica.com/{layer}/{z}/{x}/{y}.mvt?api_key=...
Available Layers
State Grid Layers Label Layers
All PLSS Statestwpfirst-divisionsecond-divisiontwp_labelfirst_division_labelsecond_division_label
Reference

Error Codes

Code Status Description
400Bad RequestInvalid legal land description
401UnauthorizedMissing or invalid API key
429Too Many RequestsRate limit exceeded
500Server ErrorInternal error — try again

Rate Limits

Rate limits vary by plan tier.

Build

1 req/sec
1,000 req/month

Scale

5 req/sec
10,000 req/month

Enterprise

25 req/sec
100,000 req/month

OpenAPI Specification

Download our OpenAPI 3.0 specification for code generation, testing, and documentation.

openapi.yaml

OpenAPI 3.0 · YAML format

Use with popular tools
Swagger UI Postman Insomnia OpenAPI Generator
Plans

API Pricing

Simple, predictable pricing.

Monthly
Annual Save 2 months

Build

For development & testing

$20 /month
  • 1,000 requests/mo
  • $0.02/request
  • 1/sec
  • Unlimited API keys
Get Started →
Most Popular

Scale

For production apps

$100 /month
  • 10,000 requests/mo
  • $0.01/request
  • 5/sec
  • Unlimited API keys
Get Started →

Enterprise

For high-volume needs

$500 /month
  • 100,000 requests/mo
  • $0.005/request
  • 25/sec
  • Unlimited API keys
Get Started →
Need higher volume? Contact us for enterprise solutions.

Frequently Asked Questions

Is there a free PLSS API?

Yes. Township America offers a free tier with a limited number of requests per month — enough to build and test your integration before committing to a paid plan. See all plans.

How accurate is the PLSS geocoding?

Professional-grade accuracy sourced directly from BLM survey data. Results include a confidence score so your application can handle edge cases appropriately.

Can I batch convert PLSS descriptions via API?

Yes. The batch endpoint accepts arrays of up to 100 legal descriptions per request, returning coordinates for all of them in a single response. Batch conversion guide.

What response formats are supported?

All endpoints return JSON with GPS coordinates, confidence scores, parsed description components, and optionally GeoJSON geometry for boundary polygons.

Ready to convert legal land descriptions programmatically?

Get your API key and start converting township, range, and section to GPS coordinates in minutes.

Get API Key