WellDatabase

Fetch selected well datasets and join them by stable WellDatabase well ID.

• ⚠ A child dataset can be not requested, empty, partial, unknown, or fail independently; inspect coverage before claiming completeness.
• ⚠ Completion intensity is a derived completion metric, not frac geometry or frac size.
• ⚠ Drainage radius is a user-supplied visualization assumption, not a WellDatabase measurement.

Returns per-dataset coverage; incomplete child data keeps the bundle partial.

⭐ ONE-CALL well dossier: completions+casings+stims+tests+spacing+cores+water+financial.

Pass wellId (UUID) or api. include:{tests:false,...} trims sections.

⭐ One-call operator trend: trailing-two-year monthly volume and direction for one fluid.

• ⚠ Scans at most 500 wells and fetches at most 100 well timeseries; inspect partial, truncated, and warnings.

Oil defaults to 2 years. Check coverage and partial flags.

Monthly/quarterly/yearly oil, gas, and water totals across a filtered multi-well set.

• ⚠ Operator/area aggregation scans at most 500 wells and fetches at most 100 well timeseries; inspect partial, truncated, and warnings.

Use for area/API-list trends; prefer getOperatorProductionTrend for operators.

Per-well cumulative and peak production summaries auto-joined with well headers in 2 calls.

Per-well summaries only; use getOperatorProductionTrend for time buckets.

Get wells by operator (headers only). Use getOperatorProduction if you also need production.

Default pageSize 50. Preserve raw result when mapping with subsurface.

Search well headers by well name, operator, API, state, county, or field.

Combine known identity fields before asking for another identifier.

Search well summary data with aggregated metrics.

Returns summary-level well information.

Search well locations with coordinates and surface hole data.

Returns lat/long, surface location, and geographic data.

Search WellDatabase rig-on-well history via POST /api/v2/rig/search.

• ⚠ Rig Records are historical observations associated with wells; use Enverus for current rig fleet/activity questions.

Historical rig-on-well records; operator/well criteria use HeaderFilters.

Monthly production for one well by wellId, API, or UWI.

One well only. Prefer wellId; never loop across wells.

Get full well details by API number.

Search raw production records by well.

Raw well records only; no cross-well aggregation.

⭐ Batch cumulative production: cumOil, cumGas, EUR, IP, decline for many wells in ONE call.

Cumulative/peak metrics only; not chronological buckets.

Search production forecast/decline curve data.

Predicted future production based on decline analysis

Get aggregated production forecast summaries (WellDatabase).

Summary of forecasted reserves and production

Search well completion records (WellDatabase).

Completion dates, intervals, and methods.

Search well stimulation/frac data.

Frac job details, proppant volumes, fluid volumes

Get aggregated stimulation summary data.

Summary of frac treatments by well

Search individual frac stage data.

Per-stage details: pressures, rates, proppant, fluid

Search frac fluid ingredient/chemical data.

Chemical additives and concentrations used in frac jobs

Search casing string data (surface, intermediate, production).

Casing sizes, weights, depths, cement data

Search perforation interval data.

Perf depths, shot density, interval details

Search plug data (bridge plugs, frac plugs).

Plug types, depths, and installation dates

Search plug and abandonment records.

P&A details, cement plugs, abandonment dates

Search tubing and packer data.

Tubing sizes, packer depths, completion equipment

Search directional survey data (WellDatabase).

MD, TVD, inclination, azimuth measurements

Screen nearby offset wells for anti-collision using ISCWSA separation factor.

wellId|api; bTotal, dip, declination; offsets = name family + offsetWellIds.

Search directional data with formation tops.

Survey data correlated with formation entries

Search WellDatabase directional survey headers, not individual survey stations.

Use searchDirectionals for measured-depth survey points.

Search formation records via POST /formations/search.

Use when you need filter/body-style formation queries from the provider API.

Search interpreted/normalized formation data.

Standardized formation assignments

Search core sample data.

Core intervals, recovery, and analysis data

Search WellDatabase laboratory core-analysis measurements and results.

Core analysis records, distinct from physical core inventory.

Search injection records (water, CO2, gas injection wells).

Monthly injection data for disposal/injection wells

Get cumulative injection summary data.

Aggregate injection volumes

Search water chemistry/analysis data.

Produced water chemistry data

Water volume production summary by well (WellDatabase water disposal and production).

Aggregate water production volumes

Search well test data (DST, production tests) (WellDatabase).

Drill stem tests, production tests, formation tests

Search drilling permit data (WellDatabase).

Permit numbers, dates, proposed depths, operators

Search well disposition/status change data.

Status changes and regulatory dispositions

Search aggregated disposition summary records.

Provider /dispositionSummary/search endpoint.

Search WellDatabase regulatory-order records linked to wells and jurisdictions.

Structured order metadata from /regulatoryOrders/search.

Search WellDatabase regulatory-order text records and document content.

Text records from /regulatoryOrderText/search.

Search well spacing unit data.

Spacing orders, unit configurations

Search environmental incident reports.

Spills, releases, and environmental events

Search comments on environmental incidents.

Additional incident details and notes

Search substances involved in environmental incidents.

Spilled materials, volumes, and types

Search scanned files and document attachments linked to well records.

Attached documents, reports, images

Search file tags/categories.

Document classification and tagging

Search well history/event records.

Chronological well events and activities

Search deleted/removed records.

Audit trail of removed data

Search WellDatabase contact records associated with wells and organizations.

Contact records from /contacts/search.

Search WellDatabase mineral, lease, and working-interest owner records.

Ownership records from /owners/search.

Search WellDatabase well-level financial and economic records.

Financial records from /wellfinancial/search.

Search WellDatabase production volumes reported at the lease level.

Supports record IDs and dates, not well, API, operator, or lease-name filters.

Search gas gatherer/pipeline data.

Gathering systems and transporters

Download selected WellDatabase well-file binaries to a private signed link.

Pass exact file UUIDs; provider bytes never enter model text.

List one exact WellDatabase reference resource selected by its provider identifier.

Select a resource enum value; paginate with pageSize and pageOffset.

Get one exact WellDatabase reference-resource record by its provider ID.

List one exact documented relationship from a WellDatabase reference entity.

The pinned API help supports every declared entityType and nested-resource pair.