---
title: 'Introduction'
description: '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**:

```http
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](/en/api-reference/quickstart) for a first `curl` request.

OpenAPI: [`/openapi/scango.json`](/openapi/scango.json)