Happy Endpoint

Get Stores list

Get stores list using country code

GET
/stores

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

countryCode*string
  • Two-letter country code
  • Get available country codes from /countries endpoint
  • Examples: us (United States), ca (Canada), gb (United Kingdom), ch (Switzerland), se (Sweden), de (Germany)
Length2 <= length <= 2

Header Parameters

X-RapidAPI-Host*string
Default"ikea-api-pro.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/stores?countryCode=us" \  -H "X-RapidAPI-Host: ikea-api-pro.p.rapidapi.com"
{
  "success": true,
  "data": {
    "stores": [
      {
        "storeId": "680",
        "name": "IKEA Los Angeles - Arcadia",
        "lat": 34.1348867704382,
        "lng": -118.051567544364,
        "displayName": "Arcadia, CA",
        "storePageUrl": "https://www.ikea.com/us/en/stores/arcadia/",
        "address": {
          "street": "400 South Baldwin Ave Suite D5",
          "zipCode": "91007",
          "city": "Arcadia",
          "displayAddress": "400 South Baldwin Ave Suite D5, Arcadia"
        },
        "classification": {
          "code": "PAOP",
          "name": "IKEA PLAN AND ORDER POINT"
        }
      }
    ]
  }
}
{
  "success": false,
  "message": "Invalid request: Keyword is required and must be a non-empty string",
  "error": "VALIDATION_ERROR"
}
{
  "success": false,
  "message": "The requested resource was not found for the specified country. Please verify your inputs.",
  "error": "RESOURCE_NOT_FOUND"
}
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}
{
  "success": false,
  "message": "IKEA product search service is currently unavailable. Please try again later.",
  "error": "IKEA_API_ERROR"
}