# List available warehouses

**GET /api/external/hub/v1/warehouses**

Returns all warehouses accessible to your account based on active 3PL customer plans. Use the `id` from the response as `warehouse_id` when creating Inventory Requests or Middle Mile Orders.


## Servers
- Public API: https://api.useshelf.com (Public API)



## Parameters




## Responses
### 200
deduplicates warehouses shared across multiple plans

#### Body: application/json (array[object])
- **id** (integer)
  Warehouse ID — use as `warehouse_id` in other API calls
- **warehouse_name** (string)
  Internal warehouse name
- **go_ramp_warehouse_id** (string | null)
  GoRamp warehouse identifier
- **customer_address** (object | null)
  Physical address of the warehouse

### 401
unauthorized — missing org_id

#### Body: application/json (object)
- **error** (string)


### 404
threepl customer not found

#### Body: application/json (object)
- **error** (string)



[Powered by Bump.sh](https://bump.sh)