---
title: "GET /api/v4.0/integrations/configurations/widget"
method: GET
path: "/api/v4.0/integrations/configurations/widget"
---

# GET /api/v4.0/integrations/configurations/widget

`GET /api/v4.0/integrations/configurations/widget`

Retrieve styling settings, including colors and other visual elements for the Gameball widget.

## Response `200`

Widget configuration retrieved successfully

- object
  - `colors` object
    - `primary` string
    - `secondary` string
    - `accent` string
    - `background` string
    - `text` string
  - `layout` object
    - `position` 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
    - `size` 'small' | 'medium' | 'large'
    - `showOnMobile` boolean
  - `features` object
    - `showBalance` boolean
    - `showPoints` boolean
    - `showTier` boolean
    - `showNotifications` boolean

## Changes

- **2025-09-30** `788718651767` — 1 info
  - removed the non-success response with the status `400`
- **2025-09-10** `95e7f65e5afd` — 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/configurations/widget/get.md)

---

[API](https://skmtc.dev/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.dev/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gameballers/gameball-api/revisions/747ba4697269/schema)