---
title: "Retrieve the setup"
description: "Whether STOQ's app embed is on in the published theme: status enabled, disabled, or unknown when the theme could not be read, with the theme editor link that turns it on when it is not on. The embed adds the Preorder and"
url: https://docs.stoqapp.com/v2-reference/account-setup/retrieve-the-setup/
api: "API v2 reference"
method: GET
path: "/account/setup"
---

# Retrieve the setup

`GET https://app.stoqapp.com/api/v2/external/account/setup`

Whether STOQ's app embed is on in the published theme: status enabled, disabled, or unknown when the theme could not be read, with the theme editor link that turns it on when it is not on. The embed adds the Preorder and Notify me buttons to the storefront.

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/account/setup" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: the requested resource.

## 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
    }
  ]
}
```