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.
`activity_from_date`	date (`YYYY-MM-DD`)	Optional	Inclusive Operator-local activity-date lower bound. Processed items use payout completion time; others use creation time.
`activity_to_date`	date (`YYYY-MM-DD`)	Optional	Inclusive Operator-local upper bound; cutoff is next-day local midnight.
`sort`	string	Optional	`created_at_desc` (default), `updated_at_desc`, or `activity_at_desc`.
`page`	positive integer	Optional	Default `1`.
`page_size`	positive integer	Optional	Default `50`, maximum `100`.

Summary

summary aggregates all filtered items:

redemption_count
redemption_payout_external_amount_minor_total
currency_code
timezone

For status=processed with operator-local activity dates, count and payout match the Opinion monthly settlement redemption totals. Payout prefers actual succeeded wallet-credit amount over stored projected amount. Polyflight uses separate native-IDR statement routes.

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
activity_at
nested operator user and market summaries

shares_micro uses micro-shares. credits_equivalent uses Polynion Credits. external_amount_minor is zero-decimal Operator-currency amount and prefers actual succeeded wallet-credit operation amount over stored projected amount. activity_at is payout completion time for processed items, otherwise creation time.

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.

Polyflight overview

Read operator-scoped native-IDR Polyflight activity and liabilities.