Texas RRC Data data contract | PatchOps Knowledge

Questions you can ask

“Show me 5 active wells in Midland County.”
“Which drilling permits were filed in Reeves County in the last 30 days?”
“Give me a one-page summary of this well: permits, location, and the last 12 months of production.”

Sample outputfor “Show me 5 active wells in Midland County.”

API	Lease	Operator	Status
42-329-4xxxx	Caprock 12 Unit 1H	Example Operating LLC	Producing
42-329-4xxxx	Mesa Draw 7 2H	Example Operating LLC	Producing
42-329-3xxxx	Spraberry State 4	Sample Resources Inc	Producing

Illustrative values showing the shape of an answer, not live data.

About this source

Texas RRC oil and gas wells, production, pipelines, permits, inspections, violations, plants, fields, and operators. No auth. Use searchWells for rows and countWells for exact grouped totals; county names auto-resolve. Nearby well queries accept latitude, longitude, and radius_meters. Use getWellDetail for a known API and getWellProduction for monthly lease production. searchPipelineSegments supports county, commodity, and exact diameter filters and returns line geometry when include_geometry=true; getPipelineGeoJSON fetches geometry for known segment IDs or pipeline numbers, while searchGisPipelines queries the live GIS layer. Never simulate missing routes. Use searchGisSurveys for parcel polygons.

Connector ID rrc

Provenance

PublisherRailroad Commission of Texas

Sourcehttps://www.rrc.texas.gov/resource-center/research/data-sets-available-for-download/

Docshttps://www.rrc.texas.gov/resource-center/research/data-sets-available-for-download/

Freshness & coverage

FreshnessScheduled — Managed datasets refresh on source-specific schedules; some methods query live RRC public portals.

GeographicTexas

Temporal… → present — Coverage varies by RRC dataset; production methods include historical monthly records while status methods report current records.

AuthenticationNo credentials required

Caveats

⚠ PatchOps serves loaded RRC snapshots whose update times vary by dataset; call rrc.getDataStatus before making recency-sensitive claims.
⚠ Lease production is joined to wells only through the official oil/gas code + district + lease number identity; lease names are display labels, not identifiers.

› Methods (50)

Technical detail for developers: parameters, pagination, units, and freshness per method.

