Find locations by External Id

Required Permission

can-search-locations

See Auth* (scopes).

Request

GET /locations/findByExternalId?<query string>

Parameters

Parameter Example Required Type Description
countrycode GBR Yes ISO 3166-1 country code (*1) country code
store_id 1234 Yes string Store (external id)
postcode WC1X 8XZ No string postcode
language en No string prefer location data in this language (*2)

Notes

  1. Valid 3 digit, 2 characters or 3 characters.
  2. Must be a valid lowercase ISO 639-1 two-letter code (see)

Response

HTTP/1.1 200 OK
[
  {
    "storeId": "0002",
    "storeName": "MetaPack Limited",
    "city": "London",
    "postCode": "WC1X 8XZ",
    "countryCode": "GBR",
    "address": "201 Gray’s Inn Road",
    "latitude": 51.523402,
    "longitude": -0.114333,
    "telephoneNumber": "+442078436720",
    "email": "mkstore@askjeeves.com",
    "logoUrl": null,
    "photoUrls": [],
    "hasDisabledAccess": false,
    "description": null,
    "id": "ec30cb2b-9c64-46ee-a6b4-2db3238901d9",
    "tags": [
       "potato",
       "pharmacy",
       "refrigeration"
    ],
    "locationProvider": {
      "id": "ca0e1f97-dc57-4df5-9430-c93264603197",
      "name": "DoDo Test",
      "ownStores": false
    },
    "locationOpeningTimesRules": {
      "openingTimesRules": [
        {
          "rule": "every Sunday",
          "openingClosingTimes": [
            {
              "openingAt": "00:00",
              "closingAt": "23:59"
            }
          ]
        },
        {
          "rule": "every Monday",
          "openingClosingTimes": [
            {
              "openingAt": "00:00",
              "closingAt": "23:59"
            }
          ]
        },
        {
          "rule": "every Tuesday",
          "openingClosingTimes": [
            {
              "openingAt": "00:00",
              "closingAt": "23:59"
            }
          ]
        },
        {
          "rule": "every Wednesday",
          "openingClosingTimes": [
            {
              "openingAt": "00:00",
              "closingAt": "23:59"
            }
          ]
        },
        {
          "rule": "every Thursday",
          "openingClosingTimes": [
            {
              "openingAt": "00:00",
              "closingAt": "23:59"
            }
          ]
        },
        {
          "rule": "every Friday",
          "openingClosingTimes": [
            {
              "openingAt": "00:00",
              "closingAt": "23:59"
            }
          ]
        },
        {
          "rule": "every Saturday",
          "openingClosingTimes": [
            {
              "openingAt": "00:00",
              "closingAt": "23:59"
            }
          ]
        }
      ]
    },
    "links": [
      {
        "rel": "self",
        "href": "/locations/ec30cb2b-9c64-46ee-a6b4-2db3238901d9"
      },
      {
        "rel": "openingTimesRules",
        "href": "/locations/ec30cb2b-9c64-46ee-a6b4-2db3238901d9/openingTimesRules"
      },
      {
       "rel": "customData",
       "href": "/locations/ec30cb2b-9c64-46ee-a6b4-2db3238901d9/customData"
      }
    ]
  }
]

Failure

Invalid parameter combination or data types submitted:

HTTP/1.1 400 BAD REQUEST

User doesn't have the required permission:

HTTP/1.1 403 FORBIDDEN

Other errors:

HTTP/1.1 500 INTERNAL SERVER ERROR

results matching ""

    No results matching ""