List Widget Styles

Returns the styling presets owned by the current node and its descendants. Each preset can be referenced by id when initializing the v2 payment widget.

Authentication: Bearer token required.

Endpoint: GET /api/v2/widget-styles

---

Query Parameters

Parameter	Type	Required	Default	Description
page	int	No	1	Page number
per_page	int	No	10	Items per page (max 100)

---

Response — 200 OK

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "node_id": "550e8400-e29b-41d4-a716-446655440100",
      "name": "Brand light",
      "primary_color": "#3b82f6",
      "secondary_color": "#6b7280",
      "background_color": "#ffffff",
      "surface_color": "#f9fafb",
      "text_color": "#111827",
      "muted_text_color": "#6b7280",
      "border_color": "#e5e7eb",
      "font_family": "system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif",
      "font_size_base": 14,
      "font_size_heading": 20,
      "font_weight_heading": 600,
      "border_radius": 12,
      "custom_css": "",
      "created_at": "2026-04-25T10:00:00Z",
      "updated_at": "2026-04-25T10:00:00Z"
    }
  ],
  "page": 1,
  "per_page": 10,
  "total": 1
}

Status	Description
401	Unauthorized (missing or invalid token)
403	No access to current node