API reference

Oil and Gas API Workflow Examples

Use these patterns to test EnergyNetWatch API access with real business workflows: operator activity reports, permit monitoring, CRM enrichment, and AI tool integrations.

Start here · tested September 12, 2026

Export Ward County permits to a table

Retrieve every matching record in a trailing 90-day Texas county query, save CSV and JSON, then use the file for an AI-assisted review. This is a permit-record table, not a list of confirmed buyers or drilling projects.

38 records

25 on page 1, 13 on page 2

10 filing labels

Kept separate, not merged into companies

12 API units

2 requests × 6 units per request

This dated run was retrieved September 12 at 22:38 UTC. Its latest returned issue date was 2026-09-04, not September 12. A later run can differ; the existing county article retains its separate September 1 snapshot.

1. Get API access and keep your key private

Start with the $50 / 10,000-unit prepaid API pack, then create a key in the authenticated API Access screen with permits:read access. Add operators:read for the optional MCP operator lookup. A Premium app subscription is not required for the API-only path. Use Node.js 18 or later on your own computer or server; this example has no package dependencies.

2. Download and run the bounded export

Download the ZIP, extract county-permits-v1.mjs and inspect the script before running it. It uses state=TX, county=Ward, days=90 and 25 records per page. It follows pagination.nextPage until hasMore=false, checks the full count and rejects repeated record identities. It stops after five requests—30 estimated units—without presenting partial data as a complete export.

# Bash: open the folder containing county-permits-v1.mjs.
# Input is hidden and is not embedded in the command history.
read -r -s -p "EnergyNetWatch API key: " ENERGYNETWATCH_API_KEY
printf '\n'
export ENERGYNETWATCH_API_KEY
node county-permits-v1.mjs
unset ENERGYNETWATCH_API_KEY

In PowerShell or another shell, set the same environment variable using your secret-management method. Never paste a real key into this website, a chat prompt or the downloaded script. The script creates a new timestamped local folder and does not overwrite existing files.

Request shape and how to adapt it
GET https://api.energynetwatch.com/api/public/permits?state=TX&county=Ward&days=90&page=1&limit=25
X-API-Key: <from your private environment>

Set ENW_COUNTY to another recognized Texas county name, such as Yoakum. This sample deliberately requires a canonical Texas county response. Use the API reference to design other-state workflows; do not assume the same county or date semantics. Missing days means all-time on this endpoint, so always keep the explicit days=90 parameter for this task.

3. Check the files and source dates

permits.csv is the working table. permits.json retains the full returned records, query, count window, per-request source dates and request IDs. In our test, all 38 record identities were unique; PITTS ENERGY CO. appeared on 14 records. That is a filing-label count, not 14 confirmed new wells.

Three-row preview from the actual export—not the complete table

Permit number
918213
Source operator label
OCCIDENTAL PERMIAN LTD.
Issue date
2026-09-04
Permit number
918211
Source operator label
OCCIDENTAL PERMIAN LTD.
Issue date
2026-09-04
Permit number
918222
Source operator label
CRESCENT ENERGY OPERATING, LLC
Issue date
2026-09-02

Import permit/API identifiers as text in Excel; a CSV double-click can change identifiers. The raw api12 field may be shorter than its name suggests—do not assume it is normalized. Null spud dates remain blank/unknown, not zero. CSV formula prefixes are neutralized; raw JSON preserves the source. County membership uses the API-county identifier with a W-1 fallback; original county labels are retained.

This is live offset pagination, not a frozen database snapshot. The script detects changed totals and repeated identities, but a simultaneous same-count replacement may not be detectable. Use the request timestamps for traceability and recheck critical records before acting.

4. Review the table with AI; use MCP for a specific lookup

Attach the JSON to a file-capable AI client and use the provided review prompt. The current MCP permit-search tool has no native county filter. Keep this API export as the county population; use the Texas regulatory operator tool for an explicitly scoped follow-up.

Open the county AI review and MCP lookup prompts

What this run costs—and when to stop

Each permit-list request costs 6 units, not 6 units per record. Our two-page export used 12 units. One optional Texas regulatory operator search adds 2 units: 14 units total, about $0.07 of a $50 / 10,000-unit pack. The minimum pack purchase is $50; this is not a seven-cent checkout. AI-client charges are separate. Check the current API reference and your usage dashboard before scaling.

  • 401: check your key. 402: check available units. 403: check scope and access.
  • 429: inspect rate/quota headers and reset timing. Do not retry in a loop.
  • Timeout, failed response, changed count or page-budget limit: stop and investigate; already issued requests may have consumed units.
  • Zero returned records: report the exact query and window, not “no oil and gas activity.”
Recipes

Pick the workflow closest to your job

Each example shows the order of requests, the expected result, and the part to verify before scaling the job. Start narrow, confirm the response shape, then schedule or automate it.

Build a 12-month Texas operator activity report

Pull operator matches, permit activity, production context, and available infrastructure evidence for a short commercial report.

Best fit

Analyst report, business development prep, account review

Output

Operator profile, 12-month permits, production context, infrastructure signals, and source notes.

