AccommodationAvailability

List, search or filter AccommodationAvailabilities

get/v1/accommodations/availabilities

Request

  • Base URL: https://go.lts.it/api
  • URL: https://go.lts.it/api/v1/accommodations/availabilities
  • Auth: one of:
    • HTTP basic and API key in header X-LTS-ClientID
    • HTTP bearer

Query parameters

language'cs' | 'de' | 'en' | 'nl' | 'fr' | 'it' | 'pl' | 'ru'

The preferred language for the API response. Available options include cs, de, en, nl, fr, it, pl, and ru. Note If no language is specified, the API response will include all available languages. Only one language can be passed at a time.

page[size]integer

The number of records per page for the API response. Allows you to control the amount of data returned per page. Default value is 100. Maximum value is 100, unless the 'fields' parameter is passed with only 'rid' field, in this case the page size limit is unlimited.

page[number]integer

The page number for the API response. Allows you to paginate through large data sets by specifying the desired page number. Default value is 1.

searchTermstring
cacheLifeTimeInSecondsinteger
promoteBookable0 | 1
onlyBookable0 | 1
onlySuedtirolInfoActive0 | 1
language'cs' | 'de' | 'en' | 'nl' | 'fr' | 'it' | 'pl' | 'ru'
minAltitudeinteger
maxAltitudeinteger
districtRidsstring
tourismOrganizationRidsstring
marketingGroupRidsstring
accommodationRidsstring
addressGroupRidsstring
addressGroupCodesstring
categoryRidsstring
holidayPackageRidsstring
ratePlanRidsstring
ratePlanSearchTermstring
isRatePlanSpecialOffer1 | 2
startDatestring date-time
endDatestring date-time
checkAvailabilityStatus0 | 1
representationMode'minimal' | 'full'
minAmountnumber double

minimum amount for accommodation, price starting from

maxAmountnumber double
mealPlanCodes1 | 3 | 10 | 12 | 14

The API's filter parameter enables data filtering. To apply multiple filters, connect them using & e.g filter[a]=1&filter[b]=test. The available filters are: <br>filter[resultSet][rid] Filter by result set record ID. Rules:size:32, string<br>filter[resultSet][minAmount] Rules:decimal:0,2<br>filter[resultSet][maxAmount] Rules:decimal:0,2<br>filter[resultSet][filterAndSummaryGroups][0][id] ID filter for result set filters and summary groups. Rules:integer<br>filter[resultSet][filterAndSummaryGroups][0][type] Type filter for result set filters and summary groups. Rules:string, max:30, in:amenity,roomGroupAmenity,category,type<br>filter[resultSet][filterAndSummaryGroups][0][filters][0][id] ID filter for result set filters. Rules:integer<br>filter[resultSet][filterAndSummaryGroups][0][filters][0][isSelected] Selected filter for result set filters. Rules:boolean<br>filter[resultSet][filterAndSummaryGroups][0][filters][0][rids] Filter by result set filter record IDs. Rules:size:32, multiple, string<br>filter[resultSet][filterAndSummaryGroups][0][filters][0][types] Rules:array<br>filter[resultSet][filterAndSummaryGroups][0][filters][0][types][0][rid] Rules:size:32, string<br>filter[resultSet][filterAndSummaryGroups][0][filters][0][types][0][hasApartments] If true, only accommodations with apartments are considerated. Rules:boolean<br>filter[resultSet][filterAndSummaryGroups][0][filters][0][types][0][hasRooms] If true, only accommodations with rooms are considerated. Rules:boolean<br>filter[searchTerm] Search term filter. Rules:string, max:255, min:3<br>filter[cacheLifeTimeInSeconds] Rules:integer<br>filter[promoteBookable] Rules:boolean<br>filter[onlyBookable] Rules:boolean<br>filter[onlySuedtirolInfoActive] Rules:boolean<br>filter[language] Filter by language. Rules:string, in:cs,de,en,nl,fr,it,pl,ru, required_with:searchTerm<br>filter[minAltitude] Rules:integer<br>filter[maxAltitude] Rules:integer<br>filter[districtRids] Rules:multiple, size:32, string<br>filter[tourismOrganizationRids] Rules:multiple, size:32, string<br>filter[marketingGroupRids] Rules:multiple, size:32, string<br>filter[accommodationRids] Rules:multiple, size:32, string<br>filter[addressGroupRids] Rules:multiple, size:32, string<br>filter[addressGroupCodes] Rules:multiple, max:32, string<br>filter[categoryRids] Rules:multiple, size:32, string<br>filter[holidayPackageRids] Rules:multiple, size:32, string<br>filter[ratePlanRids] Rules:multiple, size:32, string<br>filter[ratePlanSearchTerm] Rules:string, max:255<br>filter[isRatePlanSpecialOffer] Rules:integer, in:1,2<br>filter[startDate] Rules:date_format:Y-m-d, required_with:ratePlanSearchTerm<br>filter[endDate] Rules:date_format:Y-m-d<br>filter[checkAvailabilityStatus] Rules:boolean<br>filter[representationMode] Rules:string, in:minimal,full<br>filter[minAmount] Rules:decimal:0,2<br>filter[maxAmount] Rules:decimal:0,2<br>filter[mealPlanCodes] Rules:multiple, in:1,3,10,12,14, integer<br>filter[types][0][rid] Rules:size:32, string<br>filter[types][0][hasRooms] Rules:boolean<br>filter[types][0][hasApartments] Rules:boolean<br>filter[accommodationAmenities][0][rids] Rules:multiple, size:32, string<br>filter[accommodationAmenities][0][id] Rules:integer<br>filter[roomGroupAmenities][0][rids] Rules:multiple, size:32, string<br>filter[roomGroupAmenities][0][id] Rules:integer<br>filter[roomOptions][0][id] Rules:integer, required_with:roomOptions<br>filter[roomOptions][0][typeBitmask] Rules:multiple, integer<br>filter[roomOptions][0][guests] Rules:integer, required_with:roomOptions<br>filter[roomOptions][0][guestAges] Rules:multiple, integer, required_with:roomOptions,roomOptions.*.guests<br>filter[roomOptions][0][minArea] Rules:integer<br>filter[roomOptions][0][bedrooms] Rules:integer

