Warehouses

Returns the list of warehouses in your organization. Use it to resolve warehouse codes returned by other endpoints, and to tell your own warehouses apart from supplier warehouses.

Endpoint

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

curl -H "Authorization: Bearer vh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://vintrhall.com/api/v1/warehouses

This endpoint has no query parameters and is not paginated: it always returns the full list in one response.

Response

{
  "items": [
    { "id": "wh_01h...", "code": "WH1", "name": "Main warehouse", "isOwnStock": true },
    { "id": "wh_02h...", "code": "SUP1", "name": "Supplier A", "isOwnStock": false }
  ]
}

• code is the short identifier used as the warehouse filter on stock.
• isOwnStock distinguishes warehouses you physically control from supplier warehouses.

This endpoint only returns active warehouses. A warehouse can be archived after stock or movement records referencing its code were created, so stock and movements may reference a warehouse code that is no longer in this list.