Request sequence

  1. 1
    Check available records
    GET https://api.energynetwatch.com/api/public/data-availability?search=OPERATOR_NAME&state=TX&includeCounty=true
  2. 2
    Find the operator id
    GET https://api.energynetwatch.com/api/public/operators?search=OPERATOR_NAME&limit=5
  3. 3
    Pull permit activity
    GET https://api.energynetwatch.com/api/public/operators/{id}/permits-summary?months=12
  4. 4
    Add production context
    GET https://api.energynetwatch.com/api/public/operators/{id}/production-summary
  5. 5
    Check infrastructure signals
    GET https://api.energynetwatch.com/api/public/infrastructure/operator-leads?operatorId={id}
Start with one operator name. Confirm the operator id before running deeper summary endpoints.

Monitor new permit activity for a sales territory

Run a scheduled server-side job for counties or operators and send only changed records into a CRM or dashboard.

Best fit

County watchlist, sales territory screen, recurring CRM update

Output

County-filtered permit records, exact source-label counts, and separately scoped statewide context.

Request sequence

  1. 1
    List recent county permits; follow every page
    GET https://api.energynetwatch.com/api/public/permits?state=TX&county=Reeves&days=90&page=1&limit=100
  2. 2
    Separate statewide operator ranking
    GET https://api.energynetwatch.com/api/public/permits/top-operators?state=TX&days=90
  3. 3
    Separate statewide growth context
    GET https://api.energynetwatch.com/api/public/permits/operator-growth?state=TX&days=90
Use the complete county export above for county counts. Top-operator and growth endpoints are separate state-level contexts, not this county population. Keep source dates and stable record identities.

Enrich CRM accounts with source-aware context

Match company names to operator records, then attach permitted activity and coverage notes to internal account records.

Best fit

CRM enrichment, account scoring, data cleanup

Output

Matched operator ids, permit summary fields, and coverage notes for account records.

Request sequence

  1. 1
    Check account coverage
    GET https://api.energynetwatch.com/api/public/data-availability?search=ACCOUNT_NAME
  2. 2
    Resolve likely operator
    GET https://api.energynetwatch.com/api/public/operators?search=ACCOUNT_NAME&limit=3
  3. 3
    Attach permit context
    GET https://api.energynetwatch.com/api/public/operators/{id}/permits-summary
Do not overwrite CRM account names automatically. Store the matched operator id and confidence context.

Smoke-test TX/NM infrastructure signal coverage

Pull live source-backed signal records before packaging a customer-facing report or handing an AI workflow a broader task.

Best fit

Signal report QA, infrastructure lead review, AI tool test

Output

Small TX PS-48 and NM APD samples plus a combined TX/NM signal summary.

Request sequence

  1. 1
    Sample Texas PS-48 notices
    GET https://api.energynetwatch.com/api/public/signals/tx/ps48?limit=2
  2. 2
    Sample New Mexico APDs
    GET https://api.energynetwatch.com/api/public/signals/nm/apds?limit=2
  3. 3
    Summarize signal coverage
    GET https://api.energynetwatch.com/api/public/reports/tx-nm-signal-summary
Treat these as public-record signals. They are not proof that a project is completed or in service.

Review a Texas injection or disposal well

Resolve a bounded Texas UIC record, review permit context, and retrieve official monthly injection reports without treating the result as a capacity quote.

Best fit

Disposal screening, regulatory research, source-backed commercial diligence

Output

UIC profile plus separate H-10 and H-10H monthly rows with dataset freshness and row provenance.

Request sequence

  1. 1
    Find bounded UIC records
    GET https://api.energynetwatch.com/api/public/regulatory/tx/uic/wells?operatorNo=628658&limit=10
  2. 2
    Inspect one permit profile
    GET https://api.energynetwatch.com/api/public/regulatory/tx/uic/wells/{uicControlNumber}
  3. 3
    Pull separate monthly reports
    GET https://api.energynetwatch.com/api/public/regulatory/tx/uic/wells/{uicControlNumber}/monthly?start=2025-01&end=2025-12&limit=100
Use the native nine-digit UIC control number for detail and history. Permitted or reported values do not prove available capacity, connectivity, price, remaining pore space, or third-party acceptance.

Give an AI agent guarded oil and gas tools

Use the API directly or through MCP so the agent can ask targeted questions without seeing database credentials.

Best fit

Codex, Claude Desktop, Cursor, internal AI tools

Output

A controlled tool path for availability checks, operator lookup, and signal summaries.

Request sequence

  1. 1
    Confirm key and limits
    GET https://api.energynetwatch.com/api/public/health
  2. 2
    Check data availability
    GET https://api.energynetwatch.com/api/public/data-availability?search=Civitas&state=TX
  3. 3
    Resolve operator records
    GET https://api.energynetwatch.com/api/public/operators?search=Civitas&limit=5
  4. 4
    Pull signal summary
    GET https://api.energynetwatch.com/api/public/reports/tx-nm-signal-summary
Keep the API key in a secret or environment variable. Do not paste keys into prompts.

Workflow guardrails

  • Store ENERGYNETWATCH_API_KEY server-side.
  • Log X-Request-ID for support and failed jobs.
  • Keep source dates, loaded-through values, and caveats in generated reports.
  • Treat PS-48, APD, facility, and infrastructure rows as source signals, not proof of project completion.
  • Treat UIC permit and monthly report values as regulatory context, not proof of commercial disposal availability or hydrocarbon production.
  • For UIC records, source and meta.freshness are the latest completed dataset clock; rowProvenance is the individual row clock.
  • Handle 402, 403, and 429 without retry loops.
  • Use data availability checks before broad pulls on unknown account lists.