Fetch Target

Retrieve a single target by its UUID. Returns the same fields as the list endpoint but scoped to one specific target — useful when you already know which target you need.

You can optionally control the depth reference of the returned values with the depthReference query parameter. If omitted, the target is returned in its stored reference type.

GET/api/v1/designs/{designid}/targets/{targetid}

Fetch a specific target by UUID

Path Parameters

Name	Type	Required	Description
designid	string (UUID)	✓	The UUID of the design
targetid	string (UUID)	✓	The UUID of the target

Parameters

Name	Type	Required	Description
depthReference	string	-	Depth reference for returned values: 'RKB' or 'MSL'. Defaults to the target's stored reference.

Headers

Name	Value	Description
apikey	YOUR_API_KEY	Your API authentication key

Response fields

Field	Type	Description
targetId	string (UUID)	Unique identifier of the target
name	string	Display name
shape	object	Target shape — type plus optional parameters. See Create Target for the shape catalogue.
depthTVD	string	True vertical depth, e.g. "2500|m"
depthReference	"RKB" or "MSL"	Depth reference datum
epsgCode	string	Coordinate reference system, e.g. "EPSG:32633"
mapPositionEasting	string	Easting on the projected map, e.g. "500000|m"
mapPositionNorthing	string	Northing on the projected map, e.g. "6000000|m"
geographicPositionLongitudeDD	number	Longitude in decimal degrees (read-only, computed server-side)
geographicPositionLatitudeDD	number	Latitude in decimal degrees (read-only, computed server-side)
geographicPositionLongitudeDMS	string	Longitude in degrees/minutes/seconds (read-only)
geographicPositionLatitudeDMS	string	Latitude in degrees/minutes/seconds (read-only)
azimuth	string	Optional, e.g. "135|deg"
dipAngle	string	Optional, e.g. "5|deg"
dipDirectionAzimuth	string	Optional, e.g. "180|deg"
confidenceLevel	string	Optional drillers-target confidence, e.g. "95|%"

Notes

• The response includes rc: "ok" plus the target object's fields at the top level
• Geographic position fields (geographicPosition*) are computed from the map position and the design's site coordinate system
• For polygon targets, the position is carried by the polygon's points instead of mapPositionEasting/mapPositionNorthing
• Useful for refreshing a single target after an edit, or for building a detail view