Recipe — read data

All examples assume the setup from API recipes (base URL, bearer token).

List brands (page-based pagination)

GET /api/brands takes page, pageSize, and an optional q search; it returns the { data, total, page, pageSize } envelope.

cURL
Python
JavaScript

curl "https://app.solya.app/api/brands?page=1&pageSize=20&q=adi" \
  -H "Authorization: Bearer solya_sa_xxx"

import requests
BASE, TOKEN = "https://app.solya.app", "solya_sa_xxx"
headers = {"Authorization": f"Bearer {TOKEN}"}

def list_brands(page=1, page_size=20, q=None):
    params = {"page": page, "pageSize": page_size}
    if q: params["q"] = q
    r = requests.get(f"{BASE}/api/brands", headers=headers, params=params)
    r.raise_for_status()
    return r.json()  # { data, total, page, pageSize }

first = list_brands(q="adi")
print(first["total"], len(first["data"]))

const BASE = "https://app.solya.app", TOKEN = "solya_sa_xxx"
const headers = { Authorization: `Bearer ${TOKEN}` }

async function listBrands({ page = 1, pageSize = 20, q } = {}) {
  const url = new URL(`${BASE}/api/brands`)
  url.searchParams.set("page", page)
  url.searchParams.set("pageSize", pageSize)
  if (q) url.searchParams.set("q", q)
  const res = await fetch(url, { headers })
  if (!res.ok) throw new Error(`brands failed: ${res.status}`)
  return res.json() // { data, total, page, pageSize }
}

Example response:

{
  "data": [
    { "id": "brand-uuid-adidas", "name": "Adidas", "code": "ADI", "isActive": true }
  ],
  "total": 1, "page": 1, "pageSize": 20
}

Paginate through everything

def all_brands():
    page, out = 1, []
    while True:
        res = list_brands(page=page, page_size=100)
        out.extend(res["data"])
        if page * res["pageSize"] >= res["total"]:
            break
        page += 1
    return out

Some endpoints (mostly under /api/data-platform/) use offset-based pagination (limit / offset) and return { items, limit, offset }. Check the endpoint in the API Reference tab. See Making requests.

Read inventory stock-out risks

GET /api/inventory/risks returns variants ranked by urgency, filterable by status, brandIds, shopIds, and period.

cURL
Python
JavaScript

curl "https://app.solya.app/api/inventory/risks?status=critical&pageSize=50" \
  -H "Authorization: Bearer solya_sa_xxx"

r = requests.get(
    f"{BASE}/api/inventory/risks",
    headers=headers,
    params={"status": "critical", "pageSize": 50},
)
r.raise_for_status()
for row in r.json()["data"]:
    print(row["rank"], row["variantName"], row["daysOfSupply"], row["status"])

const url = new URL(`${BASE}/api/inventory/risks`)
url.searchParams.set("status", "critical")
url.searchParams.set("pageSize", "50")
const res = await fetch(url, { headers })
const { data } = await res.json()
data.forEach(r => console.log(r.rank, r.variantName, r.daysOfSupply, r.status))

Each row includes variantId, variantName, brandName, closingStock, avgDailySales, daysOfSupply, and status (critical / warning / healthy). See the stock-out risk guide. To act on a critical row, turn it into a plan — next recipe.

API integration

API recipes

Platform & data model

Decision layer (reference)

Operations & infrastructure

Ingestion specs (reference)

Workflows (reference)

Tagging rules (reference)

Alerts (reference)

Recipe — read data

Paginate through everything

Read inventory stock-out risks

​List brands (page-based pagination)

​Paginate through everything

​Read inventory stock-out risks

List brands (page-based pagination)

Paginate through everything

Read inventory stock-out risks