Introduction

scango.ch Customer API

REST API for integrations: products, orders, suppliers, categories, and stores.

Base URL

https://dashboard.scango.ch/api/v1

Authentication

Create an API key under Settings → Organization → Keys:

Authorization: Bearer <api-key>

• Read — GET
• Write — also create, update, and delete products, categories, suppliers, and stores

Essentials

• Money amounts are integer cents (120 = CHF 1.20)
• List endpoints return { data, meta }. Use limit (default 100, max 5000)
• offset exists only for product search with q (max 250 per page)
• Without q: paginate with optional cursor; follow meta.nextCursor until it is absent. Soft-deleted catalog items are omitted from lists — returned < limit does not mean you are done; keep paging while nextCursor is present
• Orders require start and end; paymentState is optional. Use cursor the same way when listing orders. Soft-deleted orders are omitted unless you pass includeDeleted=true
• No webhooks — poll for orders
• Product images: set imageUrl on create/update, or POST /products/{productId}/image (multipart file); clear with DELETE /products/{productId}/image

Quickstart

See Quickstart for a first curl request.

OpenAPI: /openapi/scango.json