API

Locations

Returns where each SKU is physically stored, down to the bin. Use it if your external system needs to know exact warehouse positions, not just totals.

Endpoint

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

curl -H "Authorization: Bearer vh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://vintrhall.com/api/v1/locations?sku=TSH-BLK-M"

Query parameters

Parameter	Description
`sku`	Return only locations for this SKU.
`cursor`	Pagination cursor from a previous response.
`limit`	Page size, default 100, maximum 200.

Response

{
  "items": [
    {
      "sku": "TSH-BLK-M",
      "warehouse": "WH1",
      "location": "A/3/2/1",
      "qty": 6,
      "confirmedAt": "2026-07-09T15:40:00.000Z"
    }
  ],
  "nextCursor": null
}

location is the bin path (row/rack/shelf/bin), for example A/3/2/1.
confirmedAt is when this quantity at this location was last physically confirmed, for example by a scan.
A SKU can appear in more than one location if it is split across bins.