Skip to main content
GET
Read an owned or same-account scoped receipt and bounded group detail
Preview contract. Production availability remains subject to activation and release qualification. Examples are synthetic; the documentation cannot submit requests.

​
Authorization

Owning integration namespace; alternatively same-account read plus the exact authorized link/instrument.

​
Behavior

Read an exact receipt UUID. Group detail includes up to 64 child targets; zero-target groups can omit targets. Other-namespace read permission does not grant mutation namespace authority. A receipt state never replaces actual position evidence.

​
Request example

All IDs and dates are illustrative. URL-encode opaque query values and supply each allowed key once. Optional filters and their types appear in the generated schema below.

​
Response and errors

The generated response schema below is the wire contract. Preserve fixed-point strings, nullable fields and endpoint-specific envelopes. Inspect HTTP status and Content-Type before decoding failures; reused trading routes may return JSON or plain text. Authentication, entitlement and exact link/instrument restrictions apply in addition to endpoint validation. See errors and recovery. Read the related guide for lifecycle, units and recovery semantics.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
id
string<uuid>
required

Response

Success

Durable command receipt, never a fill/completion assertion. Terminal request fields correlate a durable termination owner handoff. Terminal arm writes kind/sequence while retaining dispatching; owner return or startup canonical evidence advances handed_off. Group parent position_id is null. Precedence is operator_required, dispatching, accepted, then homogeneous resolved state or partial. Zero-target parent is execution_observed. Counts and child states do not prove exposure is flat.

​
id
string<uuid>
required
​
client_command_id
string
required
​
action
string
required
​
state
enum<string>
required
Available options:
accepted,
dispatching,
handed_off,
execution_observed,
rejected,
expired,
operator_required,
partial
​
position_id
string<uuid> | null
required
​
error_code
string | null
required
​
created_at
integer<int64>
required
​
updated_at
integer<int64>
required
​
terminal_request_kind
enum<integer>
Available options:
1,
2
​
terminal_request_seq
integer<int64>
Required range: x >= 1
​
group_id
string<uuid>

Parent group on a child termination receipt.

​
group
object

Counts sum to the immutable target_count. Zero targets records an observed empty selection, not market flatness.

​
targets
object[]

Group detail only: at most 64 frozen ordinary termination receipts. Targets cannot contain nested groups or target arrays. Omitted on list responses and zero-target groups.

Maximum array length: 64