---
title: "Get developer settings"
description: "The preorder developer settings: dev mode, the custom CSS, and the theme CSS selectors that place the Preorder button and each preorder element on product pages and on the home, collection and search product lists. Shop-"
url: https://docs.stoqapp.com/v2-reference/preorders-settings/get-developer-settings/
api: "API v2 reference"
method: GET
path: "/preorders/settings/developer"
---

# Get developer settings

`GET https://app.stoqapp.com/api/v2/external/preorders/settings/developer`

The preorder developer settings: dev mode, the custom CSS, and the theme CSS selectors that place the Preorder button and each preorder element on product pages and on the home, collection and search product lists. Shop-wide, not per offer. The selectors are used only while dev mode is on. Dev mode and CSS are shared with back-in-stock.

**Note:** Change them with [`PATCH /preorders/settings/developer`](https://docs.stoqapp.com/v2-reference/preorders-settings/update-developer-settings/). A null selector means none is set for that element, so the theme default applies. Each insert_type is beforebegin, afterbegin, beforeend or afterend. dev_mode_enabled and css are the same values as placement.merchant_managed_position and custom.css on [`GET /back_in_stock/settings/widget`](https://docs.stoqapp.com/v2-reference/back-in-stock-settings/get-widget-settings/), so a change on either side shows on both.

## Returns

- `dev_mode_enabled` (boolean): e.g. `true`
- `css` (null)
- `product_page` (object)
  - `form` (string): e.g. `string`
  - `add_to_cart_button` (null)
  - `add_to_cart_text` (string): e.g. `string`
  - `original_price` (null)
- `insertion_points` (object)
  - `disclaimer` (object)
    - `selector` (null)
    - `insert_type` (string): e.g. `string`
  - `payment_options` (object)
    - `selector` (null)
    - `insert_type` (string): e.g. `string`
  - `terms` (object)
    - `selector` (null)
    - `insert_type` (string): e.g. `string`
  - `badge` (object)
    - `selector` (string, nullable): e.g. `string`
    - `insert_type` (string): e.g. `string`
  - `discounted_price` (object)
    - `selector` (null)
    - `insert_type` (string): e.g. `string`
  - `countdown_timer` (object)
    - `selector` (null)
    - `insert_type` (string): e.g. `string`
  - `progress_bar` (object)
    - `selector` (null)
    - `insert_type` (string): e.g. `string`
- `collection` (object)
  - `form` (string): e.g. `string`
  - `add_to_cart_button` (string): e.g. `string`
  - `badge` (null)
  - `badge_insert_type` (string): e.g. `string`
- `home` (object)
  - `form` (string): e.g. `string`
  - `add_to_cart_button` (string): e.g. `string`
  - `badge` (null)
- `search` (object)
  - `form` (string): e.g. `string`
  - `add_to_cart_button` (string): e.g. `string`
  - `badge` (null)

Rate limit: this call costs 1 point ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl "https://app.stoqapp.com/api/v2/external/preorders/settings/developer" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: the requested resource.

```json
{
  "dev_mode_enabled": true,
  "css": null,
  "product_page": {
    "form": "string",
    "add_to_cart_button": null,
    "add_to_cart_text": "string",
    "original_price": null
  },
  "insertion_points": {
    "disclaimer": {
      "selector": null,
      "insert_type": "string"
    },
    "payment_options": {
      "selector": null,
      "insert_type": "string"
    },
    "terms": {
      "selector": null,
      "insert_type": "string"
    },
    "badge": {
      "selector": "string",
      "insert_type": "string"
    },
    "discounted_price": {
      "selector": null,
      "insert_type": "string"
    },
    "countdown_timer": {
      "selector": null,
      "insert_type": "string"
    },
    "progress_bar": {
      "selector": null,
      "insert_type": "string"
    }
  },
  "collection": {
    "form": "string",
    "add_to_cart_button": "string",
    "badge": null,
    "badge_insert_type": "string"
  },
  "home": {
    "form": "string",
    "add_to_cart_button": "string",
    "badge": null
  },
  "search": {
    "form": "string",
    "add_to_cart_button": "string",
    "badge": null
  }
}
```

## 401

Missing or invalid `X-Auth-Token`.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "auth_invalid",
  "details": [
    {
      "code": "auth_invalid",
      "message": "Invalid API key",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 422

The request failed validation.

```json
{
  "errors": [
    "name is required"
  ],
  "code": "validation_failed",
  "details": [
    {
      "code": "validation_failed",
      "message": "name is required",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 429

Rate limited: cost-weighted per token (read 1, write 2; 360 points / 60s). Check `Retry-After`.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited",
  "details": [
    {
      "code": "rate_limited",
      "message": "Rate limit exceeded",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

