> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paxos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List reward addresses

> Returns a paginated list of reward addresses

```bash OAuth Scope theme={null}
rewards:read_monitoring_address
```


## OpenAPI

````yaml get /rewards/addresses
openapi: 3.0.0
info:
  title: Paxos Rewards API
  version: v2-preview
servers: []
security: []
paths:
  /rewards/addresses:
    get:
      tags:
        - Reward Addresses
      summary: List reward addresses
      description: Returns a paginated list of reward addresses
      operationId: ListAttributionAddresses
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
        - name: ledger
          in: query
          required: false
          schema:
            type: string
            enum:
              - ETHEREUM
              - SOLANA
              - INK
              - XLAYER
              - ARBITRUM_ONE
        - name: address
          in: query
          required: false
          schema:
            type: string
        - name: order
          description: >-
            Optional, sort order for results based on created_at. The default
            sort order is DESC.
          in: query
          required: false
          schema:
            type: string
            enum:
              - DESC
              - ASC
        - name: page_cursor
          description: Optional, cursor token for fetching the next page.
          in: query
          required: false
          schema:
            type: string
        - name: id
          description: Optional, address id.
          in: query
          required: false
          schema:
            type: string
        - name: payout_group_id
          description: Optional, filter by payout group.
          in: query
          required: false
          schema:
            type: string
        - name: include_balance
          description: When true, fetch and include balance for each address.
          in: query
          required: false
          schema:
            type: boolean
        - name: balance_timestamp
          description: Point-in-time for balance query (optional, defaults to now).
          in: query
          required: false
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAttributionAddressesResponse'
      security:
        - OAuth2:
            - rewards:read_monitoring_address
components:
  schemas:
    ListAttributionAddressesResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AttributionAddress'
          description: Monitored addresses in this page of results.
        next_page_cursor:
          type: string
          description: Token for the next page of results; empty if no more results.
    AttributionAddress:
      type: object
      title: All data associated with an attribution address
      properties:
        id:
          type: string
          readOnly: true
          description: Address ID. Auto-generated.
        ledger:
          $ref: '#/components/schemas/AttributionLedgerType'
        address:
          type: string
        name:
          type: string
        payout_group_id:
          type: string
          description: UUID of the payout group this address belongs to.
        balance:
          type: string
          readOnly: true
          description: >-
            Total custody at address. Only populated when include_balance=true
            in request.
        status:
          type: string
          readOnly: true
          description: >-
            Output only. Registration status (UNREGISTERED, PENDING, ACTIVE,
            FAILED). Server-managed.
        created_at:
          type: string
          format: date-time
          readOnly: true
    AttributionLedgerType:
      type: string
      enum:
        - ETHEREUM
        - SOLANA
        - INK
        - XLAYER
        - ARBITRUM_ONE
      example: ETHEREUM
      description: >-
        An AttributionLedgerType is a data source which produces events which
        cause monitoring to occur. Examples include blockchains and the Paxos
        platform.
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://oauth.paxos.com/oauth2/token
          scopes:
            rewards:read_monitoring_address: Read reward addresses
            rewards:write_monitoring_address: Create and manage reward addresses
            rewards:read_claims_schedule: Read claim schedules
            rewards:write_claims_schedule: Create and manage claim schedules
            rewards:read_claims: Read claims
            rewards:read_payout_groups: Read payout groups
            rewards:write_payout_groups: Create and manage payout groups
            rewards:read_rewards_details: Read reward details

````