# Setup status

`GET https://api.tentary.com/v1/setup`

Source: https://tentary.com/de/help/api/get-setup-status/
Area: Konto und Einrichtung
MCP tool: `get_setup_status`. Reads only. Changes nothing in the account.

---

What is still missing before the account can sell.

- Each step has `done` and `required_to_sell`, and the page in the Tentary app that fixes it.
- `ready_to_sell` is `true` when all steps with `required_to_sell` are done.

The answer also lists the legal texts recommended for the country of the account, what buyers can do with the tax settings, and warnings about the shop page and Stripe.

## Authorization

`Authorization: Bearer <API key>`

A personal API key (tnt_...). Create it in the Tentary app on the page AI & API.

## Response

- `ready_to_sell` (boolean): true = all steps with required_to_sell are done.
- `steps` (array of object): The setup steps, in order.
  - `key` (string): A short fixed name. Allowed values: `confirm_email`, `billing_address`, `payment_provider`, `legal_texts`, `first_product`, `product_live`, `plan`.
  - `title` (string): The title.
  - `done` (boolean): true = done.
  - `required_to_sell` (boolean): true = checkout does not work without it.
  - `url` (string<uri>): The page that fixes it.
  - `providers` (array of object, can be missing): payment_provider only.
    - `name` (string): The name. Allowed values: `Stripe`, `PayPal`, `Mollie`.
    - `status` (string): The status. Allowed values: `connected`, `setup_not_finished`, `pending`, `not_connected`.
    - `used_at_checkout` (boolean): true = checkout takes payments with this provider now.
  - `country` (string, can be missing): legal_texts only: the seller country.
  - `items` (array of object, can be missing): legal_texts only: the recommended documents.
    - `name` (string): The name.
    - `done` (boolean): true = done.
- `tax_capability` (string): What buyers can do with the tax settings. Allowed values: `full`, `no_eu_business_buyers`, `consumers_only_no_invoices`.
- `warnings` (array of object): Things that the seller should know.
  - `key` (string): A short fixed name. Allowed values: `tax`, `shop_page`, `subscriptions_need_stripe`, `stripe`.
  - `text` (string): The text.
  - `url` (string<uri>): The link.
- `links` (object): Pages in the Tentary app or on tentary.com.
  - `dashboard` (string<uri>): Page in the Tentary app.

## Example request

```bash
curl "https://api.tentary.com/v1/setup" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

## Example response

```json
{
  "ready_to_sell": true,
  "steps": [
    {
      "key": "confirm_email",
      "title": "Confirm the e-mail address of the account",
      "done": true,
      "required_to_sell": false,
      "url": "https://app.tentary.com/dashboard"
    },
    {
      "key": "billing_address",
      "title": "Add the billing address (needed for invoices and legal texts)",
      "done": true,
      "required_to_sell": false,
      "url": "https://app.tentary.com/settings/invoices/edit"
    },
    {
      "key": "payment_provider",
      "title": "Connect a payment provider that checkout uses",
      "done": true,
      "required_to_sell": true,
      "url": "https://app.tentary.com/settings/payments",
      "providers": [
        {
          "name": "Stripe",
          "status": "connected",
          "used_at_checkout": true
        },
        {
          "name": "PayPal",
          "status": "connected",
          "used_at_checkout": true
        },
        {
          "name": "Mollie",
          "status": "not_connected",
          "used_at_checkout": false
        }
      ]
    },
    {
      "key": "legal_texts",
      "title": "Add the legal texts recommended for the seller country",
      "done": true,
      "required_to_sell": false,
      "url": "https://app.tentary.com/settings/legal",
      "country": "DE",
      "items": [
        {
          "name": "Terms of service",
          "done": true
        },
        {
          "name": "Cancellation policy",
          "done": true
        },
        {
          "name": "Privacy policy",
          "done": true
        },
        {
          "name": "Legal notice (Impressum)",
          "done": true
        },
        {
          "name": "Terms attached to order e-mails",
          "done": true
        }
      ]
    },
    {
      "key": "first_product",
      "title": "Create a product",
      "done": true,
      "required_to_sell": false,
      "url": "https://app.tentary.com/products/new"
    },
    {
      "key": "product_live",
      "title": "Publish a product that checkout can sell (status live)",
      "done": true,
      "required_to_sell": true,
      "url": "https://app.tentary.com/products"
    },
    {
      "key": "plan",
      "title": "Choose a Tentary plan (without an active plan, checkout is off)",
      "done": true,
      "required_to_sell": true,
      "url": "https://app.tentary.com/settings/user/subscription"
    }
  ],
  "tax_capability": "full",
  "warnings": [],
  "links": {
    "dashboard": "https://app.tentary.com/dashboard"
  }
}
```