# Hostingsurge Shops API

**Canonical:** https://apis.io/apis/hostingsurge-com/hostingsurge-com-shops-api/  
**Provider:** Hostingsurge — https://apis.io/providers/hostingsurge-com/  
**Base URL:** https://hostingsurge.com/api/v1  
**Documentation:** https://hostingsurge.com/developers

Hostingsurge Shops API is one of 37 APIs that [Hostingsurge](https://apis.io/providers/hostingsurge-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Shops. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Shops API from Hostingsurge — 20 operation(s) for shops.

## Operations (32)

| Method | Path | Summary |
|---|---|---|
| GET | `/shops` | The team's shops (builder sites that sell) |
| GET | `/builder/sessions/{sessionId}/shop` | The shop of a builder site, or null |
| POST | `/builder/sessions/{sessionId}/shop` | Create the shop of a builder site (or return the one it has): defaults for the… |
| GET | `/shops/{shopId}` | A shop with its settings and today's counts |
| PATCH | `/shops/{shopId}` | Change a shop's settings (name, VAT, payments, policies, …) |
| DELETE | `/shops/{shopId}` | Delete a shop with its products, orders and customers |
| GET | `/shops/{shopId}/products` | Products (drafts and those on sale; status=all adds archived) |
| POST | `/shops/{shopId}/products` | Add a product with its variants (on sale unless status draft) |
| POST | `/shops/{shopId}/products/confirm-prices` | "Check prices before you go live": confirm the AI's prices and put the products… |
| POST | `/shops/{shopId}/products/pending-changes` | Apply or discard the AI's proposed price changes to a product on sale |
| GET | `/shops/{shopId}/products/{productId}` | One product |
| PATCH | `/shops/{shopId}/products/{productId}` | Change a product (variants replace the list; a variant keeps its id and stock… |
| DELETE | `/shops/{shopId}/products/{productId}` | Delete a product (orders keep their copy) |
| GET | `/shops/{shopId}/inventory` | Stock of every variant (low = at or under the shop's threshold) |
| POST | `/shops/{shopId}/inventory` | Set or adjust stock of several variants at once |
| GET | `/shops/{shopId}/collections` | Collections |
| POST | `/shops/{shopId}/collections` | Add a collection (manual or by tag) |
| PATCH | `/shops/{shopId}/collections/{collectionId}` | Change a collection |
| DELETE | `/shops/{shopId}/collections/{collectionId}` | Delete a collection |
| GET | `/shops/{shopId}/shipping` | Shipping zones and rates |
| PUT | `/shops/{shopId}/shipping` | Replace the shipping zones and rates |
| GET | `/shops/{shopId}/discounts` | Discount codes |
| POST | `/shops/{shopId}/discounts` | Add a discount code (percent, fixed or free shipping) |
| PATCH | `/shops/{shopId}/discounts/{discountId}` | Switch a code on or off, or change its end or limit |
| DELETE | `/shops/{shopId}/discounts/{discountId}` | Delete a discount code |
| POST | `/shops/{shopId}/policies/generate` | Fill the policies (terms, returns and withdrawal, privacy, delivery) of the… |
| GET | `/shops/{shopId}/orders` | Orders, newest first (status, q, from, to, limit) |
| GET | `/shops/{shopId}/orders/{orderId}` | One order with its history |
| POST | `/shops/{shopId}/orders/{orderId}/{action}` | mark-paid, fulfill (tracking), refund (amount, restock), cancel (restock)… |
| GET | `/shops/{shopId}/customers` | Customers with their order counts |
| POST | `/shops/{shopId}/stripe/connect` | Start (or continue) connecting the shop's own Stripe account: a Stripe… |
| POST | `/shops/{shopId}/stripe/refresh` | Read the connected Stripe account's status again |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-shops-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-builder-visual-op-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-policy-templates-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-pending-changes-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-confirm-prices-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-collection-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-create-shop-input-body-schema.json

## Other Hostingsurge APIs (12)

- [Hostingsurge Accelerator API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-accelerator-api/)
- [Hostingsurge Agents API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-agents-api/)
- [Hostingsurge Alerts API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-alerts-api/)
- [Hostingsurge Analytics API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-analytics-api/)
- [Hostingsurge Assistant API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-assistant-api/)
- [Hostingsurge Automation API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-automation-api/)
- [Hostingsurge Backups API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-backups-api/)
- [Hostingsurge Billing API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-billing-api/)
- [Hostingsurge Builder API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-builder-api/)
- [Hostingsurge Business API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-business-api/)
- [Hostingsurge Certificates API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-certificates-api/)
- [Hostingsurge Databases API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-databases-api/)

## Tags

Shops

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hostingsurge-com/hostingsurge-com-shops-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hostingsurge-com/.