/shopCreate Shop
Create Shop
Implementation Notes
This endpoint allows you to create a shop, specifying a combination of market, websiteCode, and horizon.
The maximum value for horizon is 365 days, and at least one of horizon, horizonExpression, or horizonRange must be provided.
Parameters:
name:Name of the shop.horizon:Number of future days from today to retrieve rates.horizonExpression:Custom days in the future. E.g.,2-10,15,20-25. Negative values, repeated values, overlapping values, and ranges where start is not less than end are rejected.horizonRange:Specific future dates or date ranges inYYYY/MM/DDformat. E.g.,2026/08/18,2026/08/20-2026/08/25. Past dates, duplicate dates, and overlapping ranges are rejected.market:City name. (Market should be defined as it is listed in the Post/market endpoint results)websiteCode:The website code to be included in the shop.shopType:1-lar, 2-bar, 3-(lar & bar)destId:Destination ID. (Destination ID should be defined as it is listed in the Post/market endpoint results)destType:Destination type. (Destination type should be defined as it is listed in the Post/market endpoint results)city:Name of the city.
Mandatory Fields:
name,market,websiteCode,shopType,destId,destType- At least one of:
horizon,horizonExpression, orhorizonRange
Examples:
{ "name": "Test Shop", "horizon": 3, "horizonExpression": "", "horizonRange": "", "market": "Hendon, Greater London, United Kingdom", "websiteCode": 2, "shopType": 1, "destId": "-2598506", "destType": "CITY", "city": "" }
{ "name": "Test Shop", "horizon": 0, "horizonExpression": "0-5", "horizonRange": "", "market": "Hendon, Greater London, United Kingdom", "websiteCode": 2, "shopType": 1, "destId": "-2598506", "destType": "CITY", "city": "" }
{ "name": "US Shop", "horizon": 0, "horizonExpression": "", "horizonRange": "2026/12/18,2026/12/20-2026/12/25", "market": "Hendon, Greater London, United Kingdom", "websiteCode": 2, "shopType": 1, "destId": "-2598506", "destType": "CITY", "city": "New York" }
/shopParameter Details
| Name | In | Type | Required | Description |
|---|---|---|---|---|
body | body | object | Required | none |
» name | body | string | Required | none |
» horizon | body | number | Optional | none |
» horizonExpression | body | string | Optional | none |
» horizonRange | body | string | Optional | none |
» market | body | string | Required | none |
» websiteCode | body | number | Required | none |
» shopType | body | number | Required | none |
» destId | body | string | Required | none |
» destType | body | string | Required | none |
» city | body | string | Optional | none |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Shop Created Successfully | |
| 400 | Bad Request | Bad Request | None |
| 401 | Unauthorized | Authentication Failed or Account validity Expired | None |
| 429 | Too Many Requests | Too Many Requests | None |
| 500 | Internal Server Error | Internal Server Error | None |
Example Request
# You can also use wget
curl -X POST /shop \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
Example responses
{
"name": "Test Shop",
"horizon": 3,
"horizonExpression": "",
"horizonRange": "",
"market": "Hendon, Greater London, United Kingdom",
"websiteCode": 2,
"shopType": 1,
"destId": "-2598506",
"destType": "CITY",
"city": ""
}Body parameter
{
"name": "string",
"horizon": 365,
"horizonExpression": "",
"horizonRange": "",
"market": "string",
"websiteCode": 0,
"shopType": 0,
"destId": "string",
"destType": "string",
"city": ""
}
Example responses
{
"message": "Shop Created Successfully",
"shopId": 0
}
Need Support?
Our team is here to help you integrate and make the most of our APIs. Get in touch for technical support, custom solutions, or any questions.