---
updatedAt: 2026-09-08T21:22:37.000Z
agentTools:
  siteIndex: https://docs.recurly.com/llms.txt
  projectIndex: https://docs.recurly.com/recurly-commerce/llms.txt
---

# /stores/{storeUrl}/settings

Get the theme for a given store

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "paths": {
    "/stores/{storeUrl}/settings": {
      "get": {
        "operationId": "StoresController_getStoreSettings",
        "summary": "",
        "description": "Get the theme for a given store",
        "parameters": [
          {
            "name": "storeUrl",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "themeId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved store theme",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreSettingDto"
                }
              }
            }
          }
        },
        "tags": [
          "Prive Widget API"
        ]
      }
    }
  },
  "info": {
    "title": "Prive Widget Documentation",
    "description": "Prive Widget Documentation",
    "version": "1.3",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://subs.api.tryprive.com"
    }
  ],
  "components": {
    "schemas": {
      "TextStyleDto": {
        "type": "object",
        "properties": {
          "color": {
            "type": "string"
          },
          "fontSize": {
            "type": "string"
          },
          "fontWeight": {
            "type": "string"
          }
        },
        "required": [
          "color",
          "fontSize",
          "fontWeight"
        ]
      },
      "StylingDto": {
        "type": "object",
        "properties": {
          "purchaseOptionsStyle": {
            "$ref": "#/components/schemas/TextStyleDto"
          },
          "deliveryEveryStyle": {
            "description": "custom CSS for the delivery frequency options",
            "allOf": [
              {
                "$ref": "#/components/schemas/TextStyleDto"
              }
            ]
          },
          "quantityStyle": {
            "description": "Style for the quantity selector",
            "allOf": [
              {
                "$ref": "#/components/schemas/TextStyleDto"
              }
            ]
          },
          "selectedOptionsStyle": {
            "description": "Styles for the text area",
            "allOf": [
              {
                "$ref": "#/components/schemas/TextStyleDto"
              }
            ]
          },
          "accentColor": {
            "type": "string",
            "description": "Radio button colors"
          },
          "bgColor": {
            "type": "string",
            "description": "The background color for the widget elements"
          },
          "bgColorOnSelection": {
            "type": "string",
            "description": "Color for the product variant selection box"
          },
          "borders": {
            "type": "object",
            "description": "The border properties for the widget elements"
          }
        },
        "required": [
          "purchaseOptionsStyle",
          "deliveryEveryStyle",
          "quantityStyle",
          "selectedOptionsStyle",
          "accentColor",
          "bgColor",
          "bgColorOnSelection",
          "borders"
        ]
      },
      "RankDto": {
        "type": "object",
        "properties": {
          "prepay": {
            "type": "number"
          },
          "onetime": {
            "type": "number"
          },
          "subscribe": {
            "type": "number"
          }
        },
        "required": [
          "prepay",
          "onetime",
          "subscribe"
        ]
      },
      "WidgetSettingDto": {
        "type": "object",
        "properties": {
          "elements": {
            "type": "object",
            "description": "The customized css selector for elements"
          },
          "customCss": {
            "type": "string",
            "description": "The customized css styling for elements"
          },
          "onetimeFirst": {
            "type": "boolean",
            "description": "Whether the One-Time purchase should show up first, relative to the other offer options position"
          },
          "onetimeCopy": {
            "type": "string",
            "description": "The text for the One-Time Purchase option title"
          },
          "subscribeCopy": {
            "type": "string",
            "description": "The text for the Subscription Offer option title"
          },
          "prepaidCopy": {
            "type": "string",
            "description": "The text for the Prepaid Offer option title"
          },
          "subOptionCopy": {
            "type": "string"
          },
          "styling": {
            "description": "Styling for the widget",
            "allOf": [
              {
                "$ref": "#/components/schemas/StylingDto"
              }
            ]
          },
          "moneyFormatWithCurrency": {
            "type": "string"
          },
          "rank": {
            "description": "Order for the subscription offer options",
            "allOf": [
              {
                "$ref": "#/components/schemas/RankDto"
              }
            ]
          }
        },
        "required": [
          "elements",
          "customCss",
          "onetimeFirst",
          "onetimeCopy",
          "subscribeCopy",
          "prepaidCopy",
          "subOptionCopy",
          "styling",
          "moneyFormatWithCurrency",
          "rank"
        ]
      },
      "StoreSettingDto": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "description": "The currency used for the store"
          },
          "money_format": {
            "type": "string",
            "description": "The price format"
          },
          "multilocation": {
            "type": "boolean",
            "description": "You can set up multiple locations in your Shopify store so that you can track inventory and fulfill orders at your locations."
          },
          "widget_settings": {
            "description": "The Prive widget setting",
            "allOf": [
              {
                "$ref": "#/components/schemas/WidgetSettingDto"
              }
            ]
          }
        },
        "required": [
          "currency",
          "money_format",
          "multilocation",
          "widget_settings"
        ]
      }
    }
  }
}
```

# Sibling pages

* [/stores/{storeUrl}/products/{productId}/new](https://docs.recurly.com/recurly-commerce/reference/storescontroller_getdatanew.md)
* [/stores/{storeUrl}/shopperPortalSettings](https://docs.recurly.com/recurly-commerce/reference/storescontroller_getshopperportalsettings.md)