--- title: "Energy reports - Township America" description: "Query parcel intelligence, wells, operators, leases, royalties and pipelines." url: https://townshipamerica.com/api/docs/energy --- # Energy reports Query parcel intelligence, wells, operators, leases, royalties and pipelines. Energy API ## Energy Parcel Reports Wells, operators, federal leases, ONRR royalties, orphaned wells, pipelines, FracFocus disclosures, and siting constraints for any parcel. `legal_location` accepts both grids: PLSS legal descriptions (aliquot wording included) and Texas abstract/block/survey descriptions. ### GET /energy/report ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | | include | string | Optional | Comma-separated sections to return (omit for the full report). Omitted sections' queries never run. geometry attaches the parcel polygon wells,pipelines,geometrywells , operators , leases , royalties , orphaned\_wells , pipelines , fracfocus , constraints , 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", "state_code": "OK", "county": "Pottawatomie", "parcel": { "centroid": { "lng": -96.93, "lat": 35.24 }, "geometry": null }, "summary": { "wells_in_section": 3, "wells_nearby": 14, "operators_nearby": 5, "federal_leases": 1, "orphaned_wells": 0, "pipelines_within_radius": 2, "fracfocus_disclosures": 4 }, "wells": { "in_section": { "total": 3, "returned": 3, "truncated": false, "more": false, "rows": [ { "api_number": "35125123450000", "source_state": "OK", "operator": { "name": "EXAMPLE OPERATING LLC" }, "status": "Active", "spud_date": "2019-04-02", "formation": "Woodford", "location": { "lng": -96.931, "lat": 35.241 }, "distance_miles": 0.12 } ] }, "nearby": { "radius_mi": 1, "total": 14, "returned": 14, "truncated": false, "more": false, "rows": [{ "...": "..." }] } }, "operators": { "radius_mi": 1, "total": 5, "returned": 5, "truncated": false, "more": false, "rows": [{ "operator": { "name": "EXAMPLE OPERATING LLC" }, "well_count": 6 }] }, "leases": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [ { "serial": "OKNM 012345", "status": "Authorized", "holder": { "name": "EXAMPLE ENERGY LTD" }, "effective_date": "2021-06-01", "expiration_date": "2031-05-31", "acreage": 160, "commodity": "Oil and Gas", "location": { "lng": -96.93, "lat": 35.24 } } ] }, "royalties": { "scope": "county", "state": "Oklahoma", "county": "Pottawatomie", "years": 10, "total_usd": 1245300.5, "royalties": [{ "commodity": "Oil", "royalty_usd": 812400.25 }, { "commodity": "Gas", "royalty_usd": 432900.25 }] }, "orphaned_wells": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "pipelines": { "radius_mi": 5, "total": 2, "returned": 2, "truncated": false, "more": false, "rows": [ { "kind": "gas", "kind_raw": "Gas", "operator": { "name": "EXAMPLE PIPELINE CO" }, "label": "Interstate", "status": "Active", "distance_miles": 1.84 } ] }, "fracfocus": { "radius_mi": 1, "total": 4, "returned": 4, "truncated": false, "more": false, "rows": [ { "api_number": "35125123450000", "operator": { "name": "EXAMPLE OPERATING LLC" }, "well_name": "EXAMPLE 12-4N-5E 1H", "state": "OK", "county": "Pottawatomie", "disclosure_date": "2023-09-14", "total_water_gal": 9800000, "total_proppant_lbs": 11200000, "location": { "lng": -96.932, "lat": 35.242 }, "distance_miles": 0.31 } ] }, "constraints": { "split_estate": { "is_split_estate": true, "surface": { "type": "private", "agency": null, "coverage_pct": 0 }, "subsurface": { "type": "federal", "agency": "BLM", "coverage_pct": 0.62 } }, "sage_grouse": { "in_habitat": false, "habitat_count": 0, "habitats": [] }, "renewable_siting": { "nrel_score": 71.4, "blm_solar_zone": null, "wind_turbines_within_2mi": 3, "notes": ["3 wind turbines within 2 miles"] } }, "meta": { "unavailable": [], "sources": { "...": "..." } } } ``` ### GET /energy/summary ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | ### GET /energy/wells ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | | radius\_mi | number | Optional | Search radius in miles (default: 1, max: 5). An out-of-range value is a 400, never a silent fallback | ### GET /energy/operators ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | | radius\_mi | number | Optional | Search radius in miles (default: 1, max: 5). An out-of-range value is a 400, never a silent fallback | ### GET /energy/leases ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | ### GET /energy/royalties ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | ### GET /energy/orphaned-wells ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | ### GET /energy/pipelines ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | | radius\_mi | number | Optional | Search radius in miles (default: 5, max: 10). An out-of-range value is a 400, never a silent fallback | ### GET /energy/fracfocus ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | | radius\_mi | number | Optional | Search radius in miles (default: 1, max: 5). An out-of-range value is a 400, never a silent fallback | ### GET /energy/constraints ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | PLSS legal description (aliquot wording included) OR Texas abstract/block/survey description; both grids are accepted NE 12 4N 5E Indian Meridian | FracFocus rows require "Data: FracFocus.org" attribution; NREL siting scores are CC-BY 4.0\. An out-of-range `radius_mi` is a `400`, never a silent fallback.