> Documentation index: https://docs.sellhidden.com/llms.txt

# Store

Source: https://docs.sellhidden.com/reference/store

Your store as its seller sees it, and the basic settings. Themes, payment methods, payouts and domains stay in the dashboard.

## Endpoints

2 endpoints · [store:read](https://docs.sellhidden.com/start?scope=store%3Aread#scopes) · [store:write](https://docs.sellhidden.com/start?scope=store%3Awrite#scopes)

Base URL https://api.sellhidden.com/v1 · Authorization: Bearer · 120/min per key · cursor pagination · Idempotency-Key on POST · No test mode

### GET /store — Get the store

Scope `store:read`.

```bash
curl https://api.sellhidden.com/v1/store \
  -H "Authorization: Bearer hsk_live_…"
```

Response (200):

```json
{ "ok": true, "store": { "id": "clx…", "slug": "my-store", "name": "My Store", "url": "https://my-store.sellhidden.com", "plan": "pro", "balanceUsd": 1240.5, "feeBornBy": "seller", "support": { "email": "help@example.com", "discord": null, "telegram": null }, "settings": { "maintenanceMode": false, "hideOutOfStock": false, … }, … } }
```

### PATCH /store — Update basic settings

Only the fields you send change. Scope `store:write`.

**Body**

| Body | Type | Description |
| --- | --- | --- |
| `name` | string | 2-80 characters. |
| `description` | string | Up to 500 characters. |
| `logoUrl` | string \| null |  |
| `bannerUrl` | string \| null |  |
| `supportEmail` | string \| null |  |
| `supportDiscord` | string \| null | Invite URL. |
| `supportTelegram` | string \| null |  |
| `maintenanceMode` | boolean | Closes the storefront to buyers. |
| `hideOutOfStock` | boolean |  |
| `showStockCount` | boolean |  |
| `showStats` | boolean |  |
| `recentSalesWidget` | boolean | Live sale notifications toggle. |
| `liveSalesCorner` | string | bottom-left \| bottom-right \| top-left \| top-right (default bottom-left). |
| `autoReviews` | boolean |  |
| `autoCurrency` | boolean | Deprecated; use currencyMode ("auto"). |
| `currencyMode` | usd \| fixed \| auto | Default display currency: USD, a fixed one you pick, or the currency of the buyer's location. |
| `defaultCurrency` | string | ISO 4217 code used when currencyMode is "fixed". |
| `showCurrencyPicker` | boolean | False hides the currency picker everywhere and the shop stays in USD. |
| `feeBornBy` | seller \| customer | Who would pay a platform fee. Every plan has a 0% platform fee, so this has no effect today. |
| `productsPerPage` | 4..48 |  |
| `subscriptionReminderDays` | 1..14 | Days before a renewal the reminder email goes out. |
| `subscriptionGraceDays` | 0..3 | Days a buyer keeps access after a missed renewal. |

```bash
curl -X PATCH https://api.sellhidden.com/v1/store \
  -H "Authorization: Bearer hsk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"maintenanceMode":true}'
```