API Documentation

The EnergiQ API provides programmatic access to well data, production history, permits, market prices, and analytics across Colorado, New Mexico, North Dakota, Texas, and West Virginia — covering over 1.6 million well records from COGCC, NM OCD, NDIC, Texas RRC, and WVDEP. All endpoints return JSON.

Data sources: COGCC · CO NDIC · ND RRC · TX NM OCD · NM WVDEP · WV

🆕 Base URL

https://api.flynlochanalytics.com/api

🔒 API Access: All endpoints listed here are accessible to authenticated users. Most read endpoints are available to Pro plan and above. Production history, bulk exports, and report generation also require Pro or higher. Your token is shown above once you're signed in.

🔑 Authentication

All API requests must include your JWT token in the Authorization header. Obtain your token by logging in via the auth endpoint or copying it from the box above (visible when signed in).

POST /auth/login Free

Obtain a JWT access token. Token is valid for 7 days.

{
  "email":    "user@example.com",
  "password": "yourpassword"
}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user":  { "id": "...", "email": "...", "name": "...", "role": "pro" }
}

Using the Token

curl https://api.flynlochanalytics.com/api/search/wells?state=TX&basin=Permian+Basin \
  -H "Authorization: Bearer YOUR_TOKEN"

import requests

TOKEN = "your_token_here"
BASE  = "https://api.flynlochanalytics.com/api"
headers = {"Authorization": f"Bearer {TOKEN}"}

# Search Permian Basin wells
r = requests.get(f"{BASE}/search/wells",
    params={"basin": "Permian Basin", "state": "TX", "status": "active", "limit": 100},
    headers=headers)
data = r.json()
print(f"{data['total']:,} wells found")

🔍 Wells

GET /data/wells/:id Free

Get full well detail by well ID or API number. Returns formation tops, completions, and casing where available. The data_source field indicates origin: COGCC, NDIC, or RRC.

Parameter	Type	Description
:id	string	Well ID (internal) or API number. CO: 12-digit (e.g. 051233676800). ND: 14-digit. TX: RRC API format.

Colorado (COGCC) example

GET /data/wells/051233676800

{
  "well": {
    "id": "e68071da-...",
    "api_number": "051233676800",
    "well_name":  "WELLS RANCH AE #05-63-1HN",
    "operator":   "NOBLE ENERGY INC",
    "state":      "CO",
    "basin":      "DJ Basin",
    "formation":  "NBRR",
    "status":     "active",
    "latitude":   40.51195,
    "longitude": -104.35634,
    "data_source": "COGCC",
    "depth_ft":   11177
  },
  "formation_tops": [
    { "formation": "PIERRE",   "top_ft": 3051, "cored": false },
    { "formation": "NIOBRARA", "top_ft": 6880, "cored": false }
  ],
  "completions": [
    { "completion_date": "2013-04-25", "measured_td_ft": 11177,
      "stages": 20, "total_proppant_lbs": 3472255,
      "ip_oil_bbl": 143, "ip_gas_mcf": 118 }
  ],
  "production_preview": [...]
}

North Dakota (NDIC) example

GET /data/wells/3305301942

{
  "well": {
    "api_number":  "3305301942",
    "well_name":   "CONTINENTAL #5502H",
    "operator":    "CONTINENTAL RESOURCES INC",
    "state":       "ND",
    "basin":       "Williston Basin",
    "formation":   "BAKKEN",
    "status":      "active",
    "data_source": "NDIC",
    "ndic_file_no": "25419",
    "field_name":  "REUNION BAY",
    "cum_oil_bbl": 1204318,
    "ip_oil_bopd": 1981,
    "ip_date":     "2012-06-15"
  },
  "formation_tops": [ ... ],
  "completions":    [ ... ]
}

Texas (RRC) example

GET /data/wells/[tx-well-id]

{
  "well": {
    "api_number":      "42-317-...",
    "well_name":       "PIONEER 1H",
    "operator":        "PIONEER NATURAL RESOURCES",
    "state":           "TX",
    "county":          "Midland",
    "basin":           "Permian Basin",
    "data_source":     "RRC",
    "rrc_lease_no":    "12345",
    "rrc_district_no": "08",
    "status":          "active",
    "latitude":        31.9874,
    "longitude":      -102.0712
  },
  "formation_tops": [],
  "completions":    []
}

