---
title: "Get app settings v2"
method: GET
path: "/v1/client/settings/v2"
tags: ["Internal"]
---

# Get app settings v2

`GET /v1/client/settings/v2`

Get App Settings V2 returns the settings of the app.

## Query parameters

- `color_scheme` 'LIGHT' | 'DARK'

## Response `200`

OK

- object
  - `data` AppSettingsV2
    - `currency` AppSettingsV2Currency, required
      - `floor_decimal` boolean, required
      - `factor` string, required
      - `symbol` AppSettingsV2CurrencySymbol, required
        - `content` string, required
        - `is_image` boolean, required
      - `currency_promotion` integer
      - `bonus_percentage` integer, required
      - `name` string, required
    - `logic` AppSettingsV2Logic, required
      - `mode` 'API' | 'OFFERWALL' | 'ROUTER_LINK', required
      - `privacy_enabled` boolean, required
      - `skip_question_enabled` boolean, required
      - `header_navigation_visible` boolean, required
      - `watermark_visible` boolean, required
      - `survey_bonus_enabled` boolean, required
      - `demo_mode_enabled` boolean, required
      - `survey_opening_target` 'OPENING_TARGET_NONE' | 'OPENING_TARGET_NEW_TAB' | 'OPENING_TARGET_SAME_TAB' | 'OPENING_TARGET_PARENT' | 'OPENING_TARGET_AUTOMATIC', required
      - `survey_complete_target` 'COMPLETE_TARGET_CLOSE_TAB' | 'COMPLETE_TARGET_NEW_SURVEY' | 'COMPLETE_TARGET_URL', required
      - `first_qualification` AppSettingsV2FirstQualification, required
        - `start_bonus` string, required
        - `show` boolean, required
      - `survey_complete_target_url` string, required
      - `survey_bonus_percentage` integer, required
      - `default_tab` 'TAB_SURVEYS' | 'TAB_OFFERS' | 'TAB_GAMING' | 'TAB_MAGIC_RECEIPTS', required
      - `enabled_widgets` string[], required
    - `visual` AppSettingsV2Visual, required
      - `element_border_radius` 'BORDER_RADIUS_NONE' | 'BORDER_RADIUS_SMALL' | 'BORDER_RADIUS_MEDIUM' | 'BORDER_RADIUS_BIG', required
      - `custom_logo_url` string, required
      - `screenout_reward` string, required
      - `navigation_color` string, required
      - `background_color` string, required
      - `interaction_color` string, required
      - `survey_icon_color` string, required
      - `color_rating_threshold` integer, required
      - `offerwall_width` string, required
      - `hide_reward_value` boolean, required
      - `show_cross_tab_offers` boolean, required
    - `promotion` AppSettingsV2Promotion
      - `start_date` string, date-time, required — The start date of the promotion. Can be in the future to signal a scheduled promotion.
      - `end_date` string, date-time, required — The end date of the promotion. It is inclusive, meaning that the promotion is active for the full given day.
      - `bonus_percentage` integer, required
    - `offers` AppSettingsV2Offers, required
      - `enabled` boolean, required
      - `offer_blacklist` string[], required
    - `publisher` AppSettingsV2Publisher, required
      - `is_key_partner` boolean, required
      - `name` string, required
    - `chatbot_config` AppSettingsChatbotConfig
      - `id` string, required
      - `background` string, required
      - `ref` integer, required
    - `magic_receipts` AppSettingsV2MagicReceipts, required
      - `enabled` boolean, required
      - `test_mode` boolean, required
      - `enabled_countries` string[], required
    - `auths` AppSettingsV2Auths, required
      - `custom_fields` AppSettingsV2CustomField[], required
        - `id` string, required
        - `data_type` 'STRING' | 'INTEGER' | 'DATE', required
        - `validation_exp` string, required
        - `validation_is_unique` boolean — When true, the value must be unique across the app; only one user can have that value for this custom field.
        - `title` object, required
        - `description` object, required
        - `placeholder` object, required
        - `format_example` object, required
      - `enabled` boolean, required
    - `gaming` AppSettingsV2Gaming, required
      - `enabled` boolean, required
    - `user_balance` AppSettingsV2UserBalance, required
      - `enabled` boolean, required
    - `landing_page` AppSettingsV2LandingPage, required
      - `enabled` boolean, required
      - `hero_image_url` string, required
      - `explore_image_url` string, required
    - `loyalty` AppSettingsV2Loyalty, required
      - `program_name` string, required

## Other responses

- `406` — VPN detected

---

[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)