Skip to main content
GET
/
v1
/
ws
/
executions
Ws Executions Upgrade Hint
curl --request GET \
  --url https://api.polysimulator.com/v1/ws/executions
{
  "error": "<string>",
  "message": "<string>",
  "details": {},
  "request_id": "<string>"
}

Response

Resource not found (market / order / token).

Structured error response for all API v1 endpoints.

PM-parity (PR #1033): the default 4xx body is the PM-shape single-field {"error": "<human message>"}. The full structured body documented by this model is only returned when the caller opts in via the X-Polysim-Verbose: true request header. Every field below maps to a response header on the default path:

  • error carries the human-readable message in the default body and the machine code in the verbose body. The machine code is ALWAYS exposed via the X-Polysim-Code response header so SDK consumers can switch on a stable identifier without parsing the body.
  • request_id → exposed as the X-Request-Id response header on every response (success and error).

All non-required fields are Optional so generated SDK code can deserialize either shape (PM-default or polysim-verbose) without choking on missing keys. Pre-PR message was required, which broke SDK deserialization of the new PM-shape body.

error
string
required

Human-readable message (PM-shape default body) OR machine-readable error code (verbose body). The machine code is always available in the X-Polysim-Code response header.

message
string | null

Human-readable error description — populated only on verbose body (X-Polysim-Verbose: true).

details
Details · object

Additional context — populated only on verbose body.

request_id
string | null

Request id for support reference. Always exposed via X-Request-Id response header; only inlined in the verbose body.