API Reference

RESTful API with predictable endpoints, consistent responses, and comprehensive documentation.

Authentication

All API requests require authentication via API key. Include your key in the request header.

API keys are scoped to your account
Rotate keys anytime from your dashboard
Separate keys for development and production

Request Header

Authorization: Bearer mfd_live_xxxxxxxxxxxxx

// Or as query parameter
GET /v1/tiles/parcels/12/1234/2345?api_key=mfd_live_xxxxx

Core Endpoints

Base URL: https://api.mapsfordevelopers.com

GET/v1/tiles/{layer}/{z}/{x}/{y}

Retrieve vector tiles for a specific layer and tile coordinates

layer: parcels, pois, terrain, satellitez: zoom level (0-22)x, y: tile coordinates

GET/v1/geocode

Convert addresses to coordinates (forward geocoding)

q: address stringlimit: max results (default 5)

GET/v1/reverse

Convert coordinates to addresses (reverse geocoding)

lat: latitudelon: longitude

GET/v1/search

Search POIs and parcels by query

q: search querytype: poi, parcel, addressbbox: bounding box

GET/v1/parcel/{id}

Get detailed parcel information by ID

id: parcel identifier

GET/v1/layers

Browse the full data catalog — every layer available on the platform with metadata, coverage, and attributes

category: hunting, base, enrichment, infrastructure, or all (default)state: 2-letter state code to filter layers

GET/v1/offline/packages

List downloadable offline map packages for a state with sizes and authenticated download URLs

state: 2-letter state code (required)layers: comma-separated layer IDs to filter (optional)

GET/v1/offline/{path}

Download a full PMTiles file for offline use. Supports HTTP Range requests for resumable downloads. Pro/Enterprise only.

path: R2 file path (e.g., pmtiles/parcels_tx_statewide.pmtiles)Range header: for resumable downloads

Response Format

All responses are JSON with consistent structure. Tile endpoints return Protobuf for optimal performance.

Gzip compression enabled by default

CORS enabled for browser requests

Cache headers for optimal performance

Example Response

{
  "success": true,
  "data": {
    "parcel_id": "TX-DAL-123456",
    "owner": "John Smith",
    "address": "123 Main St",
    "city": "Dallas",
    "state": "TX",
    "assessed_value": 450000,
    "lot_size_sqft": 8500,
    "year_built": 1985,
    "geometry": { "type": "Polygon", ... }
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Rate Limits

Generous limits with clear overage pricing. No surprise bills.

Free

Daily Requests

1,000/day

Burst Rate

10/sec

Developer

Daily Requests

100,000/day

Burst Rate

100/sec

Enterprise

Daily Requests

Unlimited

Burst Rate

Custom

Rate limit headers included in every response: X-RateLimit-Remaining

Offline Downloads

Let your users download full map packages for offline use. All files are PMTiles v3 — use pmtiles.js or maplibre-pmtiles to read them client-side.

Available on Pro and Enterprise plans
Resumable downloads with HTTP Range requests
Parcels, public lands, hunt units, wetlands, terrain & more

Offline Download Flow

// 1. List packages for a state
GET /v1/offline/packages?state=CO
x-api-key: mfd_live_xxxxx

// Response includes download URLs:
{
  "state": "CO",
  "packages": [
    {
      "layer_id": "parcels",
      "name": "CO Property Parcels",
      "estimated_size_mb": 400,
      "download_url": "/v1/offline/pmtiles/..."
    },
    {
      "layer_id": "hunt_units",
      "name": "CO Hunt Unit Boundaries",
      "estimated_size_mb": 15,
      "download_url": "/v1/offline/enrichment/..."
    }
  ]
}

// 2. Download a package (supports Range)
curl -H "x-api-key: mfd_live_xxxxx" \
  -o parcels_co.pmtiles \
  "https://mapsfordevelopers.com/api/v1/offline/..."

Ready to integrate?

Get your API key and start building in minutes