{
  "resultSet": {
    "rid": "506CD4C84CE91E080F48F355DA09465F",
    "minAmount": 23973815,
    "maxAmount": 256586,
    "filterAndSummaryGroups": [
      {
        "id": 23,
        "type": "Qui.",
        "filters": [
          {
            "id": 40,
            "rids": "EAECB2D6AAADBBD30610755899B2F859",
            "types": [
              {
                "rid": "36F60F0B517FB4664D1C69BCD991BFAD",
                "hasRooms": 1
              }
            ]
          }
        ]
      }
    ]
  },
  "searchTerm": "Cumque.",
  "cacheLifeTimeInSeconds": 1,
  "promoteBookable": 1,
  "onlyBookable": 1,
  "language": "fr",
  "minAltitude": 18,
  "maxAltitude": 44,
  "districtRids": "2E667086B5396EEA052B4DFDA04BAADC",
  "tourismOrganizationRids": "C1F18FE888996BFCDDC2650C2C7B2430",
  "marketingGroupRids": "6D65E92A99912BAA259535EFE5EB5DE2",
  "accommodationRids": "4A276CF4928C8A9FBFF37C06FC95452C",
  "addressGroupRids": "C78945B40B341D7439F250D2E44CE850",
  "addressGroupCodes": "Fuga et.",
  "categoryRids": "99F3FD51BEFECBC20B07B46450C423E5",
  "holidayPackageRids": "A8D30DFDAF0BCAA32553BE0DC80274DA",
  "ratePlanRids": "EA711651ACF41C633B23227C023F535D",
  "ratePlanSearchTerm": "Eius et.",
  "startDate": "1964-02-18",
  "endDate": "1939-11-30",
  "representationMode": "minimal",
  "minAmount": 32038,
  "maxAmount": 2788691,
  "types": [
    {
      "rid": "045238646B5240079A98DD70623682DD",
      "hasRooms": 1
    }
  ],
  "accommodationAmenities": [
    {
      "rids": "ED3D6BCDAF21E4D8A22CB1D17D6D8DDA",
      "id": 71
    }
  ],
  "roomGroupAmenities": [
    {
      "rids": "4AF5AD2C079DF0F330AD120ED7EAF9AA",
      "id": 27
    }
  ],
  "roomOptions": [
    {
      "id": 11,
      "typeBitmask": 3,
      "guests": 74,
      "guestAges": 40,
      "minArea": 55,
      "bedrooms": 45
    }
  ]
}
sortstring