TX Note: Formation tops and completion data are not yet available for Texas wells. Production data for TX is currently at the county level — see the Production section for details.

GET /data/wells/:id/production Pro+

Full monthly production history for a well (oil BBL, gas MCF, water BBL). Available for Colorado, New Mexico, North Dakota, and West Virginia wells. Texas well-level production is in development — see Production Analytics for county-level TX data.

GET /data/wells/051233676800/production

{
  "well_id": "e68071da-...",
  "production": [
    { "period": "2024-12-01", "oil_bbl": "2312", "gas_mcf": "23847", "water_bbl": "1104" },
    { "period": "2024-11-01", "oil_bbl": "2689", "gas_mcf": "27713", "water_bbl": null }
  ]
}

GET /data/formation-tops/download Pro+

Download formation tops as CSV. Available for Colorado (~298K rows) and North Dakota (208K rows from NDIC scout data). Not yet available for Texas.

Parameter	Type	Description
api_list	string	Comma-separated API numbers
operator	string	Operator name (partial match)
basin	string	Basin name (partial match)
formation	string	Formation name filter
state	string	CO or ND

🔎 Search

GET /search/wells Free (limited)

Search across 1.6M+ wells from Colorado, New Mexico, North Dakota, Texas, and West Virginia with full-text and filter support. Free accounts get 10 results; Pro and above get 500.

Parameter	Type	Description
q	string	Full-text search (well name, operator, API number)
state	string	State code: CO, NM, ND, TX, WV
basin	string	Filter by basin name (e.g. Permian Basin, DJ Basin, Williston Basin)
status	string	active, plugged_abandoned, shut_in, temp_abandoned, injection, drilling
formation	string	Formation code or name (partial match)
county	string	County name
operators	string	Comma-separated operator names (exact match)
spud_from	date	Spud date range start (YYYY-MM-DD)
spud_to	date	Spud date range end (YYYY-MM-DD)
depth_min	number	Minimum total depth (ft)
depth_max	number	Maximum total depth (ft)
data_source	string	Filter by source: COGCC, NDIC, or RRC
limit	number	Results per page (max 500 for Pro and above)
offset	number	Pagination offset

GET /search/wells?state=TX&basin=Permian+Basin&status=active&limit=50

{
  "results": [
    { "id": "...", "well_name": "PIONEER 1H", "operator": "PIONEER NATURAL RESOURCES",
      "state": "TX", "county": "Midland", "basin": "Permian Basin",
      "status": "active", "data_source": "RRC" },
    ...
  ],
  "total": 527639,
  "limited": false
}

GET /search/nearby Pro+

Find wells within a radius of a coordinate point using Haversine distance. Works across all states.

Parameter	Type	Description
lat	number	Latitude (decimal degrees)
lng	number	Longitude (decimal degrees)
miles	number	Search radius in miles (default 5, max 50)
limit	number	Max results (default 50)
exclude	string	Well ID to exclude from results

📈 Production

Monthly production data is available at the well level for Colorado and North Dakota. Texas production data is currently available at the county level from the Texas RRC, with well-level lease data in development.

GET /analytics/top-wells Pro+

Top producing wells by BOE, oil, or gas for a given trailing period and basin. Returns CO, NM, ND and WV wells (well-level production). TX well-level data pending Phase 2.

Parameter	Type	Description
type	string	boe, oil, or gas (default: oil)
basin	string	Filter by basin (optional — omit for all basins)
months	number	Trailing months to sum (default 1, max 12)
limit	number	Number of wells to return (default 20, max 100)

GET /analytics/top-wells?type=boe&basin=DJ+Basin&months=6&limit=20

{
  "wells": [
    { "id": "...", "well_name": "CIVITAS 44-25H", "operator": "CIVITAS RESOURCES INC",
      "basin": "DJ Basin", "county": "Weld", "formation": "NBRR",
      "total_boe": 184210, "avg_boe_day": 1009, "months_reported": 6 }
  ]
}

