Well Lifecycle
Well lifecycle availability for one state
Detailed lifecycle availability report for a state, including reason codes and diagnostic samples.
get/v1/well-lifecycle/states/{state_code}
Path parameters
state_codestring required
Example:TX
Two-letter state code.
Query parameters
api_limitinteger
Example:100
Maximum permit APIs analyzed for bounded online validation.
fullboolean
Example:true
Run an unbounded full-state validation report. Use carefully for large states.
Response
Lifecycle state availability report
Example response
{
"status": "success",
"data": {
"state": "TX",
"status": "repair_required",
"validation_status": "research_required",
"success": true,
"reasons": [
"duplicate_source_records_need_state_policy"
],
"summary": {
"status": "summary_available",
"summary_wells": 12450,
"production_window": {
"first_production_month": "2019-01-01",
"latest_production_month": "2026-04-01"
},
"cumulative": {
"oil_bbl": 1850000,
"gas_mcf": 4250000,
"water_bbl": 3100000,
"boe": 2558333.33
},
"coverage_statuses": {
"full_chain": 11890,
"permit_spud_production_no_completion": 560
},
"frac_focus": {
"matched_wells": 10420,
"match_rate_pct": 83.7,
"latest_job_start_date": "2026-07-10"
}
}
}
}