v2

latestOpenAPI 3.0.4Commercial License2026-08-0718678294.5 KB
Well Lifecycle

Well lifecycle summary for one well

Returns the persisted permit-to-production lifecycle summary for a single promoted-state well. Runtime requests read materialized lifecycle summaries and do not perform large raw permit/production joins.

get/v1/well-lifecycle/wells/{api_number}

Path parameters

api_numberstring required

10-, 12-, or 14-digit API number. Common dashed formats are accepted and normalized to a 14-digit API number.

Response

Persisted lifecycle summary

statusstring

Example response

{
  "status": "success",
  "data": {
    "api_number": "30015234560000",
    "state": "NM",
    "county": "Eddy",
    "operator": "Example Energy LLC",
    "well_name": "STATE 1H",
    "source": "New Mexico OCD",
    "production": {
      "production_months": 18,
      "cumulative_oil_bbl": 125000,
      "cumulative_gas_mcf": 400000,
      "cumulative_water_bbl": 210000,
      "cumulative_boe": 191666.67
    },
    "cycle_times": {
      "permit_to_spud_days": 40,
      "spud_to_completion_days": 70,
      "completion_to_first_prod_days": 26,
      "permit_to_first_prod_days": 136,
      "permit_to_frac_days": 69,
      "completion_to_frac_days": 9,
      "frac_to_first_prod_days": 52
    },
    "frac_focus": {
      "matched": true,
      "disclosure_count": 1,
      "match_status": "exact_api_match",
      "match_confidence": 100,
      "primary_upload_key": "ff-upload-1",
      "job_start_date": "2024-03-10",
      "job_end_date": "2024-03-12",
      "water_gallons": 12750000,
      "non_water_gallons": 100,
      "chemical_count": 42,
      "source": "FracFocus"
    },
    "source_coverage_status": "full_chain",
    "data_quality_flags": [
      "missing_completion_date"
    ]
  }
}