Well Production Data

Status: Beta | Monthly cadence | State aggregates + limited well-level coverage

Monthly oil, gas, and water production volumes for US onshore wells and state-level production. State aggregates are sourced from EIA monthly production data. Well-level rows are collected from state regulatory filings where a production-grade source is verified.

Coverage

Use /v1/well-production/summary as the customer-visible source of truth for current coverage.

As of the July 4, 2026 production audit:

DatasetCurrent production coverage
State aggregates28 states from EIA monthly production, through 2026-04 in the audited snapshot
Well-level productionVerified persisted rows for AK, ND, and TX in the audited snapshot
Registered well-level workersTX, AK, NM, ND, PA, AR, MI, UT, CA, CO, MT, FL, MS, AL, LA, WY, OH

Additional states are added on a rolling basis. Check coverage.well_level_states_with_data in /v1/well-production/summary before relying on well-level coverage for a state.

Data Quality Notes

  • Beta: Schema and coverage are subject to change. Pin to a specific api_number or state_code and monitor /v1/well-production/summary for newly available well-level states.
  • Monthly granularity: Production records are reported by month. The production_date field is always the first of the reporting month.
  • Reporting lag: States publish production data on different schedules. Current monthly sources often lag 1-3 months; annual sources can lag 12+ months.
  • Nullable fields: oil_bbl, gas_mcf, and water_bbl may be null when the state did not report that volume type. null is distinct from 0.
  • BOE computation: boe is computed as oil_bbl + (gas_mcf / 6). It is null when both oil and gas are null.
  • Operator and well name: Populated from state filings. Names are not normalized across states — the same operator may appear under slightly different strings in different states.

Authentication

All endpoints require an API key. Pass it as a query parameter or Authorization header:

# Query parameter
curl "https://api.oilpriceapi.com/v1/well-production?api_key=YOUR_API_KEY"

# Authorization header (preferred)
curl "https://api.oilpriceapi.com/v1/well-production" \
  -H "Authorization: Token YOUR_API_KEY"

Endpoints

MethodEndpointDescription
GET/v1/well-productionNational summary alias
GET/v1/well-production/summaryNational summary, source metadata, and coverage
GET/v1/well-production/statesLatest state aggregate production rows
GET/v1/well-production/states/{state_code}State aggregate history
GET/v1/well-production/wells/{api_number}Well-level production history for one API number
GET/v1/well-production/top-producersTop producing wells for a state over a rolling period
GET/v1/well-production/cycle-timePermit-to-production cycle-time analysis
GET/v1/well-production/cycle-time/cohortsCycle-time cohort comparison

Record Schema

FieldTypeDescription
api_numberstring14-digit API well number (e.g., "42461410190000")
state_codestring2-letter state code (e.g., "TX")
production_datestringISO date, first of the reporting month (e.g., "2024-01-01")
production_yearintegerYear component of production_date
production_monthintegerMonth component of production_date (1–12)
oil_bblfloat | nullBarrels of oil produced
gas_mcffloat | nullThousand cubic feet of gas produced
water_bblfloat | nullBarrels of water produced
boefloat | nullBarrels of oil equivalent (oil_bbl + gas_mcf / 6)
operator_namestring | nullOperator name from state filing
well_namestring | nullWell name from state filing
countystring | nullCounty name
sourcestringData source identifier
granularitystring"state", "well", or derived aggregate granularity depending on endpoint
Last Updated: