View Claims

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 to retrieve payout history:

Show Request

curl -X GET 'https://api.sandbox.paxos.com/v2/rewards/claims?payout_group_id={payout_group_id}&statuses=CONFIRMED' \
  -H 'Authorization: Bearer {access_token}'

Show Response

{
  "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": ""
}

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.

Get Started

Identity

Travel Rule

Stablecoin Orchestration

Fiat Transfers

Rewards Engine

Address Verification

Stablecoin Payments

Crypto Brokerage

Webhooks

Additional Guides

Versioning

List claims

Claim statuses

Filtering

Next step

Download Statements

​List claims

​Claim statuses

​Filtering

​Next step

Download Statements

List claims

Claim statuses

Filtering

Next step