Skip to documentation
Developer documentation
Get API key
REST API v1

Texas reports

Query Texas abstracts, leases, units, wells and RRC production.

On this page
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_locationstringRequiredTexas 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
includestringOptionalComma-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": { "...": "..." } }
}

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.