API Documentation

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

Data sources: COGCC · CO NDIC · ND RRC · TX

🆕 Base URL

https://api.flynlochanalytics.com/api

🔒 API Access: All endpoints listed here are accessible to authenticated users. Most read endpoints are available to Explorer plan and above. Production history, bulk exports, and report generation require Analyst 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": "analyst" }
}

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 Analyst+

Full monthly production history for a well (oil BBL, gas MCF, water BBL). Available for Colorado and North Dakota 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 Analyst+

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.3M+ wells from Colorado, North Dakota, and Texas with full-text and filter support. Free accounts get 10 results; Explorer+ get 50; Analyst+ get 500.

Parameter	Type	Description
q	string	Full-text search (well name, operator, API number)
state	string	State code: CO, ND, TX
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 Analyst+)
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 Analyst+

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 Analyst+

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

Parameter	Type	Description
type	string	boe, oil, or gas (default: boe)
basin	string	Filter by basin (optional — omit for all basins)
months	number	Trailing months to sum (default 3, max 24)
limit	number	Number of wells to return (default 25, 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 Analyst+

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 Explorer+

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 Explorer+

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 Explorer+

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 Explorer+

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 Explorer+

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 Explorer+

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

GET /analytics/states/:code Explorer+

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 /data/permits Free

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

Parameter	Type	Description
state	string	CO or ND (default: all)
operator	string	Filter by operator (partial match)
county	string	Filter by county
basin	string	Filter by basin
days	number	Permits filed in last N days (default 30)
limit	number	Max results (default 100)

GET /data/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 Analyst+

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 Analyst+

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 Analyst+

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": "Your plan does not include API access. Upgrade to Analyst or higher." }

⏱ Rate Limits

Plan	Requests/min	Requests/day	Max Results
Free	10	100	10 per query
Explorer	20	500	50 per query
Analyst	60	2,000	500 per query
Professional	120	10,000	500 per query
Enterprise+	300	Unlimited	500 per query

Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset. If you need higher limits, contact support@flynlochanalytics.com.

🗺 Data Coverage

State	Source	Wells	Production	Formation Tops	Permits
CO	COGCC	~89K	Well-level monthly	298K rows	✓ COGCC
ND	NDIC	~43K	Well-level monthly (scout scrape)	208K rows	✓ NDIC
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.