For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
  • GraphQL
    • Overview
      • Playground
      • Explorer
          • QUERYsite
          • QUERYchannel
          • QUERYcustomer
          • QUERYnode
          • QUERYlocations
          • QUERYshopperPreferences
          • QUERYstore
          • QUERYcountries
  • MCP
    • Overview
Dev Portal
LogoLogo
GraphQLStorefrontQueries

locations

Example Query
1query ExampleQuery($entityIds: [Int], $codes: [String], $typeIds: [String], $serviceTypeIds: [String], $distanceFilter: DistanceFilter, $countryCodes: [countryCode], $states: [String], $cities: [String], $before: String, $after: String, $first: Int, $last: Int) {
2 locations(entityIds: $entityIds, codes: $codes, typeIds: $typeIds, serviceTypeIds: $serviceTypeIds, distanceFilter: $distanceFilter, countryCodes: $countryCodes, states: $states, cities: $cities, before: $before, after: $after, first: $first, last: $last) {
3 pageInfo {
4 hasNextPage
5 hasPreviousPage
6 startCursor
7 endCursor
8 }
9 edges {
10 node
11 cursor
12 }
13 }
14}
Variables
1{
2 "entityIds": [],
3 "codes": [],
4 "typeIds": [],
5 "serviceTypeIds": [],
6 "distanceFilter": {
7 "radius": 0,
8 "longitude": 0,
9 "latitude": 0,
10 "lengthUnit": "Kilometres"
11 },
12 "countryCodes": [],
13 "states": [],
14 "cities": [],
15 "before": "example",
16 "after": "example",
17 "first": 0,
18 "last": 0
19}
Example response
1{
2 "data": {
3 "locations": {
4 "pageInfo": {
5 "hasNextPage": true,
6 "hasPreviousPage": true,
7 "startCursor": "example",
8 "endCursor": "example"
9 },
10 "edges": [
11 {
12 "node": {
13 "entityId": null,
14 "code": null,
15 "label": null,
16 "description": null,
17 "typeId": null,
18 "serviceTypeIds": null,
19 "address": null,
20 "operatingHours": null,
21 "distance": null,
22 "blackoutHours": null
23 },
24 "cursor": "example"
25 }
26 ]
27 }
28 }
29}
Locations
Was this page helpful?
Previous

node

Next

shopperPreferences

Built with

Arguments

entityIdslist of IntegersOptional
Location ids filter
codeslist of StringsOptional
Location codes filter
typeIdslist of StringsOptional
Location type ids filter
serviceTypeIdslist of StringsOptional
Location service type ids filter
distanceFilterDistanceFilterOptional
Filter locations by the distance
countryCodeslist of EnumsOptional
Location country codes filter
stateslist of StringsOptional
Location states filter
citieslist of StringsOptional
Location cities filter
beforeStringOptional
afterStringOptional
firstIntegerOptional
lastIntegerOptional

Returns

an InventoryLocationConnection
pageInfoPageInfo
Information to aid in pagination.
edgeslist of InventoryLocationEdges
A list of edges.