REST API v1
Federal Land reports
Query federal land ownership, leases, environmental constraints and public access.
On this page
Federal Land API
Federal Land Parcel Reports
A 15-layer federal land report for any PLSS tract: surface management, BLM leases and rights-of-way, flood zones, mining claims, wetlands, firesheds, soils, orphaned wells, critical habitat, public access, and wildfire risk. Texas abstract input returns 400 texas_not_supported.
GET /federal-land/report
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| legal_location | string | Required | PLSS legal description (e.g. 'Sec 12 T4N R5E Willamette Meridian'). Texas abstract/block/survey input returns 400 texas_not_supported NE 12 4N 5E Indian Meridian |
| include | string | Optional | Comma-separated sections to return (omit for the full report). Pruned sections skip their spatial queries. geometry attaches the parcel polygon surface_management,flood_zones,geometrysurface_management , og_leases , geothermal_leases , rights_of_way , flood_zones , mining_claims , wetlands , fireshed , soils , crop_history , orphaned_wells , critical_habitat , public_access , wildfire_risk_communities , elevation , geometry |
Example Response
response.json
{
"legal_location": "NE 12 4N 5E Indian Meridian",
"resolved_legal_location": "NE 12 4N 5E Indian Meridian",
"alternate_legal_location": "NE 12 T4N R5E Indian PM",
"unit": "Second Division",
"state": "Oklahoma",
"county": "Pottawatomie",
"report_scope": "parcel",
"parcel": { "centroid": { "lng": -96.93, "lat": 35.24 }, "geometry": null },
"surface_management": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "agency": "Bureau of Land Management", "admin_unit": "Oklahoma Field Office" }
] },
"og_leases": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "serial": "OKNM 012345", "status": "Authorized", "lessee": "EXAMPLE ENERGY LTD", "expiration": "2031-05-31", "location": { "lng": -96.93, "lat": 35.24 } }
] },
"geothermal_leases": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] },
"rights_of_way": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "serial": "OKOK 054321", "use_type": "Road", "holder": "EXAMPLE COUNTY", "status": "Authorized", "location": { "lng": -96.928, "lat": 35.239 } }
] },
"flood_zones": { "total": 2, "returned": 2, "truncated": false, "more": false, "rows": [
{ "zone": "A", "subtype": null, "sfha": true, "bfe": null },
{ "zone": "X", "subtype": "AREA OF MINIMAL FLOOD HAZARD", "sfha": false, "bfe": null }
] },
"mining_claims": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] },
"wetlands": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "wetland_type": "Freshwater Emergent Wetland", "attribute": "PEM1C", "acres": 3.6 }
] },
"fireshed": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "name": "Shawnee", "exposure_class": "Moderate", "exposure_pct": 22.5, "homes_at_risk": 120 }
] },
"soils": { "total": 2, "returned": 2, "truncated": false, "more": false, "rows": [
{ "mukey": "1712345", "name": "Dennis silt loam, 1 to 3 percent slopes", "prime_farmland": "All areas are prime farmland", "hydric": "No" }
] },
"crop_history": { "year": 2025, "dominant_crop": "Winter Wheat", "dominant_crop_pct": 64.2, "distribution": { "Winter Wheat": 64.2, "Grassland/Pasture": 30.1 } },
"orphaned_wells": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] },
"critical_habitat": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "common_name": "American Burying Beetle", "scientific_name": "Nicrophorus americanus", "listing_status": "Threatened", "unit_name": null, "feature_kind": "polygon" }
] },
"public_access": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "plad_id": "OK-000123", "access_class": "Open", "access_method": "Public road", "acres": 160, "admin_unit": "Oklahoma Field Office" }
] },
"wildfire_risk_communities": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [
{ "block_geoid": "401259876003021", "risk_to_homes": 0.32, "burn_probability": 0.0011, "exposure_type": "Directly exposed", "housing_units": 14 }
] },
"elevation": { "elev_min_m": 302.4, "elev_mean_m": 311.8, "elev_max_m": 322.1, "slope_mean_deg": 1.9, "aspect_dominant": "S" },
"meta": {
"unavailable": [{ "section": "geothermal_leases", "reason": "no_state_coverage" }],
"sources": { "...": "..." }
}
} Scalar sections (crop_history, elevation) and geometry are include= values on /report, not routes. A layer with no_state_coverage in meta.unavailable has no data in that state at all; an empty array is only an all-clear when the layer is covered.