List all warehouses

GET https://api.tamio.com/v2/warehouses/list

Returns a paginated list of warehouses. Supports filtering by date range, country, product, and free-text search. Results can be sorted by label, country, address, city, email, telephone, postcode, or state.

Query Parameters

page integer

Page number for pagination.

per_page integer

Number of warehouses per page.

order string

Sort direction.

ascdesc

sort_by string

Field to sort by.

labelcountryaddresscityemailtelephone

postcodestate

filter string

Free-text search across label, address, city, or contact information.

from string

Start date filter (ISO 8601 string or Unix timestamp).

to string

End date filter (ISO 8601 string or Unix timestamp).

product_id string

Filter warehouses that stock a specific product.

countries array of string

Filter by warehouse country codes.

Responses

200 Paginated list of warehouses

Paginated list of warehouses

status integer

total_results integer

Total number of warehouses matching the query.

warehouses array of Warehouse

id string

Unique identifier of the warehouse.

object string

Object type identifier.

label string

Human-readable warehouse name.

custom_id string

Custom identifier for external system integration.

country string

ISO country code where the warehouse is located.

address string

Street address.

city string

City.

postcode string

Postal or ZIP code.

state string

State or province code.

email string

Contact email for warehouse operations.

telephone string

Contact phone number.

areas_served array of string

Destination codes this warehouse can fulfill orders for.

products integer

Count of unique products with inventory in this warehouse.

variants integer

Count of product variants with inventory in this warehouse.

has_notes boolean

Whether the warehouse has any notes attached.

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Referenced product not found

status integer

error string

error_code integer

401 Missing or invalid API key

Retrieve a warehouse

/warehouses/list

1 const response = await fetch("https://api.tamio.com/v2/warehouses/list", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/warehouses/list")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "total_results": 3,
  "warehouses": [
    {
      "id": "aaa14567-e89b-12d3-a456-426614174000",
      "object": "warehouse",
      "label": "Main Distribution Center",
      "custom_id": "WH-001",
      "country": "US",
      "address": "123 Warehouse Blvd",
      "city": "Los Angeles",
      "postcode": "90001",
      "state": "CA",
      "email": "[email protected]",
      "telephone": "+1-555-0100",
      "areas_served": [
        "US",
        "CA",
        "MX"
      ],
      "products": 45,
      "variants": 120,
      "has_notes": true
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/warehouses/list", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/warehouses/list")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body