GET /analytics/states/:code/production Pro+

Monthly production trend for a state. CO and ND return well-level aggregates. TX returns county-level aggregates from the Texas RRC.

Parameter	Type	Description
:code	string	State code: CO, ND, TX
months	number	Trailing months of history (default 24)

TX note: Texas production volumes are aggregated from county-level RRC data (tx_county_production table). History available from 1993 to present. Figures represent gross reported volumes, not net.

📊 Analytics

GET /analytics/operators Pro+

List operators with well counts, active producing wells, and 12-month production. Supports reported (as-filed) and current (post-M&A rollup) views.

Parameter	Type	Description
sort	string	active (default), well_count, oil, gas
limit	number	Results per page (default 50)
offset	number	Pagination offset
search	string	Partial name match
mode	string	reported (default) or current — current merges acquired entities via MDM
basin	string	Filter by basin

GET /analytics/operators?mode=current&sort=active&limit=10

{
  "operators": [
    { "operator": "Civitas Resources", "well_count": 12840, "producing_wells": 4721,
      "oil_mbbl_12mo": 28340, "gas_mmcf_12mo": 94120,
      "new_wells_18mo": 312, "legacy_count": 5 }
  ],
  "total": 847,
  "mode": "current"
}

GET /analytics/operators/:name Pro+

Operator detail: production trend (24 months), top wells, formations breakdown, basin breakdown. Based on reported operator name (as filed with state agency).

GET /analytics/operators/:name/parent Pro+

Current operator (post-acquisition) detail. Aggregates all legacy entity names under the parent. Includes a legacy_entities breakdown table showing pre-acquisition operator names and their well counts.

GET /analytics/operators/Civitas%20Resources/parent

{
  "parent_company": "Civitas Resources",
  "ticker": "CIVI",
  "aliases": [
    { "operator_name": "BONANZA CREEK ENERGY", "acquisition_date": "2021-06-07" },
    { "operator_name": "EXTRACTION OIL & GAS", "acquisition_date": "2021-11-01" },
    { "operator_name": "HIGHPOINT RESOURCES", "acquisition_date": "2022-04-01" }
  ],
  "legacy_entities": [...],
  "prod_trend": [...],
  "top_wells": [...],
  "formations": [...]
}

GET /analytics/basins Pro+

All basins with well counts, producing wells, operator counts, and 12-month production. Includes CO, ND, and TX basins. TX production from county-level data.

GET /analytics/basins/:name Pro+

Basin detail: production trend, top operators, top wells (CO/ND), formations. For TX basins (Permian, Eagle Ford, etc.), production trend uses county-level RRC data.

GET /analytics/basins/Permian%20Basin

{
  "name":            "Permian Basin",
  "state":           "TX",
  "well_count":      527639,
  "producing_wells": 154823,
  "operator_count":  2847,
  "oil_mmbbl_12mo":  2140.3,
  "gas_bcf_12mo":    5821.4,
  "prod_trend": [
    { "period": "2024-12-01", "oil_bbl": 178420000, "gas_mcf": 485200000 }
  ],
  "top_operators": [...],
  "formations": [...]
}

GET /analytics/states Pro+

All states with summary stats. Currently: CO, ND, TX.

GET /analytics/states/:code Pro+

State detail: production trend, basin breakdown, top operators, recent permits, top wells. TX production from county-level RRC data.

Parameter	Type	Description
:code	string	CO, ND, or TX

GET /analytics/states/TX

{
  "state":           "TX",
  "well_count":      1195235,
  "producing_wells": 154823,
  "operator_count":  4218,
  "basin_count":     6,
  "oil_mmbbl_12mo":  2140.3,
  "gas_bcf_12mo":    5821.4,
  "prod_trend":      [...],
  "basins":          [...],
  "top_operators":   [...]
}

GET /analytics/totals Free

Platform-wide totals: total well count, producing wells, total operators. Used for summary tiles.

📄 Permits

GET /analytics/permits Free

Recent drilling permits with operator, location, and status. Available for Colorado (COGCC), North Dakota (NDIC), and West Virginia (WVDEP). Texas permit data is not integrated.

