API

Products

Returns the product catalog for your organization. Use it to keep an external system's product list in sync with Vintrhall, or to look up a single SKU or EAN.

Endpoint

GET https://vintrhall.com/api/v1/products

curl -H "Authorization: Bearer vh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://vintrhall.com/api/v1/products?limit=100"

Query parameters

Parameter	Description
`sku`	Return only the product with this SKU.
`ean`	Return only the product with this EAN.
`updatedSince`	ISO 8601 timestamp. Return only products changed at or after this time.
`cursor`	Pagination cursor from a previous response.
`limit`	Page size, default 100, maximum 200.

Response

{
  "items": [
    {
      "sku": "TSH-BLK-M",
      "ean": "5901234123457",
      "name": "Cotton T-Shirt Black M",
      "brand": "Acme",
      "status": "active",
      "updatedAt": "2026-07-10T09:14:00.000Z"
    }
  ],
  "nextCursor": null
}

updatedAt reflects the last change to the product record itself, not to its stock. For stock, use the stock endpoint.