Get several wells' production
Several existing wells' production in one request, each as GET /wells/{key}/production answers it, to overlay a forecast's contributing wells (their spread: POST /wells/typecurve).
Get several wells' production
/wells/productionSeveral existing wells' production in one request, each as GET /wells/{key}/production answers it, to overlay a forecast's contributing wells (their spread: POST /wells/typecurve).
Limits
Up to 50 keys, in request order, a repeated key once. ip_days keeps only those rows (1, then multiples of 30), each well's stopping where its history does. A key the dataset lacks is a 400 naming it (details.key).
Parameters
Query parameters
model_setstringOptionalpattern ^[a-z0-9][a-z0-9-]{0,62}$
The model set to answer from, an
idfrom GET /model-sets. Absent: the set GET /model-sets names asdefault, the base dataset unless the server answers from a published set.model_set=defaultreaches the base dataset; once the server retires it, a 400 naming the set answering instead.- An unknown id, or a set scoped to other tenants, is a 400 listing the ids the caller may use in
details.allowed(published sets only oncedefaultis retired); a set that can't load, a 503 with the reason. - Plans and exports stay in their set: a call naming them (by path,
plan,ids,source.plan, a scenario'splan.id, or a comparison'sa.planandb.plan, also undersource.comparison) reaches it withoutmodel_set. - An explicit
model_setwins; naming resources of two sets in one request is a 400.
Request body
application/json
Wellbore keys, and optionally ip_days.
keysarray of stringsRequired1 to 50 itemsItems 1 to 200 characters
Wellbore keys, 1 to 50; a repeat counts once.
ip_daysarray of integersOptional1 to 240 itemsItems ≥ 1
Only the rows at these ip_days, at most 240 (a repeat counts once in the answer); absent, every row.
Responses
200 OK
Each well's production, in request order.
countintegerRequired≥ 1
Wells.
wellsarray of objectsRequiredEach well as GET /wells/{key}/production answers it (its rows at ip_days, when sent), in request order.
ShowHide 4 child fields in each item
wellbore_keystringRequiredWellbore key.
countintegerRequiredRows.
unitsobjectRequiredUnits per column.
ShowHide 6 child fields
oilstringRequiredUnit of oil.
gasstringRequiredUnit of gas.
waterstringRequiredUnit of water.
cum_oilstringRequiredUnit of cum_oil.
cum_gasstringRequiredUnit of cum_gas.
cum_waterstringRequiredUnit of cum_water.
rowsarray of objectsRequiredPeriods by ip_day.
ShowHide 8 child fields in each item
datestring or nullRequiredFormat
dateProduction date, the end of the period.
ip_dayintegerRequiredDays since first production.
oilnumber or nullRequiredOil rate, bbl/d.
gasnumber or nullRequiredGas rate, mcf/d.
waternumber or nullRequiredWater rate, bbl/d.
cum_oilnumber or nullRequiredCumulative oil, bbl.
cum_gasnumber or nullRequiredCumulative gas, mcf.
cum_waternumber or nullRequiredCumulative water, bbl.
Errors
| Status | When |
|---|---|
| 413 | The request body is over 10 MB. |
Shared errors400401403500503What they mean