--- title: "List warehouses" method: GET path: "/v2/warehouses" tags: ["warehouses"] --- # List warehouses `GET /v2/warehouses` Retrieve a list of warehouses associated with this account. ## Response `200` The request was a success. - ListWarehousesResponseBody — A warehouse list response body - `warehouses` Warehouse[], required — The array of warehouses returned by the API call - `warehouse_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `is_default` boolean — Designates which single warehouse is the default on the account - `name` string — Name of the warehouse - `created_at` string, date-time — Timestamp that indicates when the warehouse was created - `origin_address` Address — A complete or partial mailing address. - `name` string — The name of a contact person at this address. This field may be set instead of - or in addition to - the `company_name` field. - `phone` string — The phone number of a contact person at this address. The format of this phone number varies depending on the country. - `email` string — Email for the address owner. - `company_name` string — If this is a business address, then the company name should be specified here. - `address_line1` string — The first line of the street address. For some addresses, this may be the only line. Other addresses may require 2 or 3 lines. - `address_line2` string — The second line of the street address. For some addresses, this line may not be needed. - `address_line3` string — The third line of the street address. For some addresses, this line may not be needed. - `city_locality` string — The name of the city or locality - `state_province` string — The state or province. For some countries (including the U.S.) only abbreviations are allowed. Other countries allow the full name or abbreviation. - `postal_code` string — postal code - `country_code` string — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1) - `address_residential_indicator` 'unknown' | 'yes' | 'no' — Indicates whether an address is residential. - `return_address` Address — A complete or partial mailing address. - `name` string — The name of a contact person at this address. This field may be set instead of - or in addition to - the `company_name` field. - `phone` string — The phone number of a contact person at this address. The format of this phone number varies depending on the country. - `email` string — Email for the address owner. - `company_name` string — If this is a business address, then the company name should be specified here. - `address_line1` string — The first line of the street address. For some addresses, this may be the only line. Other addresses may require 2 or 3 lines. - `address_line2` string — The second line of the street address. For some addresses, this line may not be needed. - `address_line3` string — The third line of the street address. For some addresses, this line may not be needed. - `city_locality` string — The name of the city or locality - `state_province` string — The state or province. For some countries (including the U.S.) only abbreviations are allowed. Other countries allow the full name or abbreviation. - `postal_code` string — postal code - `country_code` string — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1) - `address_residential_indicator` 'unknown' | 'yes' | 'no' — Indicates whether an address is residential. ## Other responses - `400` — The request contained errors. - `404` — The specified resource does not exist. - `500` — The request was successful. --- [API](https://skmtc.net/shipstation/apis/shipstation-api-v2.md) · [All operations](https://skmtc.net/shipstation/apis/shipstation-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipstation-api-v2/revisions/d3d8c21cd227/schema)