searchWells
read
Search Texas wells by API, operator, county name or code, status, bbox, or nearby point. For monthly production across an operator’s wells in a county, first find their APIs here, then use their APIs to request exact-identity lease production for the required months.
Entitieswell
Paginationoffset (offsetField: offset, limitField: limit)
Unitswells[].latitude: decimal degrees · wells[].longitude: decimal degrees
CRSOGC:CRS84
FreshnessScheduled
searchWellsByArea
read
Area wrapper. Pass bbox or latitude/longitude/radius_meters or near object.
Entitieswell
FreshnessScheduled (source-level)
An area is required; use searchWells for county/operator-only searches.
countWells
read
Count Texas RRC wells grouped by county, operator, well_type, or well_status; exact totals.
Required paramsgroupBy
Entitieswell
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled
getWellDetail
read
Fetch a single well by API number.
Required paramsapi or apiNumber or api_number
Entitieswell
Paginationnone
Unitslatitude: decimal degrees · longitude: decimal degrees
CRSOGC:CRS84
FreshnessScheduled
getWellDossier
read
⭐ ONE-CALL TX well dossier: detail+wellbore+location+permits+12mo exact-identity lease production.
Required paramsapi or api_county and api_unique or leaseNumber and county
Entitieswell
FreshnessScheduled (source-level)
Pass api, api_county+api_unique, OR leaseNumber+county. Check _sections_failed.
getWellProduction
read
Return monthly production for every exact RRC lease identity associated with a well API.
Required paramsapi or apiNumber or api_number
Entitiesproduction, well
FreshnessScheduled (source-level)
Filed months only; hint lists not-yet-filed months (not zero output).
getLeaseOperator
read
Return the current P-4 operator, production history, and registry mismatch for a lease.
Required paramsleaseNumber or api
Entitieslease, operator
FreshnessScheduled (source-level)
searchPipelineSegments
read
Search by operator, system, county, commodity, exact diameter, or area; optionally return geometry.
Required paramsname or operator or system_name or t4_permit or county or county_code or commodity or status or pipeline_number or diameter_inches or property_filter or bbox or near
Entitiespipeline
FreshnessScheduled (source-level)
getPipelineGeoJSON
read
Return pipeline segments as GeoJSON for map line rendering. Use this with patchops_addMapLayer({ geojson }).
Required paramssegment_ids or pipeline_numbers or bbox
Entitiespipeline
FreshnessScheduled (source-level)
listPipelines
read
List available pipeline numbers with segment counts. Supports pagination.
Entitiespipeline
FreshnessScheduled (source-level)
getPipelinesNearLocation
read
Find pipeline segments near a point. Discovery only — follow with getPipelineGeoJSON for lines.
Required paramslatitudelongitude
Entitiespipeline
FreshnessScheduled (source-level)
getDataStatus
read
Report freshness and row counts for managed RRC datasets, including withheld unverified feeds.
Entitiesrecord
FreshnessScheduled (source-level)
searchProductionByArea
read
Search lease-level production by area, operator, or date.
Entitiesproduction
FreshnessScheduled (source-level)
Default month: newest with filed reports (production_month). Unfiled: null.
getProductionGeoJSON
read
Return lease production as GeoJSON for map rendering (point centroids or polygons).
Entitiesproduction
FreshnessScheduled (source-level)
Default month: newest with filed reports (metadata.production_month).
searchGasProcessingPlants
read
Search R3 gas processing plant filings by facility name, county, district, location, or operator name (searches facility_name). Note: R3 data has no operator column — pass operator/operatorName to search by facility name. Use latitude/longitude/radius_meters for spatial search.
Entitiesfacility
FreshnessScheduled (source-level)
searchInspections
read
Search Oil/ICE inspection records by API, operator, county name, compliance, or date range.
Entitiesinspection
FreshnessScheduled (source-level)
searchViolations
read
Search Oil/ICE violations by API, operator, rule, or date range.
Entitiesviolation
FreshnessScheduled (source-level)
searchDockets
read
Search live RRC CASES Oil & Gas docket case-headers by district, status, rule, year, or case number.
Entitiesrecord
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled (source-level)
getDocket
read
Fetch a single RRC CASES docket case-header by 8-digit case number.
Required paramscaseNumber or case_number
Entitiesrecord
FreshnessScheduled (source-level)
searchOrganizations
read
Search RRC P-5 operators.
Required paramsorganization_name or name or organizationName or operator_number or operatorNumber or p5_status or p5Status or city or state
Entitiescompany, operator
FreshnessScheduled (source-level)
getOrganizationFinancialAssurance
read
Get public P-5 financial-assurance detail for one operator.
Required paramsoperator_number
Entitiesoperator, financial-assurance
Paginationnone
FreshnessScheduled · every P1D
- ⚠ Operator-level regulatory assurance is not a business credit score.
Operator-level assurance is not a business credit score.
searchFieldNames
read
Search oil & gas field names and numbers by name, district, county code, or classification.
Entitiesfield
FreshnessScheduled (source-level)
searchWellboreData
read
Search wellbore query data by API, district, county, operator, field, or well type.
Entitieswell
FreshnessScheduled (source-level)
searchHorizontalPermits
read
Search horizontal drilling permits by permit, operator, county, district, field, date.
Entitiespermit, well
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled · every P1M
Newest first. Read dataset_freshness.coverage before trusting an empty page.
searchGasAnnualReports
read
Search gas annual report field tables by year, district, field name, or county.
Entitiesdocument
FreshnessScheduled (source-level)
searchOilAnnualReports
read
Search oil annual report field tables by year, district, field name, or county.
Entitiesdocument
FreshnessScheduled (source-level)
searchProductionReports
read
Search pending production reports by API, operator, cycle year/month.
Entitiesdocument, production
FreshnessScheduled (source-level)
searchPendingLeases
read
Search pending lease identifiers by API number, operator, or lease name.
Entitieslease
FreshnessScheduled (source-level)
searchP18SkimOil
read
Search P-18 skim oil/condensate reports by serial number, operator, district, or county.
Entitiesrecord
FreshnessScheduled (source-level)
searchDrillingPermits
read
Search RRC drilling applications and permits by operator, location, API, or filed/issued date.
Entitiespermit, well
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled · every P1D
getRigActivity
read
Infer active TX drilling-rig activity from RRC filings: synthetic rig tracks (chained confirmed spud/surface-casing events per operator, with coordinates), 8-week permit flow, a statewide flow-balance rig estimate, and expected next drilling locations. Tracks are anonymous lower bounds — Texas publishes no rig names.
Entitiesrig
FreshnessScheduled (source-level)
A LOWER bound; TX publishes no rig names. Rows carry surface lat/long.
searchGisWellLocations
read
Search well coordinates by API, county, type, status, operator, or radius; requires one filter.
Required paramsapi or county or county_code or well_type or status or operator or latitude and longitude
Entitieswell
FreshnessScheduled (source-level)
At least one filter is required — an unfiltered call throws.
searchGisSurveys
read
Search TX Original Land Survey polygons by abstract, name, block, or point-in-poly.
Entitiessurvey
FreshnessScheduled (source-level)
searchGisHorizontalPaths
read
Search RRC GIS horizontal/directional well path polylines near a location.
Required paramsbbox or latitude and longitude
Entitiesformation
FreshnessScheduled (source-level)
searchGisPipelines
read
Search RRC GIS T-4 pipeline geometry.
Required paramsbbox or latitude and longitude or name or system_name or t4_permit or operator or operator_name or operatorName
Entitiespipeline
FreshnessScheduled (source-level)
searchGisInjectionWells
read
Search RRC GIS injection/disposal wells (UIC) near a location.
Required paramsbbox or latitude and longitude
Entitieswell
FreshnessScheduled (source-level)
getInjectionWellsGeoJSON
read
All TX RRC Class II injection/disposal (UIC) wells statewide as GeoJSON (keyset-paginated).
Entitieswell
FreshnessScheduled (source-level)
Use with patchops_addMapLayer for a full-state injection-well map.
searchGasLedger
read
Search the RRC gas ledger by district, field, lease, county, or operator identifiers.
Entitiesrecord
FreshnessScheduled (source-level)
searchOilLedger
read
Search the RRC oil ledger root records by district or field.
Entitiesrecord
FreshnessScheduled (source-level)
searchHistoricalLedger
read
Search historical RRC lease-ledger records by district, lease number, or field.
Entitiesrecord
FreshnessScheduled (source-level)
searchStatewideField
read
Search statewide RRC field records by district, field number, or field name.
Entitiesfield
FreshnessScheduled (source-level)
searchProductionData
read
Search RRC production root records by oil/gas system, district, or lease.
Entitiesproduction
FreshnessScheduled (source-level)
searchGasDisposition
read
Search RRC gas disposition records by district, lease, cycle, or disposition code.
Entitieslease
FreshnessScheduled (source-level)
searchFullWellbore
read
Search raw RRC full-wellbore records by record type or text.
Entitieswell
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled (source-level)
Fails with "not loaded" while the dataset has no rows.
searchOilWellStatus
read
Search raw RRC oil-well status records by record type or text.
Entitieswell
FreshnessScheduled (source-level)
searchGasWellStatus
read
Search raw RRC gas-well status records by record type or text.
Entitieswell
FreshnessScheduled (source-level)
searchUIC
read
Search raw RRC underground-injection-control records by record type or text.
Entitiesrecord
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled (source-level)
searchCompletionData
read
Search verified RRC W-2/G-1 completion packets by API number, record type, or text.
Entitiescompletion
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled (source-level)
searchHighCostGas
read
Search verified RRC high-cost gas (NGF019) records by record type or text.
Entitiesrecord
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled (source-level)
searchST1Applications
read
Search verified RRC ST-1 application records by record type or text.
Entitiesrecord
Paginationoffset (offsetField: offset, limitField: limit)
FreshnessScheduled (source-level)

Texas RRC Data

Questions you can ask

About this source

Provenance

Freshness & coverage

Caveats

› Methods (50)

searchWells

searchWellsByArea

countWells

getWellDetail

getWellDossier

getWellProduction

getLeaseOperator

searchPipelineSegments

getPipelineGeoJSON

listPipelines

getPipelinesNearLocation

getDataStatus

searchProductionByArea

getProductionGeoJSON

searchGasProcessingPlants

searchInspections

searchViolations

searchDockets

getDocket

searchOrganizations

getOrganizationFinancialAssurance

searchFieldNames

searchWellboreData

searchHorizontalPermits

searchGasAnnualReports

searchOilAnnualReports

searchProductionReports

searchPendingLeases

searchP18SkimOil

searchDrillingPermits

getRigActivity

searchGisWellLocations

searchGisSurveys

searchGisHorizontalPaths

searchGisPipelines

searchGisInjectionWells

getInjectionWellsGeoJSON

searchGasLedger

searchOilLedger

searchHistoricalLedger

searchStatewideField

searchProductionData

searchGasDisposition

searchFullWellbore

searchOilWellStatus

searchGasWellStatus

searchUIC

searchCompletionData

searchHighCostGas

searchST1Applications