Texas RRC Data data contract | PatchOps Knowledge

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

FreshnessFreshness not declared

GeographicTexas

TemporalNot declared

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 (34)

searchWells

read

Search Texas wells by API, operator, county name or code, status, bbox, or nearby point.

Entitieswell

Paginationoffset (offsetField: offset, limitField: limit)

Unitswells[].latitude: decimal degrees · wells[].longitude: decimal degrees

CRSOGC:CRS84

FreshnessScheduled

Input schema

{
  "type": "object",
  "properties": {
    "api": {
      "type": "string",
      "description": "API number (e.g. \"42383...\")."
    },
    "operator": {
      "type": "string",
      "description": "Operator name (partial ILIKE match)."
    },
    "county": {
      "type": "string",
      "description": "County name (e.g. \"MIDLAND\", \"ECTOR\"). Resolved to county_code automatically."
    },
    "county_code": {
      "type": "string",
      "description": "RRC county code (e.g. \"329\" for Midland). Use county name instead if you do not know the code."
    },
    "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",
      "description": "Bounding box [xmin, ymin, xmax, ymax] in WGS84."
    },
    "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."
    },
    "near": {
      "type": "object",
      "description": "Alternative nearby point object: { lon, lat, radius_meters }."
    },
    "limit": {
      "type": "number",
      "description": "Maximum records (default 100, max 80000)."
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset (default 0)."
    }
  },
  "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
read
Area wrapper. Pass bbox or latitude/longitude/radius_meters or near object.

getWellDetail

read

Fetch a single well by API number.

Required paramsapi

Entitieswell

Paginationnone

Unitslatitude: decimal degrees · longitude: decimal degrees

CRSOGC:CRS84

FreshnessScheduled

Input schema

{
  "type": "object",
  "properties": {
    "api": {
      "type": "string",
      "description": "API number."
    }
  },
  "required": [
    "api"
  ],
  "additionalProperties": true
}

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.
Pass api OR leaseNumber+county. Sections degrade solo — check _sections_failed.
getWellProduction
read
Return monthly production for every exact RRC lease identity associated with a well API.
Required paramsapi
getLeaseOperator
read
Return the current P-4 operator, production history, and registry mismatch for a lease.

searchPipelineSegments

read

Search RRC pipeline segments by pipeline number, properties, bbox, or nearby point. Discovery helper only; use getPipelineGeoJSON() or searchGisPipelines() when the user wants line geometry on a map.

Input schema

{
  "type": "object",
  "properties": {
    "pipeline_number": {
      "type": "string",
      "description": "Pipeline number."
    },
    "bbox": {
      "type": "array",
      "description": "Bounding box [xmin, ymin, xmax, ymax]."
    },
    "near": {
      "type": "object",
      "description": "Nearby point filter."
    },
    "limit": {
      "type": "number",
      "description": "Maximum records to return."
    }
  },
  "additionalProperties": true
}

getPipelineGeoJSON

read

Return pipeline segments as GeoJSON for map line rendering. Use this with patchops_addMapLayer({ geojson }).

Required paramsbbox

Input schema

{
  "type": "object",
  "properties": {
    "pipeline_numbers": {
      "type": "array",
      "description": "Optional list of pipeline numbers to include."
    },
    "bbox": {
      "type": "array",
      "description": "Bounding box [xmin, ymin, xmax, ymax]."
    },
    "simplify_tolerance": {
      "type": "number",
      "description": "Optional geometry simplification tolerance."
    },
    "limit": {
      "type": "number",
      "description": "Maximum features (default 1000, max 5000)."
    }
  },
  "additionalProperties": true
}

listPipelines

read

List available pipeline numbers with segment counts. Supports pagination.

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
read
Find pipeline segments near a point. Discovery only — follow with getPipelineGeoJSON for lines.
Required paramslatitudelongitude
getDataStatus
read
Report freshness and row counts for managed RRC datasets, including withheld unverified feeds.

searchProductionByArea

read

Search lease-level production by area, operator, or date.

Input schema

