POST
/shopCreate Shop
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. Example: 2-10,15,20-25. Negative values, repeated values, overlapping values, and invalid ranges are rejected.
- •horizonRange: Specific future dates or date ranges in YYYY/MM/DD format. Example: 2026/08/18,2026/08/20-2026/08/25. Past dates, duplicate dates, and overlapping ranges are rejected.
- •market: City name. Must match a market returned by the Post/market endpoint.
- •websiteCode: Website code associated with the shop.
- •shopType: Shop type: 1 = lar, 2 = bar, 3 = lar & bar.
- •destId: Destination ID. Must match a destination returned by the Post/market endpoint.
- •destType: Destination type. Must match a destination type returned by the Post/market endpoint.
- •city: Name of the city.
POST
/shopMandatory Fields
- name
- market
- websiteCode
- shopType
- destId
- destType
- At least one of: horizon, horizonExpression, or horizonRange
Note
One of: horizon, horizonRange or horizonExpression - Is Required
Parameter Details
| Name | In | Type | Required | Description |
|---|---|---|---|---|
» name | body | string | Required | Name of the shop. |
» horizon | body | number | Optional | Number of future days from today to retrieve rates. |
» horizonRange | body | string | Optional | Specific future dates or date ranges in YYYY/MM/DD format. |
» horizonExpression | body | string | Optional | Custom days in the future. E.g., 2-10,15,20-25. |
» market | body | string | Required | City name. (Market should be defined as it is listed in the Post/market endpoint results) |
» websiteCode | body | number | Required | The website code to be included in the shop. |
» shopType | body | number | Required | 1-lar, 2-bar, 3-(lar & bar) |
» destId | body | string | Required | Destination ID. Must match a destination returned by the Post/market endpoint. |
» destType | body | string | Required | Destination type. Must match a destination type returned by the Post/market endpoint. |
» city | body | string | Optional | Name of the city. |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | OK | 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}'Body parameter
{
"name": "string",
"horizon": 365,
"horizonExpression": "",
"horizonRange": "",
"market": "string",
"websiteCode": 0,
"shopType": 0,
"destId": "string",
"destType": "string",
"city": ""
}
Example responses
201 Response
{
"message": "Shop Created Successfully",
"shopId": 0
}Example Request 1
{
"name": "Test Shop",
"horizon": 3,
"horizonExpression": "",
"horizonRange": "",
"market": "Hendon, Greater London, United Kingdom",
"websiteCode": 2,
"shopType": 1,
"destId": "-2598506",
"destType": "CITY",
"city": ""
}
Example Request 2
{
"name": "Test Shop",
"horizon": 0,
"horizonExpression": "0-5",
"horizonRange": "",
"market": "Hendon, Greater London, United Kingdom",
"websiteCode": 2,
"shopType": 1,
"destId": "-2598506",
"destType": "CITY",
"city": ""
}
Example Request 3
{
"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"
}
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.