Warehouse List
Retrieves the list of available warehouses along with their IDs, names, and shipping options.
GET
/api/v1/device-hub/warehousesDescription
Use this API to fetch warehouse details for order fulfillment and shipping selection. Each warehouse includes available shipping options that can be used when placing orders.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Content-Type | application/json | Yes |
Response
Response Fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request was successful |
| status | integer | HTTP status code |
| message | string | Response message |
| data.ware_houses | array | Array of warehouse objects |
| data.ware_houses[].warehouse_id | string | Unique identifier for the warehouse |
| data.ware_houses[].name | string | Warehouse name |
| data.ware_houses[].shipping_options | array | Available shipping methods for this warehouse |
Error Responses
Common error responses you may encounter when using this endpoint.
Notes
- Use the warehouse_id when fetching inventory or placing orders
- Shipping options vary by warehouse and must match exactly when placing orders
- Available shipping options: "UPS Ground", "2nd Day Air", "Overnight"
Related Endpoints
Did this page help you?
Request
curl --location 'https://dev-api.unduit.com/api/v1/device-hub/warehouses' \
--header 'Content-Type: application/json' \
--data ''Success Response (200)
{
"success": true,
"status": 200,
"message": "Warehouses retrieved successfully",
"data": {
"ware_houses": [
{
"warehouse_id": "QebLm2p7",
"name": "Unduit U***",
"shipping_options": [
"UPS Ground",
"2nd Day Air",
"Overnight"
]
},
{
"warehouse_id": "pabLm2p7",
"name": "Unduit E***",
"shipping_options": [
"UPS Ground",
"2nd Day Air",
"Overnight"
]
},
{
"warehouse_id": "NobLm2p7",
"name": "Unduit C***",
"shipping_options": [
"UPS Ground",
"2nd Day Air",
"Overnight"
]
}
]
}
}Error Responses
401 Unauthorized
{
"message": "Authentication token is missing or invalid"
}500 Internal Server Error
{
"message": "Internal server error occurred while fetching warehouse data"
}