Provenance
Freshness & coverage
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 (48)
searchWells
readSearch Texas wells by API, operator, county name or code, status, bbox, or nearby point.
EntitieswellPaginationoffset (offsetField: offset, limitField: limit)Unitswells[].latitude: decimal degrees · wells[].longitude: decimal degreesCRSOGC:CRS84FreshnessScheduledInput schema
{ "type": "object", "properties": { "api": { "type": "string", "description": "API number (e.g. \"42383...\")." }, "operator": { "type": "string", "description": "Operator name (partial ILIKE match)." }, "county_code": { "type": "string", "description": "RRC county code (e.g. \"329\" for Midland). Use county name instead if you do not know the code." }, "county": { "type": "string", "description": "County name (e.g. \"MIDLAND\", \"ECTOR\"). Resolved to county_code automatically." }, "well_type": { "type": "string", "description": "Well type filter (e.g. \"O\" for oil, \"G\" for gas)." }, "well_status": { "type": "string", "description": "Well status filter (e.g. \"ACTIVE\", \"PLUGGED\")." }, "bbox": { "type": "array", "items": { "type": "number" }, "description": "Bounding box [xmin, ymin, xmax, ymax] in WGS84." }, "near": { "type": "object", "properties": { "lon": { "type": "number" }, "lat": { "type": "number" }, "radius_meters": { "type": "number" } }, "required": [ "lon", "lat", "radius_meters" ], "additionalProperties": false, "description": "Alternative nearby point object: { lon, lat, radius_meters }." }, "latitude": { "type": "number", "description": "Latitude for proximity search (use with longitude and radius_meters)." }, "longitude": { "type": "number", "description": "Longitude for proximity search (use with latitude and radius_meters)." }, "radius_meters": { "type": "number", "description": "Search radius in meters (default 16093 = ~10 miles). Use with latitude/longitude." }, "limit": { "type": "number", "description": "Maximum records (default 100, max 80000)." }, "offset": { "type": "number", "description": "Pagination offset (default 0)." }, "includeTotal": { "type": "boolean" } }, "additionalProperties": true }Output schema
{ "type": "object", "properties": { "wells": { "type": "array", "items": { "type": "object", "properties": { "api_number": { "type": "string" }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "county_code": { "type": [ "string", "null" ] }, "well_type": { "type": [ "string", "null" ] }, "well_status": { "type": [ "string", "null" ] }, "operator_name": { "type": [ "string", "null" ] }, "lease_name": { "type": [ "string", "null" ] }, "well_number": { "type": [ "string", "null" ] }, "field_name": { "type": [ "string", "null" ] }, "completion_date": { "type": [ "string", "null" ] }, "plug_date": { "type": [ "string", "null" ] }, "source_snapshot": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] } }, "required": [ "api_number" ], "additionalProperties": true } }, "total": { "type": [ "integer", "null" ] }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "hint": { "type": "string" } }, "required": [ "wells", "total", "hasMore", "limit", "offset" ], "additionalProperties": true }searchWellsByArea
readArea wrapper. Pass bbox or latitude/longitude/radius_meters or near object.
EntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api": { "type": "string" }, "operator": { "type": "string" }, "county_code": { "type": "string" }, "county": { "type": "string" }, "well_type": { "type": "string" }, "well_status": { "type": "string" }, "bbox": { "type": "array", "items": { "type": "number" } }, "near": { "type": "object", "properties": { "lon": { "type": "number" }, "lat": { "type": "number" }, "radius_meters": { "type": "number" } }, "required": [ "lon", "lat", "radius_meters" ], "additionalProperties": false }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius_meters": { "type": "number" }, "limit": { "type": "number" }, "offset": { "type": "number" }, "includeTotal": { "type": "boolean" } }, "additionalProperties": false }countWells
readCount Texas RRC oil and gas wells, grouped by county, operator, well type, or status. County groups include both county_name and county_code. Use for exact aggregate requests instead of fetching raw rows.
Required paramsgroupByEntitieswellPaginationoffset (offsetField: offset, limitField: limit)FreshnessScheduledInput schema
{ "type": "object", "properties": { "groupBy": { "type": "array", "items": { "enum": [ "county", "operator", "well_type", "well_status" ] }, "minItems": 1, "maxItems": 4 }, "operator": { "type": "string" }, "county": { "type": "string" }, "county_code": { "type": "string" }, "well_type": { "type": "string" }, "well_status": { "type": "string" }, "limit": { "type": "integer", "minimum": 1, "maximum": 1000 }, "offset": { "type": "integer", "minimum": 0 } }, "additionalProperties": false, "required": [ "groupBy" ] }Output schema
{ "type": "object", "properties": { "groupBy": { "type": "array", "items": { "type": "string" } }, "groups": { "type": "array", "items": { "type": "object", "properties": { "county_code": { "type": [ "string", "null" ] }, "county_name": { "type": [ "string", "null" ] }, "operator_name": { "type": [ "string", "null" ] }, "well_type": { "type": [ "string", "null" ] }, "well_status": { "type": [ "string", "null" ] }, "well_count": { "type": "integer" } }, "required": [ "well_count" ], "additionalProperties": false } }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "groupBy", "groups", "hasMore", "limit", "offset" ], "additionalProperties": false }getWellDetail
readFetch a single well by API number.
Required paramsapi or apiNumber or api_numberEntitieswellPaginationnoneUnitslatitude: decimal degrees · longitude: decimal degreesCRSOGC:CRS84FreshnessScheduledInput schema
{ "type": "object", "properties": { "api": { "type": "string", "description": "API number." }, "apiNumber": { "type": "string", "description": "camelCase alias for api." }, "api_number": { "type": "string", "description": "snake_case alias for api." } }, "additionalProperties": true, "allOf": [ { "anyOf": [ { "required": [ "api" ] }, { "required": [ "apiNumber" ] }, { "required": [ "api_number" ] } ] } ] }Output schema
{ "type": "object", "properties": { "api_number": { "type": "string" }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "county_code": { "type": [ "string", "null" ] }, "well_type": { "type": [ "string", "null" ] }, "well_status": { "type": [ "string", "null" ] }, "operator_name": { "type": [ "string", "null" ] }, "lease_name": { "type": [ "string", "null" ] }, "well_number": { "type": [ "string", "null" ] }, "field_name": { "type": [ "string", "null" ] }, "completion_date": { "type": [ "string", "null" ] }, "plug_date": { "type": [ "string", "null" ] }, "source_snapshot": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "found": { "type": "boolean" }, "api_searched": { "type": "string" }, "hint": { "type": "string" } }, "additionalProperties": true }getWellDossier
read⭐ ONE-CALL TX well dossier: detail+wellbore+location+permits+12mo exact-identity lease production.
Required paramsapi or leaseNumber and countyEntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api": { "type": "string", "examples": [ "42-329-30465" ] }, "apiNumber": { "type": "string" }, "api_number": { "type": "string" }, "leaseNumber": { "type": "string" }, "lease_number": { "type": "string" }, "county": { "type": "string" } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "api" ] }, { "required": [ "leaseNumber", "county" ] } ] } ] }Pass api OR leaseNumber+county. Sections degrade solo — check _sections_failed.
getWellProduction
readReturn monthly production for every exact RRC lease identity associated with a well API.
Required paramsapi or apiNumber or api_numberEntitiesproduction, wellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api": { "type": "string" }, "apiNumber": { "type": "string" }, "api_number": { "type": "string" } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "api" ] }, { "required": [ "apiNumber" ] }, { "required": [ "api_number" ] } ] } ] }getLeaseOperator
readReturn the current P-4 operator, production history, and registry mismatch for a lease.
Entitieslease, operatorFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "leaseNumber": { "type": "string" }, "lease_number": { "type": "string" }, "district": { "type": "string" }, "oil_gas_code": { "type": "string" }, "oilGasCode": { "type": "string" }, "api": { "type": "string" } }, "additionalProperties": false }searchPipelineSegments
readSearch 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 nearEntitiespipelineFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "name": { "type": "string", "description": "Operator, system, subsystem, or line name." }, "operator": { "type": "string" }, "system_name": { "type": "string" }, "t4_permit": { "type": "string" }, "county": { "type": "string" }, "county_code": { "type": "string" }, "commodity": { "type": "string" }, "status": { "type": "string" }, "pipeline_number": { "type": "string" }, "diameter_inches": { "type": "number", "exclusiveMinimum": 0, "description": "Exact nominal pipeline diameter in inches, such as 36." }, "property_filter": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Advanced exact JSONB containment filter for documented raw RRC properties." }, "bbox": { "type": "array", "items": { "type": "number" }, "minItems": 4, "maxItems": 4, "description": "Bounding box [minLongitude, minLatitude, maxLongitude, maxLatitude]." }, "near": { "type": "object", "properties": { "lon": { "type": "number" }, "lat": { "type": "number" }, "radius_meters": { "type": "number", "exclusiveMinimum": 0 } }, "additionalProperties": false, "required": [ "lon", "lat", "radius_meters" ] }, "include_geometry": { "type": "boolean" }, "include_total": { "type": "boolean" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "offset": { "type": "integer", "minimum": 0 } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "name" ] }, { "required": [ "operator" ] }, { "required": [ "system_name" ] }, { "required": [ "t4_permit" ] }, { "required": [ "county" ] }, { "required": [ "county_code" ] }, { "required": [ "commodity" ] }, { "required": [ "status" ] }, { "required": [ "pipeline_number" ] }, { "required": [ "diameter_inches" ] }, { "required": [ "property_filter" ] }, { "required": [ "bbox" ] }, { "required": [ "near" ] } ] } ] }getPipelineGeoJSON
readReturn pipeline segments as GeoJSON for map line rendering. Use this with patchops_addMapLayer({ geojson }).
Required paramssegment_ids or pipeline_numbers or bboxEntitiespipelineFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "segment_ids": { "type": "array", "items": { "type": "number" }, "description": "Optional list of pipeline segment row IDs to include." }, "pipeline_numbers": { "type": "array", "items": { "type": "string" }, "description": "Optional list of pipeline numbers to include." }, "bbox": { "type": "array", "items": { "type": "number" }, "description": "Bounding box [xmin, ymin, xmax, ymax]." }, "limit": { "type": "number", "description": "Maximum features (default 1000, max 5000)." }, "simplify_tolerance": { "type": "number", "description": "Optional geometry simplification tolerance." } }, "additionalProperties": true, "allOf": [ { "anyOf": [ { "required": [ "segment_ids" ] }, { "required": [ "pipeline_numbers" ] }, { "required": [ "bbox" ] } ] } ] }listPipelines
readList available pipeline numbers with segment counts. Supports pagination.
EntitiespipelineFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "limit": { "type": "number", "description": "Maximum pipelines to return (default 50, max 500)." }, "offset": { "type": "number", "description": "Pagination offset (default 0)." } }, "additionalProperties": true }getPipelinesNearLocation
readFind pipeline segments near a point. Discovery only — follow with getPipelineGeoJSON for lines.
Required paramslatitudelongitudeEntitiespipelineFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "latitude": { "type": "number", "examples": [ 31.9 ] }, "longitude": { "type": "number", "examples": [ -102.1 ] }, "radius_meters": { "type": "number", "examples": [ 5000 ] }, "limit": { "type": "number" } }, "additionalProperties": false, "required": [ "latitude", "longitude" ] }getDataStatus
readReport freshness and row counts for managed RRC datasets, including withheld unverified feeds.
EntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": {}, "additionalProperties": false }searchProductionByArea
readSearch lease-level production by area, operator, or date.
EntitiesproductionFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "production_month": { "type": "string", "description": "Production month (YYYY-MM-DD)." }, "cycle_year": { "type": "number", "description": "Production cycle year." }, "cycle_month": { "type": "number", "description": "Production cycle month (1-12)." }, "operator": { "type": "string", "description": "Operator name (partial ILIKE match)." }, "bbox": { "type": "array", "items": { "type": "number" }, "description": "Bounding box [xmin, ymin, xmax, ymax]." }, "near": { "type": "object", "properties": { "lon": { "type": "number" }, "lat": { "type": "number" }, "radius_meters": { "type": "number" } }, "required": [ "lon", "lat", "radius_meters" ], "additionalProperties": false, "description": "Nearby point filter." }, "limit": { "type": "number", "description": "Maximum records (default 1000, max 5000)." }, "offset": { "type": "number" }, "geometry_type": { "oneOf": [ { "type": "string", "enum": [ "point" ] }, { "type": "string", "enum": [ "polygon" ] } ] } }, "additionalProperties": true }getProductionGeoJSON
readReturn lease production as GeoJSON for map rendering (point centroids or polygons).
EntitiesproductionFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "production_month": { "type": "string" }, "cycle_year": { "type": "number" }, "cycle_month": { "type": "number" }, "operator": { "type": "string", "examples": [ "Mitsui" ] }, "bbox": { "type": "array", "items": { "type": "number" } }, "near": { "type": "object", "properties": { "lon": { "type": "number" }, "lat": { "type": "number" }, "radius_meters": { "type": "number" } }, "required": [ "lon", "lat", "radius_meters" ], "additionalProperties": false }, "limit": { "type": "number" }, "offset": { "type": "number" }, "geometry_type": { "oneOf": [ { "type": "string", "enum": [ "point" ] }, { "type": "string", "enum": [ "polygon" ] } ] } }, "additionalProperties": false }searchGasProcessingPlants
readSearch 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.
EntitiesfacilityFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "serial_number": { "type": "string", "description": "Plant serial number (e.g. \"08-3627\")." }, "facility_name": { "type": "string", "description": "Facility name (partial ILIKE match)." }, "county": { "type": "string", "description": "County name (e.g. \"ECTOR\")." }, "district": { "type": "string", "description": "RRC district." }, "reporting_year": { "type": "string", "description": "Reporting year (e.g. \"2026\")." }, "reporting_month": { "type": "string", "description": "Reporting month name (e.g. \"January\")." }, "bbox": { "type": "object", "properties": { "west": { "type": "number" }, "south": { "type": "number" }, "east": { "type": "number" }, "north": { "type": "number" } }, "required": [ "west", "south", "east", "north" ], "additionalProperties": false }, "near": { "type": "object", "properties": { "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius_meters": { "type": "number" } }, "required": [ "latitude", "longitude" ], "additionalProperties": false, "description": "Alternative nearby point: { latitude, longitude, radius_meters }." }, "latitude": { "type": "number", "description": "Latitude for proximity search." }, "longitude": { "type": "number", "description": "Longitude for proximity search." }, "radius_meters": { "type": "number", "description": "Search radius in meters (default 16093 = ~10 miles)." }, "limit": { "type": "number", "description": "Maximum records (default 50, max 200)." }, "offset": { "type": "number", "description": "Pagination offset (default 0)." }, "operator": { "type": "string", "description": "Alias for facility_name search — R3 data has no operator column, but many plant names contain the operator." } }, "additionalProperties": true }searchInspections
readSearch Oil/ICE inspection records by API, operator, county name, compliance, or date range.
EntitiesinspectionFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api_no": { "type": "string", "description": "API number." }, "operator_name": { "type": "string", "description": "Operator name (partial ILIKE match)." }, "p5_operator_no": { "type": "string", "description": "P5 operator number." }, "county": { "type": "string", "description": "County name (e.g. \"MIDLAND\")." }, "district": { "type": "string", "description": "RRC district (e.g. \"08\", \"7C\")." }, "compliance": { "type": "string", "description": "Compliance status (\"Yes\" or \"No\")." }, "date_from": { "type": "string", "description": "Start date (YYYY-MM-DD)." }, "date_to": { "type": "string", "description": "End date (YYYY-MM-DD)." }, "limit": { "type": "number", "description": "Maximum records (default 50, max 500)." }, "offset": { "type": "number", "description": "Pagination offset (default 0)." } }, "additionalProperties": true }searchViolations
readSearch Oil/ICE violations by API, operator, rule, or date range.
EntitiesviolationFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api_no": { "type": "string" }, "operator_name": { "type": "string", "description": "Operator name." }, "p5_operator_no": { "type": "string" }, "county": { "type": "string" }, "district": { "type": "string" }, "violated_rule": { "type": "string", "description": "Rule text or code." }, "major_only": { "type": "boolean", "description": "Only major violations." }, "date_from": { "type": "string" }, "date_to": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" }, "api": { "type": "string", "description": "API number." } }, "additionalProperties": true }searchDockets
readSearch live RRC CASES Oil & Gas docket case-headers by district, status, rule, year, or case number.
EntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "caseNumber": { "type": "string" }, "district": { "type": "string", "examples": [ "08" ] }, "status": { "type": "string", "examples": [ "Active" ] }, "ruleNumber": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "filingYear": { "type": "number", "examples": [ 2025 ] }, "docketGroup": { "type": "string" }, "businessArea": { "type": "string" }, "includeTotal": { "type": "boolean" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }getDocket
readFetch a single RRC CASES docket case-header by 8-digit case number.
Required paramscaseNumber or case_numberEntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "caseNumber": { "type": "string", "examples": [ "00028247" ] }, "case_number": { "type": "string" } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "caseNumber" ] }, { "required": [ "case_number" ] } ] } ] }searchOrganizations
readSearch RRC P-5 operators.
Required paramsorganization_name or name or organizationName or operator_number or operatorNumber or p5_status or p5Status or city or stateEntitiescompany, operatorFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "organization_name": { "type": "string", "examples": [ "Pioneer" ], "description": "Organization or operator name (partial match)." }, "name": { "type": "string", "description": "Alias for organization_name." }, "organizationName": { "type": "string", "description": "Alias for organization_name." }, "operator_number": { "type": "string", "description": "Six-digit P-5 operator number." }, "operatorNumber": { "type": "string", "description": "Alias for operator_number." }, "p5_status": { "type": "string", "description": "P-5 status code." }, "p5Status": { "type": "string", "description": "Alias for p5_status." }, "city": { "type": "string" }, "state": { "type": "string" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "offset": { "type": "integer", "minimum": 0 }, "includeTotal": { "type": "boolean" } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "organization_name" ] }, { "required": [ "name" ] }, { "required": [ "organizationName" ] }, { "required": [ "operator_number" ] }, { "required": [ "operatorNumber" ] }, { "required": [ "p5_status" ] }, { "required": [ "p5Status" ] }, { "required": [ "city" ] }, { "required": [ "state" ] } ] } ] }getOrganizationFinancialAssurance
readGet public P-5 financial-assurance detail for one operator.
Required paramsoperator_numberEntitiesoperator, financial-assurancePaginationnoneFreshnessScheduled · every P1DInput schema
{ "type": "object", "properties": { "operator_number": { "type": "string", "pattern": "^\\d{6}$", "description": "Six-digit Texas RRC operator number." } }, "additionalProperties": false, "required": [ "operator_number" ] }Output schema
{ "type": "object", "properties": { "found": { "type": "boolean" }, "operatorNumber": { "type": "string" }, "operatorName": { "type": [ "string", "null" ] }, "organizationStatus": { "type": [ "string", "null" ] }, "organizationType": { "type": [ "string", "null" ] }, "expirationDate": { "type": [ "string", "null" ] }, "option": { "type": [ "string", "null" ] }, "amount": { "type": [ "string", "null" ] }, "amountUsd": { "type": [ "number", "null" ] }, "type": { "type": [ "string", "null" ] }, "source": { "type": "string" }, "sourceUpdated": { "type": "string" }, "caveats": { "type": "array", "items": { "type": "string" } } }, "required": [ "found", "operatorNumber", "operatorName", "organizationStatus", "organizationType", "expirationDate", "option", "amount", "amountUsd", "type", "source", "sourceUpdated", "caveats" ], "additionalProperties": true }- ⚠ Operator-level regulatory assurance is not a business credit score.
Operator-level assurance is not a business credit score.
searchFieldNames
readSearch oil & gas field names and numbers by name, district, county code, or classification.
EntitiesfieldFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "field_name": { "type": "string", "examples": [ "SPRABERRY" ] }, "field_district": { "type": "string" }, "county_code": { "type": "string" }, "classification": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchWellboreData
readSearch wellbore query data by API, district, county, operator, field, or well type.
EntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api_no": { "type": "string" }, "district": { "type": "string" }, "county_code": { "type": "string", "examples": [ "317" ] }, "operator_name": { "type": "string", "examples": [ "Mitsui" ] }, "operator_number": { "type": "string" }, "oil_gas_code": { "type": "string" }, "field_name": { "type": "string" }, "lease_name": { "type": "string" }, "lease_number": { "type": "string" }, "well_type_name": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchHorizontalPermits
readSearch horizontal drilling permits by permit, operator, county, district, field, date.
Entitiespermit, formationFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "permit_number": { "type": "string" }, "operator_name": { "type": "string" }, "operator_number": { "type": "string" }, "county_name": { "type": "string", "examples": [ "Reeves" ] }, "permit_district": { "type": "string" }, "field_name": { "type": "string" }, "api_county": { "type": "string" }, "api_unique": { "type": "string" }, "date_from": { "type": "string", "examples": [ "2024-01-01" ] }, "date_to": { "type": "string" }, "oil_or_gas": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchGasAnnualReports
readSearch gas annual report field tables by year, district, field name, or county.
EntitiesdocumentFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "year": { "type": "string" }, "district": { "type": "string" }, "field_name": { "type": "string" }, "county_name": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchOilAnnualReports
readSearch oil annual report field tables by year, district, field name, or county.
EntitiesdocumentFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "year": { "type": "string" }, "district": { "type": "string" }, "field_name": { "type": "string" }, "county_name": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchProductionReports
readSearch pending production reports by API, operator, cycle year/month.
Entitiesdocument, productionFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api_no": { "type": "string" }, "operator_no": { "type": "string" }, "cycle_year": { "type": "string" }, "cycle_month": { "type": "string" }, "workflow_state_code": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchPendingLeases
readSearch pending lease identifiers by API number, operator, or lease name.
EntitiesleaseFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api_no": { "type": "string" }, "operator_no": { "type": "string" }, "lease_name": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchP18SkimOil
readSearch P-18 skim oil/condensate reports by serial number, operator, district, or county.
EntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "serial_number": { "type": "string" }, "operator_name": { "type": "string" }, "district": { "type": "string" }, "county": { "type": "string" }, "reporting_year": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchDrillingPermits
readSearch current RRC drilling applications and permits by operator, district, county, API, or date.
Entitiespermit, wellPaginationoffset (offsetField: offset, limitField: limit)FreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "snapshot_scope": { "oneOf": [ { "type": "string", "enum": [ "daily" ] }, { "type": "string", "enum": [ "month_end" ] } ], "type": "string", "enum": [ "daily", "month_end" ], "default": "daily" }, "status_number": { "type": "string" }, "operator_name": { "type": "string" }, "operator_number": { "type": "string" }, "district": { "type": "string" }, "county_code": { "type": "string" }, "county": { "type": "string", "examples": [ "Martin" ] }, "api_county": { "type": "string" }, "api_unique": { "type": "string" }, "application_type": { "type": "string" }, "original_only": { "type": "boolean" }, "new_drill_only": { "type": "boolean", "examples": [ true ] }, "approved_only": { "type": "boolean", "examples": [ true ] }, "horizontal_only": { "type": "boolean", "examples": [ true ] }, "date_from": { "type": "string" }, "date_to": { "type": "string" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50 }, "offset": { "type": "integer", "minimum": 0, "default": 0 } }, "additionalProperties": false }getRigActivity
readInfer 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.
EntitiesrigFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "district": { "type": "string", "examples": [ "08" ], "description": "Public RRC district (e.g. \"08\", \"7C\", \"8A\")." }, "county": { "type": "string", "description": "County name (best effort — many CASES rows lack county; prefer district)." }, "operator_name": { "type": "string", "description": "Operator name (partial ILIKE match)." }, "window_days": { "type": "number", "description": "Confirmed-event lookback in days (default 90, max 365)." }, "active_within_days": { "type": "number", "description": "A track is active when its last event is within this many days (default 21)." }, "include_expected": { "type": "boolean", "description": "Include fresh not-yet-spudded applications (default true)." }, "limit": { "type": "number", "description": "Max rig tracks returned (default 100, max 500)." } }, "additionalProperties": true }A LOWER bound; TX publishes no rig names. Rows carry surface lat/long.
searchGisWellLocations
readSearch well coordinates by API, county, type, status, operator, or radius; requires one filter.
EntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "api": { "type": "string" }, "county_code": { "type": "string" }, "county": { "type": "string", "examples": [ "Midland" ] }, "status": { "type": "string" }, "well_type": { "type": "string" }, "type": { "type": "string" }, "well_status": { "type": "string" }, "operator": { "type": "string" }, "operator_name": { "type": "string" }, "operatorName": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius_meters": { "type": "number" }, "limit": { "type": "number", "examples": [ 100 ] } }, "additionalProperties": false }At least one filter is required — an unfiltered call throws.
searchGisSurveys
readSearch TX Original Land Survey polygons by abstract, name, block, or point-in-poly.
EntitiessurveyFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "abstract_number": { "type": "string" }, "survey_name": { "type": "string", "examples": [ "T&P RR CO" ] }, "block": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius_meters": { "type": "number" }, "bbox": { "type": "array", "items": { "type": "number" } }, "limit": { "type": "number" } }, "additionalProperties": false }searchGisHorizontalPaths
readSearch RRC GIS horizontal/directional well path polylines near a location.
Required paramsbbox or latitude and longitudeEntitiesformationFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius_meters": { "type": "number" }, "bbox": { "type": "array", "items": { "type": "number" } }, "limit": { "type": "number" } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "bbox" ] }, { "required": [ "latitude", "longitude" ] } ] } ] }searchGisPipelines
readSearch 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 operatorNameEntitiespipelineFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "name": { "type": "string", "description": "Free-text pipeline name across operator and system name." }, "system_name": { "type": "string", "description": "Registered pipeline system name (partial match)." }, "t4_permit": { "type": "string", "description": "RRC T-4 permit number." }, "operator": { "type": "string", "description": "Operator-of-record name (partial match)." }, "operator_name": { "type": "string", "description": "Alias for operator." }, "operatorName": { "type": "string", "description": "Alias for operator." }, "bbox": { "type": "array", "items": { "type": "number" }, "minItems": 4, "maxItems": 4 }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius_meters": { "type": "number", "minimum": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 1000 }, "merge_systems": { "type": "boolean" }, "follow_systems": { "type": "boolean" } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "bbox" ] }, { "required": [ "latitude", "longitude" ] }, { "required": [ "name" ] }, { "required": [ "system_name" ] }, { "required": [ "t4_permit" ] }, { "required": [ "operator" ] }, { "required": [ "operator_name" ] }, { "required": [ "operatorName" ] } ] } ] }searchGisInjectionWells
readSearch RRC GIS injection/disposal wells (UIC) near a location.
Required paramsbbox or latitude and longitudeEntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "latitude": { "type": "number" }, "longitude": { "type": "number" }, "radius_meters": { "type": "number" }, "bbox": { "type": "array", "items": { "type": "number" } }, "limit": { "type": "number" } }, "additionalProperties": false, "allOf": [ { "anyOf": [ { "required": [ "bbox" ] }, { "required": [ "latitude", "longitude" ] } ] } ] }getInjectionWellsGeoJSON
readAll TX RRC Class II injection/disposal (UIC) wells statewide as GeoJSON (keyset-paginated).
EntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "bbox": { "type": "array", "items": { "type": "number" } }, "limit": { "type": "number" } }, "additionalProperties": false }Use with patchops_addMapLayer for a full-state injection-well map.
searchGasLedger
readSearch the RRC gas ledger by district, field, lease, county, or operator identifiers.
EntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "district": { "type": "string" }, "field_name": { "type": "string" }, "county": { "type": "string" }, "class_code": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchOilLedger
readSearch the RRC oil ledger root records by district or field.
EntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "district": { "type": "string" }, "field_name": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchHistoricalLedger
readSearch historical RRC lease-ledger records by district, lease number, or field.
EntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "district": { "type": "string" }, "lease_nbr": { "type": "string" }, "og_code": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchStatewideField
readSearch statewide RRC field records by district, field number, or field name.
EntitiesfieldFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "fl_district": { "type": "string" }, "fl_number": { "type": "string" }, "fl_name": { "type": "string" }, "fl_field_class": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchProductionData
readSearch RRC production root records by oil/gas system, district, or lease.
EntitiesproductionFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "oil_or_gas": { "oneOf": [ { "type": "string", "enum": [ "oil" ] }, { "type": "string", "enum": [ "gas" ] } ] }, "district": { "type": "string" }, "lease": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchGasDisposition
readSearch RRC gas disposition records by district, lease, cycle, or disposition code.
EntitiesleaseFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "district": { "type": "string" }, "lease_no": { "type": "string" }, "field_name": { "type": "string" }, "system_type": { "oneOf": [ { "type": "string", "enum": [ "oil_system" ] }, { "type": "string", "enum": [ "gas_system" ] } ] }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchFullWellbore
readSearch raw RRC full-wellbore records by record type or text.
EntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "record_type": { "type": "string" }, "search_text": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchOilWellStatus
readSearch raw RRC oil-well status records by record type or text.
EntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "record_type": { "type": "string" }, "search_text": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchGasWellStatus
readSearch raw RRC gas-well status records by record type or text.
EntitieswellFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "record_type": { "type": "string" }, "search_text": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchUIC
readSearch raw RRC underground-injection-control records by record type or text.
EntitiesrecordFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "record_type": { "type": "string" }, "search_text": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }searchCompletionData
readSearch raw RRC completion records by record type or text.
EntitiescompletionFreshnessScheduled (source-level)Input schema
{ "type": "object", "properties": { "record_type": { "type": "string" }, "search_text": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" } }, "additionalProperties": false }
