Polyflight settlement reports

Required scope: polyflight_settlements:read.

Paths

GET /api/operator/polyflight/settlement-reports
GET /api/operator/polyflight/settlement-reports/{id}
GET /api/operator/polyflight/settlement-reports/export
GET /api/operator/polyflight/settlement-reports/payments
GET /api/operator/polyflight/settlement-reports/{id}/payments
GET /api/operator/polyflight/settlement-reports/{id}/export

Statement IDs are UUIDs and every resource is constrained by the authenticated operator. All responses are private, no-store.

The list accepts page and page_size (default 50, maximum 200). A statement exposes its operator/local month/timezone and UTC bounds; event digest/watermark; separate fee and signed-position allocation; cashClearing with confirmed receiptsMinor, outflowsMinor, and signed netMinor; both party entitlements; opening/closing liabilities; prior balance, payments and adjustments; settlement net/direction/amount; terms breakdown; daily rows; and result-processing watermark. Aggregate money fields are decimal strings.

Final statement fields also include id, revisionIdentity, statementDigest, signatureVersion, signerKeyVersion, signature, finalizer/reason/time. See Terms, statements, and settlement for recognition, carry, direction, and signature guidance.

cashClearing is reconciliation evidence, not another fee or position allocation. Confirmed wallet receipts/outflows must not be recognized as earnings a second time.

/payments returns all immutable operator payment/correction history; /{id}/payments restricts it to one statement. Operators cannot record, reverse, finalize, or adjust through these routes.

List export returns all finalized statements. Detail export returns the exact canonical statement plus its payments. Exports are CSV by default; ?format=json returns canonical JSON.

Playground: /api-playground/polyflight?request=polyflight-settlement-reports.