Parameter	Type	Description
state	string	CO, ND, or WV (default: all)
operator	string	Filter by operator (partial match)
basin	string	Filter by field / basin name
well_name	string	Filter by well name or API label
days	number	Permits in the last N days (default: no date limit)
limit	number	Max results (default 50, max 200)
offset	number	Pagination offset

GET /analytics/permits?state=ND&days=14&limit=20

{
  "permits": [
    { "api_number": "33-053-...", "operator": "CONTINENTAL RESOURCES INC",
      "well_name": "RENEWAL 1-17H", "county": "Mountrail", "state": "ND",
      "permit_date": "2026-04-02", "formation": "BAKKEN", "status": "approved" }
  ],
  "total": 47
}

💲 Market Prices

GET /market/prices Free

Current WTI, Brent, and Henry Hub spot prices from FRED. Cached 15 minutes.

{
  "wti":   { "price": 71.24, "date": "2026-04-10", "unit": "USD/BBL" },
  "brent": { "price": 74.83, "date": "2026-04-10", "unit": "USD/BBL" },
  "hh":    { "price":  2.94, "date": "2026-04-10", "unit": "USD/MMBtu" }
}

GET /market/prices/history Pro+

Historical price data for a commodity symbol (WTI, BRENT, HH). Sourced from FRED; up to 730 days of history.

Parameter	Type	Description
symbol	string	WTI, BRENT, or HH
days	number	Days of history (max 730)

GET /market/earnings/:symbol Pro+

Historical EPS, forward estimates, and fundamentals for an E&P equity ticker. Sourced from Alpha Vantage (fundamentals, daily cache) and Yahoo Finance (live price).

GET /market/earnings/XOM

{
  "symbol": "XOM",
  "history": [
    { "period": "-4q", "date": "2025-12-31", "eps_actual": 1.67,
      "eps_est": 1.56, "eps_diff": 0.11, "surprise_pct": 7.05 }
  ],
  "stats": { "trailing_eps": 7.84, "forward_pe": 14.2, "revenue_growth": 0.032 }
}

📋 Reports

POST /reports/due-diligence Pro+

Generate a PDF due diligence report for an operator. Returns a PDF download or emails it to your account address. Currently generates from CO/ND well-level data. TX operator reports use county-level production where well-level is not yet available.

{
  "operator":   "Civitas Resources",
  "ticker":     "CIVI",
  "send_email": false,
  "sections": {
    "summary":    true,
    "production": true,
    "revenue":    true,
    "permits":    true,
    "regulatory": true,
    "completion": true,
    "formations": true,
    "equity":     true
  }
}

When send_email: false, returns the PDF as a binary download. When true, emails to your account address and returns {"success": true, "emailed": true}.

⚠ Error Codes

Status	Code	Meaning
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Missing, invalid, or expired token
403	Forbidden	Your plan doesn't include this endpoint
404	Not Found	Resource doesn't exist
429	Rate Limited	Too many requests — slow down
500	Server Error	Something went wrong on our end

{ "error": "Pro plan required", "message": "Upgrade to Pro to use this feature", "upgrade": "/#pricing", "required_plan": "pro" }

⏱ Rate Limits

Plan	Search results per query	Exports per day
Free	10	Exports require Pro
Pro	500	50
Custom	500	1,000

Search requests are limited to 60 per minute per account; a request over the limit returns 429 with a Retry-After header. Daily export counts are monitored and reviewed rather than hard-stopped. If you need higher limits, contact support@flynlochanalytics.com.

🗺 Data Coverage

State	Source	Wells	Production	Formation Tops	Permits
CO	COGCC	~90K	Well-level monthly	298K rows	✓ COGCC
ND	NDIC	~44K	Well-level monthly (scout scrape)	208K rows	✓ NDIC
NM	NM OCD	~143K	Well-level monthly	Available	Not offered
WV	WVDEP	~119K	Well-level monthly	Available	✓ WVDEP
TX	RRC	~1.2M	County-level (Phase 1) · lease-level in development	Pending	Pending

Data is updated weekly for CO and ND via automated pipelines. Texas RRC data is refreshed quarterly from bulk RRC downloads. Questions about data freshness: support@flynlochanalytics.com.