Resolve Warehouse

Maps a Spanish postal code to the Mercadona warehouse that serves it: one of the 7 online hubs or one of the 267 physical stores. You usually don’t need this endpoint, because every warehouse-scoped endpoint accepts postal_code directly and resolves it for you. Use it to check coverage for an address, or to resolve a postal code once and cache the warehouse code for later calls. in_area tells you whether the address is inside the delivery area.

HTTP Request

GET /resolve-warehouse

Parameters

Parameter	Type	Required	Default	Description
`postal_code`	string	Yes	-	Spanish 5-digit postal code, e.g. `46001` or `08001`. Send it as a string so leading zeros are kept

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
  "status": true,
  "request_id": "640c49a9-3073-9fa8-f2ae-b7162f36",
  "cached_at": "2026-10-14T08:51:22Z",
  "data": {
    "postal_code": "46001",
    "warehouse": "vlc1",
    "warehouse_type": "hub",
    "in_area": true
  },
  "request_params": {
    "postal_code": "46001"
  }
}

Response Fields

Field	Type	Description
`status`	boolean	`true` when the request succeeded
`request_id`	string	Unique request identifier
`cached_at`	string \| null	ISO timestamp when the answer came from cache, `null` when fetched for this request
`data`	object	Response payload
`data.postal_code`	string	The postal code you sent
`data.warehouse`	string	Code of the warehouse that serves this postal code. Pass it as `warehouse` on other endpoints
`data.warehouse_type`	string	`hub` or `store`
`data.in_area`	boolean	Whether the address is inside Mercadona’s delivery area
`request_params`	object	The query parameters you sent, echoed back as strings
`request_params.postal_code`	string	The `postal_code` you sent

Example results

Postal code	Area	`warehouse`	`warehouse_type`	`in_area`
`46001`	Valencia	`vlc1`	`hub`	`true`
`35001`	Las Palmas	`4701`	`store`	`true`
`51001`	Ceuta	`4436`	`store`	`true`
`07001`	Palma	`3842`	`store`	`true`

Error Responses

A missing or invalid postal_code returns HTTP 400 with error as a plain string:

1
2
3
4
5
{
  "status": false,
  "request_id": "...",
  "error": "Invalid parameter 'postal_code': Field required"
}

Status Code	Cause	Description
400	Missing `postal_code`	`Invalid parameter 'postal_code': Field required`
400	Malformed `postal_code`	Must be exactly 5 digits: `String should match pattern '^[0-9]{5}$'`

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import requests

BASE_URL = "https://mercadona-api.p.rapidapi.com"

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "mercadona-api.p.rapidapi.com"
}

# Resolve the postal code once
response = requests.get(
    f"{BASE_URL}/resolve-warehouse",
    headers=headers,
    params={"postal_code": "46001"}
)
resolved = response.json()["data"]

if not resolved["in_area"]:
    raise SystemExit(f"{resolved['postal_code']} is outside the delivery area")

warehouse = resolved["warehouse"]
print(f"Postal code {resolved['postal_code']} -> {warehouse} ({resolved['warehouse_type']})")

# Reuse the warehouse code on later calls
response = requests.get(
    f"{BASE_URL}/search",
    headers=headers,
    params={"q": "leche", "warehouse": warehouse}
)
for product in response.json()["data"]["results"]:
    print(f"{product['name']}: {product['price']} EUR")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
const url = "https://mercadona-api.p.rapidapi.com/resolve-warehouse";

const params = new URLSearchParams({
  postal_code: "46001"
});

const response = await fetch(`${url}?${params}`, {
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "mercadona-api.p.rapidapi.com"
  }
});

const { data } = await response.json();
console.log(`${data.postal_code} -> ${data.warehouse} (${data.warehouse_type}), in area: ${data.in_area}`);

1
2
3
4
curl -G "https://mercadona-api.p.rapidapi.com/resolve-warehouse" \
  --data-urlencode "postal_code=46001" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: mercadona-api.p.rapidapi.com"

Warehouses : list all 274 warehouse codes
Product Search : search products for a postal code or warehouse
Product Details : full product sheet as sold in a warehouse
Price Drops : current price drops for a warehouse