---
title: "List Rewards Statements"
method: GET
path: "/rewards/statements"
tags: ["Rewards Statements"]
---

# List Rewards Statements

`GET /rewards/statements`

Returns monthly rewards statements for the authenticated partner, ordered by
period newest first. Summary fields (total_accrued, avg_daily_balance) are
included in list responses. Presigned download URLs are populated on files
for completed statements only.

## Query parameters

- `limit` integer
- `page_cursor` string
- `asset_type` string
- `type` 'STATEMENT_TYPE_MONTHLY_REWARDS'

## Response `200`

A successful response.

- ListRewardsStatementsResponse
  - `items` RewardsStatement[] — Statements for this page, ordered by period_start descending (newest first).
    - `id` string — UUID of this statement record.
    - `asset_type` string — Asset type (e.g. "USDG", "PYUSD").
    - `period_start` string, date-time — Start of the statement period (inclusive, beginning of month, UTC).
    - `period_end` string, date-time — End of the statement period (inclusive, end of month, UTC).
    - `status` 'STATEMENT_STATUS_GENERATING' | 'STATEMENT_STATUS_COMPLETED' | 'STATEMENT_STATUS_FAILED' — RewardsStatementStatus reflects the overall generation lifecycle of a reward statement. - STATEMENT_STATUS_GENERATING: Files are currently being generated. - STATEMENT_STATUS_COMPLETED: All files were successfully generated and are available for download. - STATEMENT_STATUS_FAILED: Generation failed; files may be incomplete or unavailable.
    - `type` 'STATEMENT_TYPE_MONTHLY_REWARDS' — RewardsStatementType identifies the content and purpose of a reward statement. - STATEMENT_TYPE_MONTHLY_REWARDS: Monthly statement: PDF rewards summary with daily balance totals, rates, and per-payout-group breakdown, plus a CSV per-wallet daily balance export.
    - `total_accrued` string — Total rewards accrued over the period across all payout groups.
    - `avg_daily_balance` string — Average end-of-day balance across all payout groups and all days in the period.
    - `files` RewardsStatementFile[] — Generated files (PDF, CSV). download_url is populated for completed statements in both list and get responses.
      - `format` 'STATEMENT_FORMAT_PDF' | 'STATEMENT_FORMAT_CSV' — RewardsStatementFormat identifies the file encoding of a generated statement file. - STATEMENT_FORMAT_PDF: PDF report suitable for printing or archival. - STATEMENT_FORMAT_CSV: CSV with per-wallet daily balance rows.
      - `download_url` string — Presigned S3 download URL. Populated for completed statements in both list and get responses.
      - `generated_at` string, date-time — When the file was written to S3.
    - `created_at` string, date-time — When this statement record was created.
  - `next_page_cursor` string — Cursor for the next page; empty string if this is the last page.

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/versions/0687ca8c9a8d/schema)