{
  "type": "object",
  "properties": {
    "operator": {
      "type": "string",
      "description": "Operator name (partial ILIKE match)."
    },
    "bbox": {
      "type": "array",
      "description": "Bounding box [xmin, ymin, xmax, ymax]."
    },
    "near": {
      "type": "object",
      "description": "Nearby point filter."
    },
    "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)."
    },
    "limit": {
      "type": "number",
      "description": "Maximum records (default 1000, max 5000)."
    }
  },
  "additionalProperties": true
}

getProductionGeoJSON
read
Return lease production as GeoJSON for map rendering (point centroids or polygons).

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.

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)."
    },
    "operator": {
      "type": "string",
      "description": "Alias for facility_name search — R3 data has no operator column, but many plant names contain the operator."
    },
    "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\")."
    },
    "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)."
    },
    "near": {
      "type": "object",
      "description": "Alternative nearby point: { latitude, longitude, radius_meters }."
    },
    "limit": {
      "type": "number",
      "description": "Maximum records (default 50, max 200)."
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset (default 0)."
    }
  },
  "additionalProperties": true
}

searchInspections

read

Search Oil/ICE inspection records by API, operator, county name, compliance, or date range.

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

read

Search Oil/ICE violations by API, operator, rule, or date range.

Input schema

{
  "type": "object",
  "properties": {
    "api": {
      "type": "string",
      "description": "API number."
    },
    "operator_name": {
      "type": "string",
      "description": "Operator name."
    },
    "violated_rule": {
      "type": "string",
      "description": "Rule text or code."
    },
    "major_only": {
      "type": "boolean",
      "description": "Only major violations."
    }
  },
  "additionalProperties": true
}

searchDockets
read
Search live RRC CASES Oil & Gas docket case-headers by district, status, rule, year, or case number.
getDocket
read
Fetch a single RRC CASES docket case-header by 8-digit case number.
Required paramscaseNumber
searchOrganizations
read
Search P5 organizations (operators) by name, operator number, status, city, or state.
searchFieldNames
read
Search oil & gas field names and numbers by name, district, county code, or classification.
searchWellboreData
read
Search wellbore query data by API, district, county, operator, field, or well type.
searchHorizontalPermits
read
Search horizontal drilling permits by permit, operator, county, district, field, date.
searchGasAnnualReports
read
Search gas annual report field tables by year, district, field name, or county.
searchOilAnnualReports
read
Search oil annual report field tables by year, district, field name, or county.
searchProductionReports
read
Search pending production reports by API, operator, cycle year/month.
searchPendingLeases
read
Search pending lease identifiers by API number, operator, or lease name.
searchP18SkimOil
read
Search P-18 skim oil/condensate reports by serial number, operator, district, or county.
searchDrillingPermits
read
Search current RRC drilling applications and permits by operator, district, county, API, or date.
searchGisWellLocations
read
Search well coordinates by API, county, type, status, operator, or radius; requires one filter.
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.
searchGisHorizontalPaths
read
Search RRC GIS horizontal/directional well path polylines near a location.
Required paramsbbox
searchGisPipelines
read
Search RRC GIS T-4 pipelines. Merges segments into MultiLineStrings by system.
Required paramsbbox
searchGisInjectionWells
read
Search RRC GIS injection/disposal wells (UIC) near a location.
Required paramsbbox
getInjectionWellsGeoJSON
read
All TX RRC Class II injection/disposal (UIC) wells statewide as GeoJSON (keyset-paginated).
Use with patchops_addMapLayer for a full-state injection-well map.

Texas RRC Data

Provenance

Freshness & coverage

Caveats

Methods (34)

searchWells

searchWellsByArea

getWellDetail

getWellDossier

getWellProduction

getLeaseOperator

searchPipelineSegments

getPipelineGeoJSON

listPipelines

getPipelinesNearLocation

getDataStatus

searchProductionByArea

getProductionGeoJSON

searchGasProcessingPlants

searchInspections

searchViolations

searchDockets

getDocket

searchOrganizations

searchFieldNames

searchWellboreData

searchHorizontalPermits

searchGasAnnualReports

searchOilAnnualReports

searchProductionReports

searchPendingLeases

searchP18SkimOil

searchDrillingPermits

searchGisWellLocations

searchGisSurveys

searchGisHorizontalPaths

searchGisPipelines

searchGisInjectionWells

getInjectionWellsGeoJSON