Validate Postal Code
Check whether Instabee operates home return pickup in a given postal code area. This is the first step — validate before offering the home return option to the consumer. A 200 response means we pick up in that area; a 404 means it is not serviceable.
Endpoint
1GET /availability/countries/{countryCode}/postal-codes/{postalCode}/delivery-options?brand={brand}&product=HOME_RETURN1GET /availability/countries/{countryCode}/postal-codes/{postalCode}/delivery-options?brand={brand}&product=HOME_RETURN
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
countryCode | string | required | Country code (BE, DK, FI, NL, NO, SE) |
postalCode | string | required | Postal code to validate |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brand | string | required | Your brand identifier (e.g. budbee, porterbuddy) |
product | string | required | Must be HOME_RETURN |
Response
A 200 response indicates that home return pickup is available for the requested postal code. A 404 response means the postal code is not serviceable.
| Status Code | Description |
|---|---|
200 | Home return pickup is available for this postal code |
404 | Postal code is not serviceable |