Skip to main content
GET
/
products
List or search products
curl --request GET \
  --url https://dashboard.scango.ch/api/v1/products \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "a1b2c3",
      "name": "Mineral water 50cl",
      "price": 120,
      "barcode": "7610800001234",
      "taxCategory": "2.6",
      "category": "cat_01",
      "supplier": "sup_01"
    }
  ],
  "meta": {
    "total": 1,
    "returned": 1,
    "limit": 100
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.scango.ch/llms.txt

Use this file to discover all available pages before exploring further.

Without the q query parameter, the endpoint returns products from the database up to limit (1–5000, default 100). With q set to a non-empty search string, results come from full-text search (for example on name and barcode); the same limit applies, but search caps the effective page size at 250 (see meta.limit). Use offset (0–10000, default 0) only with q for pagination. store applies only when searching with q and limits hits to products allowed for that store. Responses include meta (total, returned, limit, and when using q, offset). See Introduction.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
q
string

Search text. If omitted or empty, all products are returned.

​
limit
integer
default:100

Maximum number of products in this response. Must be between 1 and 5000. Default is 100. Applies with or without q; when using q, search caps the effective value at 250.

Required range: 1 <= x <= 5000
​
offset
integer
default:0

When using q, number of search hits to skip (pagination). Must be between 0 and 10000. Default is 0.

Required range: 0 <= x <= 10000
​
store
string

When using q, only include products allowed for this store ID.

Response

List of products. When q is used, results come from search and field set may differ slightly from the non-search response. The response always includes meta with limit (and offset when searching); see ListMeta.

​
data
object[]
required
​
meta
object
required

Included on every list response. returned is the length of data. For Firestore-backed lists (/products without q, /orders, /suppliers, /categories), total equals returned for that response (the API does not return a separate full match count). For product search with q, total is the search index’s estimated number of matching documents. limit is the applied page size (query default 100, maximum 5000; search with q caps the effective page size at 250). offset is only used for product search with q.