Skip to main content

Fetch Well Schematic

Retrieve the full well schematic for a design. The well schematic is an ordered list of sections (casings, liners, tiebacks, tubings, screens, and open holes), each containing its strings and optional packers.

The response shape mirrors the body of the Replace Well Schematic endpoint, with computed values populated from the dataset.

GET/api/v1/designs/{designid}/well-schematic

Get the complete well schematic for a design

Path Parameters

NameTypeRequiredDescription
designidstring (UUID)The UUID of the design

Headers

NameValueDescription
apikeyYOUR_API_KEYYour API authentication key

Response shape

FieldTypeDescription
sectionsarrayOrdered list of well-schematic sections, top-down
sections[].idstring (UUID)Section identifier
sections[].typestringOne of Casing, Liner, Tieback, Tubing, Screen, OpenHole
sections[].parametersobjectType-specific parameters (see section type docs)
svstringServer version
rcstringResponse code (ok on success)

Section types

Each section's parameters payload depends on its type:

TypeDescription
CasingCemented surface, intermediate, or production casing with strings and optional packers
LinerHung liner with cement parameters and strings
TiebackTieback to a previous liner; intermediate or production tubular
TubingProduction tubing with strings and optional packers
ScreenSand-control screen across reservoir
OpenHoleOpen hole interval (no strings)

See the Create Section endpoint for the full parameter shape per section type.

Notes

  • Returns 404 if the design exists but has no well schematic configured
  • All measurements are returned as unit-encoded strings, e.g. "3500\|m", "9.625\|in", "1.05\|sg"
  • Strings are listed in order from top to base