All plans
AI connection (MCP)
Connect your AI assistant, such as Claude, ChatGPT or Grok, securely to your scango.ch data.
FeatureAll plans
API & integrations
The REST API connects scango.ch to your inventory system, ERP, accounting or online shop. A program authenticates with an API key, fetches orders and maintains products, suppliers, categories and stores.
Why it matters
Your checkout is not a data silo
Keep the catalogue current
Take products from your inventory system and keep prices up to date instead of entering everything twice.
Fetch orders
Retrieve sales for a period – for accounting or your own reporting.
Permissions per key
Each integration gets its own key, read-only or with write access. A deleted key stops working immediately.
How it works
Connected in four steps
The API is a REST interface: HTTPS requests in, JSON out.
1 Create a key
Under Settings › Organization › API keys, with a description and the type “Read” or “Write”.
2 Add it to your program
Send the key with every request in the Authorization header as a bearer token. The base URL is https://dashboard.scango.ch/api/v1.
3 Fetch data
Lists come back as data and meta, with up to 5000 entries per page and cursor paging. Amounts are in centimes.
4 Poll regularly
The API does not push new orders; there are no webhooks. Your program asks at intervals.
In the dashboard
Managing keys
These images come straight from the Cloud Dashboard. Admins and owners create and manage keys.
app.scango.ch
- 1
Create a key
A description such as “Accounting” or “Online shop” helps when tidying up later. “Read” only allows fetching; “Write” also allows creating, changing and deleting.
app.scango.ch - 2
Key overview
The list shows description, type and creation date. The eye icon shows a key again, the cross deletes it – integrations using it stop working.
app.scango.ch
- Read the full guide
Good to know
What the API covers
The API is meant for developers or your IT partner. The full reference with all endpoints and fields is on developers.scango.ch, where the OpenAPI description can also be downloaded. If you use Stellard Age age verification, identity logs and the block list can also be read and managed via the API.
- Products
- read, create, update, delete, upload image
- Orders
- read by period
- Suppliers, categories, stores
- read, create, update, delete
- Identity logs
- read scans, manage block list
- Format
- REST, JSON over HTTPS
- Authentication
- API key as bearer token
- Page size
- default 100, maximum 5000
- API access
- in every plan, from Basis CHF 99.–/month
Resources
Technical
Cost
scango.ch
More features
All plans
Product management
Prices, barcodes, VAT, deposit, age and visibility – maintain your assortment yourself.
Retail plan
Multi-store management
One catalogue, multiple locations – visibility, stock and sales per store.
Frequently asked questions
What does the API cost?
Nothing extra. API access is included in every plan, starting with the Basis plan at CHF 99.– per month.
Where is the technical documentation?
On developers.scango.ch, with all endpoints, parameters, fields and examples. The API guide gets you started with a first example.
Can I change orders via the API?
No. Orders can be listed for a period and fetched individually, but not created or changed.
Are there webhooks?
No. The API does not push new orders. Query it at regular intervals.
How do I protect the key?
Only use it on a server, never in the code of a website or app. Create a separate key per integration and choose “Read” when no data needs to change.
Who can create keys?
Admins and owners of your organization.
Hi, I’m Tobias.
Happy to help. Sign up for free to get a first impression – or request a non-binding quote. I’m here if you have questions.
Tobias Kobelt · scango.ch