--- title: "Texas reports - Township America" description: "Query Texas abstracts, leases, units, wells and RRC production." url: https://townshipamerica.com/api/docs/texas --- # Texas reports Query Texas abstracts, leases, units, wells and RRC production. Texas API ## Texas Abstract Reports & RRC Production GLO leases, pooled units, PSF and state agency lands, RRC wells and pipelines, pending permits, coastal erosion, and lease-level RRC production for any abstract/block/survey tract. PLSS input returns `400 plss_not_supported`; an abstract matching more than one county returns `400 ambiguous_location`, never a silent first-row pick. ### GET /texas/report ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | | include | string | Optional | Comma-separated sections to return (omit for the full report). Pruned sections skip their queries. geometry attaches the parcel polygon state\_leases,production,geometrystate\_leases , state\_units , psf\_lands , state\_agency\_lands , upland\_leases , active\_wells , pipelines , pending\_permits , coastal\_erosion , flood\_zones , wetlands , fireshed , soils , orphaned\_wells , critical\_habitat , wildfire\_risk\_communities , elevation , production , geometry | ##### Example Response response.json ``` { "legal_location": "Abstract 42 Block 3 Reeves County", "resolved_legal_location": "Abstract 42 Block 3 Reeves County Texas", "alternate_legal_location": "A-42 Blk 3 Reeves", "county_fips": "48389", "county": "Reeves", "state": "TX", "abstract_no": "42", "block_no": "3", "survey_name": "H&GN RR CO", "parcel": { "acreage": 640.2, "centroid": { "lng": -103.61, "lat": 31.42 }, "geometry": null }, "state_leases": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [ { "lease_no": "MF123456", "lessee": "EXAMPLE RESOURCES LP", "status": "Active", "mineral_type": "Oil and Gas", "expiration": "2028-02-01", "royalty_rate": 0.25 } ] }, "state_units": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [ { "lease_no": "MF123456", "unit_name": "EXAMPLE UNIT A", "lease_status": "Producing", "lease_type": "Pooled" } ] }, "psf_lands": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "state_agency_lands": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "upland_leases": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "active_wells": { "total": 4, "returned": 4, "truncated": false, "more": false, "rows": [ { "api_number": "42389123450000", "operator": "EXAMPLE RESOURCES LP", "lease_name": "EXAMPLE 42", "well_number": "1H", "status": "Producing", "status_raw": "P", "formation": "Wolfcamp", "field": "PHANTOM (WOLFCAMP)", "location": { "lng": -103.612, "lat": 31.421 } } ] }, "pipelines": { "total": 2, "returned": 2, "truncated": false, "more": false, "rows": [ { "pipeline_id": "T4-08123", "operator_no": "123456", "commodity": "Natural Gas", "diameter_in": 12.75, "status": "In Service", "overlap_point": { "lng": -103.609, "lat": 31.419 } } ] }, "pending_permits": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [ { "permit_no": "891234", "operator_name": "EXAMPLE RESOURCES LP" } ] }, "coastal_erosion": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "flood_zones": { "total": 1, "returned": 1, "truncated": false, "more": false, "rows": [{ "...": "..." }] }, "wetlands": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "fireshed": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "soils": { "total": 2, "returned": 2, "truncated": false, "more": false, "rows": [{ "...": "..." }] }, "orphaned_wells": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "critical_habitat": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "wildfire_risk_communities": { "total": 0, "returned": 0, "truncated": false, "more": false, "rows": [] }, "elevation": { "elev_min_m": 802.1, "elev_mean_m": 811.4, "elev_max_m": 820.9, "slope_mean_deg": 0.8, "aspect_dominant": "SE" }, "production": { "abstract": { "county_fips": "48389", "abstract_no": "42" }, "summary": { "producing_lease_count": 2, "total_cum_boe": 1845200, "total_cum_oil_bbl": 1210400, "total_cum_gas_mcf": 3808800, "ttm_boe": 152300, "first_month": "2018-11", "last_month": "2026-06" }, "leases": { "total": 2, "returned": 2, "truncated": false, "more": false, "rows": [{ "...": "..." }] } }, "meta": { "unavailable": [], "sources": { "...": "..." } } } ``` ### GET /texas/summary ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/state-leases ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/state-units ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/psf-lands ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/state-agency-lands ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/upland-leases ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/pipelines ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/permits ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/coastal-erosion ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Required | Texas abstract/block/survey description ('Abstract 42 Block 3 Reeves County', 'A-123 Reeves County', or a survey name). PLSS input returns 400 plss\_not\_supported; an ambiguous bare abstract returns 400 ambiguous\_location Abstract 42 Block 3 Reeves County | ### GET /texas/wells ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Optional | Texas abstract/block/survey description. Provide either legal\_location OR county\_fips + abstract\_no Abstract 42 Block 3 Reeves County | | county\_fips | string | Optional | 5-digit county FIPS code. Alternative key: pass county\_fips + abstract\_no instead of legal\_location 48389 | | abstract\_no | string | Optional | Abstract number, paired with county\_fips | | block\_no | string | Optional | Block number, to disambiguate where an abstract repeats across blocks | ### GET /texas/production ##### Parameters | Name | Type | Required | Description | | --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | legal\_location | string | Optional | Texas abstract/block/survey description. Provide either legal\_location OR county\_fips + abstract\_no Abstract 42 Block 3 Reeves County | | county\_fips | string | Optional | 5-digit county FIPS code. Alternative key: pass county\_fips + abstract\_no instead of legal\_location 48389 | | abstract\_no | string | Optional | Abstract number, paired with county\_fips | | block\_no | string | Optional | Block number, to disambiguate where an abstract repeats across blocks | ##### Example Response response.json ``` { "county_fips": "48389", "county": "Reeves", "abstract_no": "42", "block_no": "3", "abstract": { "county_fips": "48389", "abstract_no": "42" }, "summary": { "producing_lease_count": 2, "total_cum_boe": 1845200, "total_cum_oil_bbl": 1210400, "total_cum_gas_mcf": 3808800, "ttm_boe": 152300, "first_month": "2018-11", "last_month": "2026-06" }, "leases": { "total": 2, "returned": 2, "truncated": false, "more": false, "rows": [ { "operator": { "name": "EXAMPLE RESOURCES LP" }, "district_no": "08", "lease_no": "45678", "oil_gas_code": "O", "cum_oil_bbl": 812300, "cum_gas_mcf": 2540100, "cum_boe": 1235650, "ttm_oil_bbl": 68200, "ttm_gas_mcf": 231000, "first_month": "2018-11", "last_month": "2026-06", "peak_month": "2019-05", "months_producing": 92, "monthly": [ { "ym": "2026-05", "oil_bbl": 5400, "gas_mcf": 18300, "water_bbl": 21100 }, { "ym": "2026-06", "oil_bbl": 5150, "gas_mcf": 17800, "water_bbl": 20400 } ] } ] }, "meta": { "unavailable": [] } } ``` ### GET /texas/wells/{api} ##### Parameters | Name | Type | Required | Description | | ----- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------- | | {api} | string | Required | Path parameter. Texas API well number with at least 8 digits (API-8 or API-14); non-digits are stripped 42389123 | ##### Example Response response.json ``` { "api8": "42389123", "location": { "api_number": "42389123450000", "location": { "lng": -103.612, "lat": 31.421 }, "operator": { "name": "EXAMPLE RESOURCES LP" }, "lease_name": "EXAMPLE 42", "well_number": "1H", "field": "PHANTOM (WOLFCAMP)", "formation": "Wolfcamp", "status": "Producing", "spud_date": "2018-08-14", "district": "08", "county_fips": "48389", "abstract_no": "42" }, "units": [ { "district_no": "08", "lease_no": "45678", "oil_gas_code": "O", "operator": { "name": "EXAMPLE RESOURCES LP" }, "peak_oil_bbl": 21400, "cum_boe": 412300, "well_count": 1, "denominator_basis": "time_varying" } ], "series": [ { "ym": "2026-05", "oil_bbl": 1810, "gas_mcf": 6100 }, { "ym": "2026-06", "oil_bbl": 1745, "gas_mcf": 5900 } ], "series_unit": { "district_no": "08", "lease_no": "45678", "oil_gas_code": "O" }, "series_covers_all_units": true, "decline": { "available": true, "value": { "qi": 21400, "di": 0.082, "b": 1.1, "r2": 0.94, "points": 88 } }, "decline_curve": [{ "ym": "2026-06", "q": 1738.2 }], "meta": { "unavailable": [], "note": "Volumes are allocated estimates; RRC reports production by lease, never by well." } } ``` Per-well volumes are allocated estimates: RRC reports production by lease, never by well. `denominator_basis` (`time_varying` or `static`) records which denominator produced them, and the decline fit is withheld below R² 0.7\.