Packages and extras

Extras that can be sold with a booking: room packages (tied to a room type) and general packages (transfer, dinner, spa). Sold packages are sent in the booking push as extras[].

GET/external/stock/packagesList packages

List packages#

GET/external/stock/packages

Authentication: Authorization: Bearer

Returns the packages the hotel sells online. priceType says whether the price is nightly or one-time, pricePlan whether it is per person or per room.

Query parameters

hotelIDintegerrequired

Hotel ID.

packageTypeinteger

1 room packages, 2 general packages. Empty for all.

12

languageIDintegerdefault: 1

Language ID for package names (Languages).

limitintegerdefault: 20

Records per page.

pageintegerdefault: 1

Page number.

orderstring

Sort by id, baslik or fiyat; prefix - for descending.

Response

200 Success.

Request

curl "https://test.hms.gen.tr/external/stock/packages?hotelID=1000&packageType=2&limit=20&page=1" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/stock/packages?hotelID=1000&packageType=2&limit=20&page=1", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/stock/packages?hotelID=1000&packageType=2&limit=20&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Response · 200

{
    "success": true,
    "count": 2,
    "items": [
        {
            "id": 12,
            "name": "Dinner",
            "image": "/images/1000/stock/t-aksam-yemegi.jpg",
            "quantity": 0,
            "stockTracking": false,
            "salePrice": "400.00",
            "saleCurrency": "TRY",
            "saleCurrencyId": 1,
            "priceType": "nightly_price",
            "pricePlan": "price_per_person",
            "roomTypeId": null,
            "roomTypeName": null,
            "stockCategory": {
                "id": 4,
                "name": "Food & Beverage"
            }
        },
        {
            "id": 15,
            "name": "Airport Transfer",
            "image": null,
            "quantity": 0,
            "stockTracking": false,
            "salePrice": "1500.00",
            "saleCurrency": "TRY",
            "saleCurrencyId": 1,
            "priceType": "one_time_price",
            "pricePlan": "price_per_room",
            "roomTypeId": null,
            "roomTypeName": null,
            "stockCategory": {
                "id": 7,
                "name": "Transfer"
            }
        }
    ]
}

Last updated: 8 September 2026Found a mistake? Let us know