---
title: "Spin the wheel for the welcome bonus reward if available"
method: POST
path: "/v1/client/promotions/welcome-bonus/wheel-spin"
tags: ["User"]
---

# Spin the wheel for the welcome bonus reward if available

`POST /v1/client/promotions/welcome-bonus/wheel-spin`

## Request

- Base URL: `https://api.bitlabs.ai`
- URL: `https://api.bitlabs.ai/v1/client/promotions/welcome-bonus/wheel-spin`
- Auth: one of:
  - API key in header `X-Api-Token` and API key in header `X-User-Id`
  - API key in query parameter `token` and API key in query parameter `uid`
  - HTTP bearer

Spin the user's wheel for a welcome bonus reward if available

## Response `200`

OK

- object
  - `data` WelcomeBonusSpinWheelResponse: Response from spinning the promotion wheel
    - `prize` WelcomeBonusWheelPrize, required: A reward available in the spin wheel
      - `type` 'FLAT_AMOUNT' | 'PERCENTAGE', required: The type of reward
      - `weight` number, float, required: The weight of the reward; between 0 and 1
      - `prize_data` number, float, required

---

[API](https://skmtc.dev/bitlabs/apis/bitlabs-client-api.md) - [All operations](https://skmtc.dev/bitlabs/apis/bitlabs-client-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bitlabs/apis/bitlabs-client-api/revisions/6208ec85dda5?raw)