---
title: "Get user rewards"
method: GET
path: "/api/rewards"
tags: ["Rewards"]
---

# Get user rewards

`GET /api/rewards`

Retrieve rewards for the authenticated user with optional filtering

## Query parameters

- `status` 'assigned' | 'sending' | 'success' | 'rejected' | 'unassigned' | 'pending' | 'available' | 'claimed' | 'successful' | 'failed' | 'confirmed'
- `limit` string
- `offset` string

## Response `200`

List of rewards

- object
  - `ok` boolean
  - `data` object[]
    - `id` string, uuid, required — Reward ID
    - `campaign_id` string, uuid, required — Campaign ID
    - `campaign_key` string, uuid, nullable — Campaign Key ID
    - `user` string, address, nullable, required — User address assigned to this reward
    - `status` 'unassigned' | 'pending' | 'assigned' | 'sending' | 'success' | 'rejected' | 'confirmed' | 'available' | 'claimed' | 'successful' | 'failed', required — Reward delivery status
    - `chain_id` '1' | '3' | '4' | '5' | '42' | '137' | '80001' | '80002' | '11155111', required — Blockchain chain ID
    - `transaction_hash` string, nullable — Hash of the transaction in which the reward was sent
    - `block_number` integer, nullable — Block number of the transaction
    - `airdrop_type` 'None' | 'ERC20Transfer' | 'ERC721Mint' | 'ERC721Transfer' | 'ERC721Kitty' | 'CollectionV2IssueToken', required — Delivery strategy for the reward
    - `target` string, address, required — Target contract for the reward
    - `value` string, required — Value in the contract for the reward
    - `priority` number — Assignment priority for the reward
    - `group` string, nullable — Assignment group for the reward
    - `token` string, required — Human-readable name for the reward
    - `image` string, uri, nullable — Image that visually represents this reward
    - `rarity` 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary' | 'mythic' | 'unique' — Item rarity
    - `category` 'eyebrows' | 'eyes' | 'facial_hair' | 'hair' | 'mouth' | 'upper_body' | 'lower_body' | 'feet' | 'earring' | 'eyewear' | 'hat' | 'helmet' | 'mask' | 'tiara' | 'top_head' | 'dance' | 'stunt' | 'greeting' | 'fun' | 'poses' | 'reactions' | 'horror' | 'miscellaneous' — Item category
    - `from_referral` string, address, nullable — Address of the user who referred this reward
    - `payload` string, nullable — Transaction payload (L1 only)
    - `signature` string, nullable — Transaction signature (L1 only)
    - `expires_at` string, date-time, nullable — Reward expiration time (L1 only)
    - `created_at` string, date-time, required — The time the reward was created
    - `updated_at` string, date-time, required — The time the reward was last updated
    - `assigned_at` string, date-time, nullable — The time the reward was assigned
  - `total` number — Total number of rewards matching the filter

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)