The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the GraphQL Admin API. For details and migration steps, visit our migration guide.
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. For a better understanding of the relationship between locations, inventory levels and inventory items, refer to the InventoryLevel resource reference documentation
Endpoints
- get/admin/api/latest/locations.
json Retrieve a list of locations - get/admin/api/latest/locations/{location_
id}. json Retrieve a single location by its ID - get/admin/api/latest/locations/{location_
id}/inventory_ levels. json Retrieve a list of inventory levels for a location - get/admin/api/latest/locations/count.
json Retrieve a count of locations
The Location resource
Properties
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.
The location's street address.
The optional second line of the location's street address.
The city the location is in.
The country the location is in.
The two-letter code (ISO 3166-1 alpha-2 format) corresponding to country the location is in.
The date and time (ISO 8601 format) when the location was created.
The ID of the location.
Whether this is a fulfillment service location. If true, then the location is a
fulfillment service location. If false, then the location was created by the
merchant and isn't tied to a fulfillment service.
The name of the location.
The phone number of the location. This value can contain special characters, such as - or +.
The province, state, or district of the location.
The Location resource
Anchor to GET request, Retrieve a list of locationsgetRetrieve a list of locations
Retrieve a list of locations. Note: This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to Make paginated requests to the REST Admin API.
The maximum number of results to show.
Anchor to get-locations-examplesExamples
Retrieve a list of all locations
Retrieve a list of all locations
/admin/api/2025-07/locations.
Response
Anchor to GET request, Retrieve a single location by its IDgetRetrieve a single location by its ID
Retrieve a single location by its ID.
Retrieve a single location
Retrieve a single location
/admin/api/2025-07/locations/487838322.
Response
Anchor to GET request, Retrieve a list of inventory levels for a locationgetRetrieve a list of inventory levels for a location
Retrieve a list of inventory levels for a location. Note: This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to Make paginated requests to the REST Admin API.
Retrieve a list of all inventory for a location by its ID
Retrieve a list of all inventory for a location by its ID
/admin/api/2025-07/locations/487838322/inventory_
Response
Anchor to GET request, Retrieve a count of locationsgetRetrieve a count of locations
Retrieve a count of locations.
Count all store locations
Count all store locations