GET all warehouses
Retrieve the list of warehouses for the current organization. Support an optional by_ids parameter to retrieve details for the warehouses included in the PO.
$ curl https://api.uphance.com/warehouses?by_ids=[id_1,id_2] \
-H "Authorization: ACCESS_TOKEN"
Example response:
{
"warehouses": [
{
"id": 1623,
"created_at": "2021-11-05T00:23:02.000Z",
"updated_at": "2026-07-06T13:08:15.000Z",
"name": "Primary warehouse",
"organisation_id": 35802,
"manufacturer_id": null,
"as_consignment": false,
"warehouse_type": "owned",
"consignment_customer_id": 59495,
"for_products": true,
"for_materials": true,
"inventory_bins_on": true,
"batch_picking_on": true,
"address": {
"id": 80683,
"customer_id": 59402,
"line_1": "517 E 117th St",
"line_2": "",
"line_3": "",
"city": "New York",
"state": "NY",
"country": "US",
"postcode": "10035-4409",
"default_for_shipping": true,
"default_for_billing": true
},
"contacts": [
{
"id": 56356,
"customer_id": 59402,
"first_name": "Austin",
"last_name": "Warner",
"position": "Manager",
"phone_1": "+12025550137",
"phone_2": "3432532424",
"email": "[email protected]",
"notes": "",
"buyer": false,
"shipping": false,
"billing": false
}
]
},
{
"id": 1627,
"created_at": "2021-11-24T16:39:54.000Z",
"updated_at": "2026-06-24T14:39:04.000Z",
"name": "Main Outlet",
"organisation_id": 35802,
"manufacturer_id": null,
"as_consignment": false,
"warehouse_type": "owned",
"consignment_customer_id": null,
"for_products": true,
"for_materials": false,
"inventory_bins_on": true,
"batch_picking_on": true,
"address": {
"id": 81073,
"customer_id": 59444,
"line_1": "820 S MACARTHUR BLVD REAR",
"line_2": "",
"line_3": "",
"city": "COPPELL",
"state": "TX",
"country": "US",
"postcode": "75019-4216",
"default_for_shipping": true,
"default_for_billing": true
},
"contacts": [
{
"id": 53532,
"customer_id": 59444,
"first_name": "Minnetonka",
"last_name": "Warehouse",
"position": "Warehouse Manager III",
"phone_1": "2025550137",
"phone_2": "",
"email": "[email protected]",
"notes": "Test for Vend outlets - Main Outlet",
"buyer": false,
"shipping": false,
"billing": false
},
{
"id": 59849,
"customer_id": 59444,
"first_name": "WH",
"last_name": "MGR",
"position": "Warehouse Manager I",
"phone_1": "2332233212",
"phone_2": "",
"email": "[email protected]",
"notes": "For Testing Checking Purposes Only",
"buyer": false,
"shipping": false,
"billing": false
}
]
}
]
}
GET a single warehouses by ID
$ curl https://api.uphance.com/warehouses/:id \
-H "Authorization: ACCESS_TOKEN"