Scope: inventory:warehouses.read https://api.alladdin.com/api/v2/warehouses

Returns the list of all warehouses in your account.
The response includes each warehouse's name, address, and default status. Unlike document endpoints, warehouses are not paginated — all warehouses are returned in a single response.

Request

import requests

url = "https://api.alladdin.com/api/v2/warehouses"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "user_id": "string",
      "name": "string",
      "notes": "string",
      "email": "string",
      "phone": "string",
      "mobile": "string",
      "default": false,
      "color": "#3498db",
      "icon": "string",
      "address": {
        "address": "string",
        "city": "string",
        "province": "string",
        "postal_code": "string",
        "country": "string",
        "country_code": "ES"
      }
    }
  ]
}

Success responses

200 List of warehouses application/json object items[] object[] id string

Unique identifier of the warehouse

user_id string | null

Identifier of the user managing this warehouse

name string

Name of the warehouse

notes string | null

Additional notes about the warehouse

email string | null

Contact email for the warehouse

phone string | null

Phone number of the warehouse

mobile string | null

Mobile phone number of the warehouse

default boolean

Whether this is the default warehouse

color string

Color assigned to the warehouse for visual identification

icon string

Icon identifier for the warehouse

address object

Physical address of the warehouse

Error responses

401 Invalid or missing API key application/json 403 Insufficient permissions application/json 429 Rate limit exceeded application/json

← PreviousUpdate a warehouse →

Next →Get a warehouse by ID →