List forecast sources
The forecast sources the caller can read, newest first: each one's listing record, without its curves, read report or pairs (GET one for those).
List forecast sources
/forecast-sourcesThe forecast sources the caller can read, newest first: each one's listing record, without its curves, read report or pairs (GET one for those). A private source lists only for its creator. Invalid limit or cursor is 400. A server without a state store answers 409 "Forecast sources need a state store; this server keeps plans in memory".
Parameters
Query parameters
limitintegerOptionalDefault
50≥ 1, ≤ 100Page size, 1-100.
cursorstringOptionalPage to read:
next_cursorfrom the previous page.
Responses
200 OK
Forecast sources and next cursor.
itemsarray of objectsRequiredNewest first.
ShowHide 16 child fields in each item
idstringRequiredFormat
uuidSource id.
namestringRequiredName.
formatstringRequiredThe file's format.
"valnav_decline""valnav_constants""novi_arps""combocurve_parameters""mosaic_decline""aries"unitsstringRequiredThe file's unit system; curves are stored in bbl/d and mcf/d.
"imperial""metric"conventionsstringRequiredThe decline conventions its curves run under.
"valnav""mosaic""combocurve""novi""aries"gas_basisstringRequiredraw or sales gas.
"raw""sales"curve_countintegerRequired≥ 0
Curves.
well_countintegerRequired≥ 0
Distinct Well IDs.
fileobjectRequiredThe file read; the file itself isn't kept.
ShowHide 3 child fields
namestring or nullRequiredThe uploaded file's name, or JSON file_name; null without one.
bytesintegerRequired≥ 0
Its size.
sha256stringRequiredIts SHA-256, hex.
visibilitystringRequiredprivate answers only its creator; tenant every user of the tenant.
"private""tenant"created_bystring or nullRequiredThe signed-in creator's email; null for a server's configured user.
created_atstringRequiredFormat
date-timeCreation time.
Show all 16 fields
updated_atstringRequiredFormat
date-timeLast change.
plan_idstring or nullRequiredFormat
uuidThe linked plan, or null when none is linked. A plan that is gone or that the caller can't read stays here with
plan_linked: false.plan_linkedbooleanRequiredWhether plan_id names a plan the caller can read: false with a plan_id when that plan is gone or hidden from the caller.
etagstringRequiredCurrent ETag including quotes; send as If-Match.
next_cursorstring or nullRequiredNext page, null at end.
Errors
| Status | When |
|---|---|
| 409 | A server without a state store answers 409 "Forecast sources need a state store; this server keeps plans in memory". |
Shared errors400401403500What they mean