---
title: "Get user payout history"
method: GET
path: "/v2/client/redeem-rewards/history"
tags: ["Internal"]
---

# Get user payout history

`GET /v2/client/redeem-rewards/history`

Get User Payout History returns the payout history of the user.

## Response `200`

OK

- object
  - `data` UserPayoutRequestHistoryV2
    - `items` UserPayoutRequestHistoryItemV2[], required
      - `id` integer, required — The unique identifier for the payout, used for routing to payout details page.
      - `reward_amount` string, required
      - `reward_name` string, required
      - `image_url` string, required
      - `categories` string[], required
      - `created_at` string, required — The date the user payout request is created.
      - `status` 'pending' | 'completed' | 'cancelled' | 'failed', required — Status of the payout request: - `pending`: The payout is pending processing or review - `completed`: The payout has been successfully completed - `cancelled`: The payout was cancelled/refunded - `failed`: The payout failed after retries (e.g., processor error, max attempts reached)
      - `amount` string, required
      - `status_updated_at` string — The timestamp of the payout request was last updated.
      - `estimated_delivery` integer — The estimated delivery time in seconds for the payout to be completed
      - `currency` string — The currency of the redemption (e.g., USD, EUR).
      - `credentials` UserPayoutRequestHistoryCredentialsItem[], required
        - `label` string, required
        - `value` string, required
        - `type` 'text' | 'url' | 'barcode' | 'date', required
        - `credential_type` string, required
      - `redemption_instructions` string, required — Redemption instructions provided by the gift card provider.

## Other responses

- `404` — User history not found

---

[API](https://skmtc.net/bitlabs/apis/bitlabs-client-api.md) · [All operations](https://skmtc.net/bitlabs/apis/bitlabs-client-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitlabs/bitlabs-client-api/versions/99209a6285bf/schema)