Well Production Data

Status: Beta | Monthly cadence | Sourced from state regulatory agencies

Monthly oil, gas, and water production volumes at the individual well level for US onshore wells. Data is sourced directly from state regulatory filings and normalized into a consistent schema across states.

Coverage

Additional states are added on a rolling basis. Check /v1/well-production/states for current coverage metadata.

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/states for newly available 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 1–3 months after the production month. Expect the most recent 1–3 months to be incomplete or missing for a given well.
• 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: Bearer YOUR_API_KEY"

Endpoints

Record Schema

Related

• Endpoint Reference — full parameter and response details for all 7 endpoints
• Well Permits — drilling permit data
• Rig Counts — Baker Hughes weekly rig count data