Requests for retrieved resources to be sorted by the value some selected field. Sorting requests may be in ascending (e.g., sort=startDate) or descending order (e.g., sort=-length) by prefixing the field name with a MINUS (U+002D) character. If the sort value includes a language, the language parameter is also required. Sorting is available over (rating,price,category,random) the primitive attributes of an endpoint's resources.

fieldsstring

Selects which fields (i.e., attributes or relationships) should be present in returned resource. To exclude a field, add a "-" before its value. Multiple fields can be passed separated by a comma ",". If only "rid" or "id" is passed, pagination size is unlimited by default. (e.g. accommodation.rid,minAmount,roomOptions.*.roomGroup.rid,roomOptions.*.availableRooms,roomOptions.*.bookableRooms,roomOptions.*.rates.*.roomOptionId,roomOptions.*.rates.*.isBookable,roomOptions.*.rates.*.isSpecialOffer,roomOptions.*.rates.*.ratePlan.rid,roomOptions.*.rates.*.allInclusiveAmount,roomOptions.*.rates.*.bedAndBreakfastAmount,roomOptions.*.rates.*.fullBoardAmount,roomOptions.*.rates.*.halfBoardAmount,roomOptions.*.rates.*.roomOnlyAmount,resultSet.rid,resultSet.minAmount,resultSet.maxAmount,resultSet.lowestMinAmount,resultSet.highestMaxAmount,resultSet.filterAndSummaryGroups.*.id,resultSet.filterAndSummaryGroups.*.type,resultSet.filterAndSummaryGroups.*.filters.*.id,resultSet.filterAndSummaryGroups.*.filters.*.isSelected,resultSet.filterAndSummaryGroups.*.filters.*.quantity,resultSet.filterAndSummaryGroups.*.filters.*.rids,resultSet.filterAndSummaryGroups.*.filters.*.types.*.rid,resultSet.filterAndSummaryGroups.*.filters.*.types.*.hasApartments,resultSet.filterAndSummaryGroups.*.filters.*.types.*.hasRooms).

Response

successful operation

successboolean required

Example response

{
  "success": true,
  "data": [
    {
      "accommodation": {
        "rid": "AC38B495C6BFBD6562C3FA971F9EC1A8"
      },
      "minAmount": 9,
      "roomOptions": [
        {
          "roomGroup": {
            "rid": "00A4A93255052ECF34565A144B32A6C6"
          },
          "availableRooms": 45,
          "bookableRooms": 88,
          "rates": [
            {
              "roomOptionId": 34,
              "isBookable": true,
              "ratePlan": {
                "rid": "2EAFA212C127C7BF6768CD0F6822B2F3"
              },
              "allInclusiveAmount": 24,
              "bedAndBreakfastAmount": 85498,
              "halfBoardAmount": 32376616,
              "roomOnlyAmount": 114804
            }
          ]
        }
      ],
      "resultSet": {
        "rid": "CF82627F44E722939F81DA7B88550D49",
        "minAmount": 3129,
        "maxAmount": 249530806,
        "lowestMinAmount": 8503495,
        "highestMaxAmount": 358,
        "filterAndSummaryGroups": [
          {
            "id": 43,
            "type": "Ut sit.",
            "filters": [
              {
                "id": 92,
                "quantity": 70,
                "rids": [
                  "F7EAD71FDD14E061D00CAC9C7466C52E"
                ],
                "types": [
                  {
                    "rid": "E4A60E1DB5BE0DB123F7C8F109852024"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ],
  "resultSet": {
    "rid": "655309E74226F9C964F4FFC6DBC52814",
    "filterAndSummaryGroups": [
      {
        "id": 4,
        "type": "amenity",
        "filters": [
          {
            "id": 22,
            "count": 2,
            "rids": [
              "F56A631D32900C74DD3581C19B358608"
            ]
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.