Operator Api

Redemptions

Query Mini App redemption records.

Redemptions

GET /api/operator/redemptions lists Mini App redemption records for the authenticated operator.

Required scope: redemptions:read

Query params

Parameter	Type	Requirement	Values/default
`external_user_id`	string	Optional	Exact operator-side user ID.
`market_id`	positive integer	Optional	Exact market ID.
`status`	string	Optional	`queued`, `processing`, `operator_credit_pending`, `processed`, `failed`, or `manual_review`.
`created_from`	datetime	Optional	Inclusive creation-time lower bound.
`created_to`	datetime	Optional	Inclusive creation-time upper bound.
`sort`	string	Optional	`created_at_desc` (default) or `updated_at_desc`.
`page`	positive integer	Optional	Default `1`.
`page_size`	positive integer	Optional	Default `50`, maximum `100`.

Response highlights

Each item includes:

id
nested run ID, schedule, and status
redeem_request_id
status
shares_micro
credits_equivalent
external_amount_minor
fx_rate_snapshot_id
failure_reason
created_at
updated_at
nested operator user and market summaries

shares_micro is measured in micro-shares. credits_equivalent is Polynion Credits. external_amount_minor is a zero-decimal integer amount in the configured operator currency; do not divide it by an ISO currency exponent.

Notes

redemptions are operator-scoped
redemption credits use redemptionItemId and marketId metadata
orderId is not part of the redemption credit payload
Resolutions are market-level exposure and liability aggregates; Redemptions are individual winning-share payout items

Edit this pageorReport an issue

Error codes

Common error codes returned by the operator-facing API surface.

API keys

Manage operator API keys through the operator API.