---
title: "List reward addresses"
method: GET
path: "/rewards/addresses"
tags: ["Reward Addresses"]
---

# List reward addresses

`GET /rewards/addresses`

Returns a paginated list of reward addresses

## Query parameters

- `limit` integer
- `customer_id` string
- `ledger` 'PAXOS' | 'ETHEREUM' | 'SOLANA' | 'INK' | 'XLAYER' | 'ARBITRUM_ONE' | 'ROBINHOOD'
- `address` string
- `order` 'DESC' | 'ASC'
- `page_cursor` string
- `id` string
- `payout_group_id` string
- `include_balance` boolean
- `balance_timestamp` string, date-time
- `asset_type` string
- `onchain_statuses` string[]

## Response `200`

A successful response.

- ListAttributionAddressesResponse
  - `items` AttributionAddress[] — Monitored addresses in this page of results.
    - `customer_id` string
    - `ledger` 'PAXOS' | 'ETHEREUM' | 'SOLANA' | 'INK' | 'XLAYER' | 'ARBITRUM_ONE' | 'ROBINHOOD' — An AttributionLedgerType is a data source which produces events which cause monitored to occur. Examples include blockchains and the Paxos platform. Each event includes a source and/or destination address which will be compared against the addresses configured relative to the same ledger type.
    - `address` string
    - `name` string
    - `created_at` string, date-time
    - `effective_at` string, date-time
    - `id` string
    - `payout_group_id` string
    - `balance` string
    - `status` string — Output only. Registration status (UNREGISTERED, PENDING, ACTIVE, FAILED). Server-managed; ignored on create/update.
    - `asset_type` string — Asset this address is scoped to (e.g. "PYUSD", "USDG").
    - `verification_proof_id` string — Output only. ID of the latest address-ownership proof. Absent when no proof exists.
    - `verification_status` string — Output only. Status of the latest proof (PENDING, APPROVED, EXPIRED). Absent when no proof exists.
    - `verification_method` string — Output only. Method of the latest proof (SIGNATURE, SMALL_DEPOSIT, MANUAL). Absent when no proof exists.
    - `verification_expires_at` string, date-time — Output only. Expiry of the latest proof. Absent when no proof exists.
  - `next_page_cursor` string — Token for the next page of results; empty if no more results.

---

[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/revisions/0687ca8c9a8d/schema)