> ## 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.

# View Claims

> Track reward payout history and monitor claim status.

Claims are the on-chain payout events generated by your claim schedules. Rewards accrue daily (compounding) regardless of the claim schedule. At the scheduled frequency and time, the Rewards Engine creates a claim for each payout group and submits it according to the schedule you configured.

> **Required scope:** `rewards:read_claims`

## List claims

Use [List Claims](/api-reference/endpoints/claims/list-claims) to retrieve payout history:

<Expandable title="Request">
  ```bash theme={null}
  curl -X GET 'https://api.sandbox.paxos.com/v2/rewards/claims?payout_group_id={payout_group_id}&statuses=CONFIRMED' \
    -H 'Authorization: Bearer {access_token}'
  ```
</Expandable>

<Expandable title="Response">
  ```json highlight={4,5,6,7} theme={null}
  {
    "items": [
      {
        "id": "{claim_id}",
        "payout_group_id": "{payout_group_id}",
        "amount": "42.75",
        "tx_hash": "0xdeadbeef...",
        "blockchain": "ETHEREUM",
        "asset_type": "USDG",
        "confirmed_at": "2024-01-15T02:30:00Z",
        "created_at": "2024-01-15T01:00:00Z"
      }
    ],
    "next_page_cursor": ""
  }
  ```
</Expandable>

## Claim statuses

| Status      | Description                                     |
| ----------- | ----------------------------------------------- |
| `PENDING`   | Claim created; awaiting on-chain submission     |
| `SUBMITTED` | Transaction broadcast to the network            |
| `CONFIRMED` | Transaction confirmed on-chain; payout complete |
| `FAILED`    | Claim failed; check `error_message` for details |

## Filtering

The list endpoint supports several filters for reconciliation and reporting:

| Parameter                 | Description                                             |
| ------------------------- | ------------------------------------------------------- |
| `payout_group_id`         | Filter to a specific payout group                       |
| `statuses`                | Filter by one or more claim statuses                    |
| `start_time` / `end_time` | Filter by creation time range for period reconciliation |
| `asset_type`              | Filter to a specific stablecoin                         |
| `chain`                   | Filter to a specific blockchain                         |

> Use `start_time` and `end_time` together to reconcile payouts against a specific accounting period.

## Next step

<Card title="Download Statements" icon="file-arrow-down" href="/guides/developer/rewards-engine/download-statements">
  Access monthly reward statements in PDF and CSV format
</Card>
