v2

latestOpenAPI 3.0.4Commercial License2026-08-0718678294.5 KB
Well Lifecycle

Well lifecycle cohorts

Returns cohort-level cycle-time summaries from persisted lifecycle summaries for promoted states. Supported grouping dimensions are operator, county, and permit quarter.

get/v1/well-lifecycle/cohorts

Query parameters

state'NM' | 'WY' | 'ND' | 'AK' required

Promoted two-letter state code.

group_by'operator' | 'county' | 'quarter'
Example:operator

Cohort grouping dimension.

Response

Lifecycle cohort summaries

statusstring

Example response

{
  "status": "success",
  "data": {
    "state": "NM",
    "group_by": "operator",
    "count": 25,
    "cohorts": [
      {
        "key": "Example Energy LLC",
        "well_count": 150,
        "cycle_time_stats": {
          "avg_permit_to_first_prod_days": 126.8,
          "min_permit_to_first_prod_days": 45,
          "max_permit_to_first_prod_days": 260,
          "avg_permit_to_spud_days": 45.2,
          "avg_spud_to_completion_days": 58.7,
          "avg_completion_to_first_prod_days": 21.4,
          "avg_permit_to_frac_days": 69.2,
          "avg_completion_to_frac_days": 8.7,
          "avg_frac_to_first_prod_days": 52.1
        }
      }
    ]
  }
}