Location
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/2019-10/locations.json Retrieves a list of locations
- GET /admin/api/2019-10/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/2019-10/locations/count.json Retrieves a count of locations
- GET /admin/api/2019-10/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
Endpoints
Retrieve a list of all locations
GET /admin/api/2019-10/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/2019-10/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/2019-10/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/2019-10/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/2020-01/locations.json Retrieves a list of locations
- GET /admin/api/2020-01/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/2020-01/locations/count.json Retrieves a count of locations
- GET /admin/api/2020-01/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
Endpoints
Retrieve a list of all locations
GET /admin/api/2020-01/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/2020-01/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/2020-01/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/2020-01/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/2020-04/locations.json Retrieves a list of locations
- GET /admin/api/2020-04/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/2020-04/locations/count.json Retrieves a count of locations
- GET /admin/api/2020-04/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
localized_country_name |
The localized name of the location's country. |
localized_province_name |
The localized name of the location's region. Typically a province, state, or prefecture. |
Endpoints
Retrieve a list of all locations
GET /admin/api/2020-04/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/2020-04/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/2020-04/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/2020-04/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/2020-07/locations.json Retrieves a list of locations
- GET /admin/api/2020-07/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/2020-07/locations/count.json Retrieves a count of locations
- GET /admin/api/2020-07/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
localized_country_name |
The localized name of the location's country. |
localized_province_name |
The localized name of the location's region. Typically a province, state, or prefecture. |
Endpoints
Retrieve a list of all locations
GET /admin/api/2020-07/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/2020-07/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/2020-07/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/2020-07/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/2020-10/locations.json Retrieves a list of locations
- GET /admin/api/2020-10/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/2020-10/locations/count.json Retrieves a count of locations
- GET /admin/api/2020-10/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
localized_country_name |
The localized name of the location's country. |
localized_province_name |
The localized name of the location's region. Typically a province, state, or prefecture. |
Endpoints
Retrieve a list of all locations
GET /admin/api/2020-10/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/2020-10/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/2020-10/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/2020-10/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/2021-01/locations.json Retrieves a list of locations
- GET /admin/api/2021-01/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/2021-01/locations/count.json Retrieves a count of locations
- GET /admin/api/2021-01/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
localized_country_name |
The localized name of the location's country. |
localized_province_name |
The localized name of the location's region. Typically a province, state, or prefecture. |
Endpoints
Retrieve a list of all locations
GET /admin/api/2021-01/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/2021-01/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/2021-01/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/2021-01/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/2021-04/locations.json Retrieves a list of locations
- GET /admin/api/2021-04/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/2021-04/locations/count.json Retrieves a count of locations
- GET /admin/api/2021-04/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
localized_country_name |
The localized name of the location's country. |
localized_province_name |
The localized name of the location's region. Typically a province, state, or prefecture. |
Endpoints
Retrieve a list of all locations
GET /admin/api/2021-04/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/2021-04/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/2021-04/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/2021-04/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}
A location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. You can use the Location resource to track sales, manage inventory, and configure the tax rates to apply at checkout.
What you can do with Location
The Shopify API lets you do the following with the Location resource. More detailed versions of these general actions may be available:
- GET /admin/api/unstable/locations.json Retrieves a list of locations
- GET /admin/api/unstable/locations/{location_id}.json Retrieves a single location by its ID
- GET /admin/api/unstable/locations/count.json Retrieves a count of locations
- GET /admin/api/unstable/locations/{location_id}/inventory_levels.json Retrieves a list of inventory levels for a location.
Location properties
active |
Whether the location is active. If true, then the location can be used to sell products, stock inventory, and fulfill orders. Merchants can deactivate locations from the Shopify admin. Deactivated locations don't contribute to the shop's location limit. |
address1 |
The first line of the address. |
address2 |
The second line of the address. |
city |
The city the location is in. |
country |
The country the location is in. |
country_code |
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in. |
created_at |
The date and time (ISO 8601 format) when the location was created. |
id |
The ID for the location. |
legacy |
Whether this is a fulfillment service location. If |
name |
The name of the location. |
phone |
The phone number of the location. This value can contain special characters like |
province |
The province the location is in. |
province_code |
The two-letter code corresponding to province or state the location is in. |
updated_at |
The date and time (ISO 8601 format) when the location was last updated. |
zip |
The zip or postal code. |
localized_country_name |
The localized name of the location's country. |
localized_province_name |
The localized name of the location's region. Typically a province, state, or prefecture. |
Endpoints
Retrieve a list of all locations
GET /admin/api/unstable/locations.json
View Response
HTTP/1.1 200 OK
{
"locations": [
{
"id": 905684977,
"name": "50 Rideau Street",
"address1": "50 Rideau Street",
"address2": null,
"city": "Ottawa",
"zip": "K1N 9J7",
"province": "Ontario",
"country": "CA",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "CA",
"country_name": "Canada",
"province_code": "ON",
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/905684977",
"localized_country_name": "Canada",
"localized_province_name": "Ontario"
},
{
"id": 48752903,
"name": "Apple Api Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/48752903",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 192722535,
"name": "Apple Cupertino",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/192722535",
"localized_country_name": "United States",
"localized_province_name": null
},
{
"id": 61629186,
"name": "Apple Shipwire",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "DE",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "DE",
"country_name": "Germany",
"province_code": null,
"legacy": true,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/61629186",
"localized_country_name": "Germany",
"localized_province_name": null
},
{
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322",
"localized_country_name": "United States",
"localized_province_name": null
}
]
}
Retrieve a single location
GET /admin/api/unstable/locations/487838322.json
View Response
HTTP/1.1 200 OK
{
"location": {
"id": 487838322,
"name": "Fifth Avenue AppleStore",
"address1": null,
"address2": null,
"city": null,
"zip": null,
"province": null,
"country": "US",
"phone": null,
"created_at": "2021-02-05T20:59:20-05:00",
"updated_at": "2021-02-05T20:59:20-05:00",
"country_code": "US",
"country_name": "United States",
"province_code": null,
"legacy": false,
"active": true,
"admin_graphql_api_id": "gid://shopify/Location/487838322"
}
}
Count all store locations
GET /admin/api/unstable/locations/count.json
View Response
HTTP/1.1 200 OK
{
"count": 5
}
page
parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
Retrieve a list of all inventory for a location by its ID
GET /admin/api/unstable/locations/487838322/inventory_levels.json
View Response
HTTP/1.1 200 OK
{
"inventory_levels": [
{
"inventory_item_id": 49148385,
"location_id": 487838322,
"available": 18,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=49148385"
},
{
"inventory_item_id": 808950810,
"location_id": 487838322,
"available": 9,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=808950810"
},
{
"inventory_item_id": 457924702,
"location_id": 487838322,
"available": 36,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=457924702"
},
{
"inventory_item_id": 39072856,
"location_id": 487838322,
"available": 27,
"updated_at": "2021-02-05T20:59:20-05:00",
"admin_graphql_api_id": "gid://shopify/InventoryLevel/690933842?inventory_item_id=39072856"
}
]
}