E-mail address
Password
 
Forgot your password? ?
E-mail address
Live Chat
Contact phone
United Kingdom
0808 168 3471
Business hours
Mon - Fri
08:00h - 16:00h

API documentation

Version 1.2

About

Adriatic.hr Web Service is a web API [?], based on REST [?], which allows communication between yours and Adriatic.hr web site. Thanks to it, visitors of your web site can search, preview and place order for any service in our offering, without leaving your web site.

It can be used by calling the access URL - https://www.adriatic.hr/services/rest/. Actually, this URL is only an endpoint and you need to provide some additional information in the form of GET/POST parameters. Every call to the specified URL should be accompanied with at least two special parameters - method name and application ID - but actual number of parameters depends of method. Here is the list of all special parameters:

  • method - web service (method) name (required)
  • aid - application ID; this is your unique ID information which will be generated for you after opting for our web services (required)
  • lang - two-letter language code (according to ISO 639-1 standard) in lowercase, used to localize results (if needed); defaults to en - english. (not required)
  • sig - request signature. Composed of name of the method that is called, application ID and (encrypted) unique private key. Used ONLY in combination with SSL[?] (Secure Sockets Layer) protocol to secure the communication. (required from 01.01.2011)
    • sig generation: md5("method_called;aid;md5_of_private_key")
    • example in PHP: md5("Private_getHouse;af151;" . md5("private_key"))
    • usage: https://www.adriatic.hr/services/rest/?
      method=Private_getHouse&id=1005&aid=
      af151&lang=en&sig=6f0dcac4960e0eab40c4bdc1d42b6c03
Methods of our web service are divided into the following groups (namespaces):
  • Private accommodation - namespace Private
  • Geography locations - namespace Geo
  • Ordering process - namespace Order
  • System/helper/common - namespace System

Usage

The following example retrieves data of private accommodation house with ID 1005. Click on preview link to see the service result.
https://www.adriatic.hr/services/rest/
  ?method=Private_getHouse
  &id=1005
  &aid=af151
  &lang=en
  &sig=6f0dcac4960e0eab40c4bdc1d42b6c03


Each parameter is specified inside URL as name=value pair. The method parameter specifies service method to be invoked. All subsequent parameters are parameters passed to specified method. Some method parameters are optional while others are required to be set - faling to specifiy the required parameter will result in error.

Methods

Here is the list of supported service methods. Request parameters written in bold are required.

Many response elements contain special boolean attribute na. It stands for "not available" and means that element value is unknown (null). This attribute exist only for elements which value can be unknown.

Possible response statuses are success and failure.

Private_find

Search private accommodation. Method is pagination aware (results are split across multiple pages).

Request parameters

i_fromdateBegin of interval. Allowed formats are YYYY-MM-DD and unix timestamp.
i_todateEnd of interval. Allowed formats are YYYY-MM-DD and unix timestamp.
i_devboolAllow slight shifting of given date interval to find more accommodation units. Default value is TRUE.
i_subboolLook for subinterval of given interval, instead of just given interval. Subinterval is limited by len_min and len_max parameters. If interval is not set, main season is used (june, july and august). This parameter is handy if you want to find units available, e.g., in main season (when most of them are not available). Default value is FALSE.
len_minintMinimum number of nights. Used only if i_sub is true. Default value is 1.
len_maxintMaximum number of nights. Used only if i_sub is true. Default value is 6.
ttypeComma delimited list of accommodation unit types. Example: "apartment,room". Supported types are:
  • house
  • apartment
  • studio-apartment
  • room
idintComma delimited list of house IDs. Example: "1005,1006". Use case example - if you want to get a price range of desired house(s).
id_refintReferent house ID, used for distance sort type.
coord_latfloatReferent latitude coordinate, used for distance sort type.
coord_lngfloatReferent longitude coordinate, used for distance sort type.
kit_roomboolUse of the kitchen for unit type room.
pintNumber of persons.
p_distboolAllow to split persons in more than one accommodation unit inside house. Default value is FALSE.
cattypeHouse category. Supported types are:
  • luxury
  • pool
  • house
  • pension
  • family_owned_hotel
  • family_friendly
  • beach
  • quiet
  • robinson
Supports multiple values separated by ',' (AND operator) or '|' (OR operator).
pos_flintFloor. Value of zero represent ground floor, negative values represent basement floors. Supports multiple values separated by '|' (OR operator).
prc_minfloatMinimal price in EUR (per day). Default value is 0.
prc_maxfloatMaximal price in EUR (per day).
prc_lowboolLow-price accommodation.
dcboolDiscount accommodation (any type of discount).
dc_ttypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
qstringKeywords for textual search (geography location names only).
lstringGeography location ID.
pl_isolboolPlace in isolation. This element is deprecated. See isolation.
ri_ttypeRiviera type. Supported types are:
  • mainland
  • mainland_river
  • island
  • islands
  • island_bridge
  • peninsula
Supports multiple values separated by '|' (OR operator).
landtypeLand type. Supported types are:
  • mainland
  • island_bridge
  • island
Supports multiple values separated by '|' (OR operator).
pl_ttypePlace type. Supported types are:
  • large_city
  • tourist_city
  • small_city
  • cove
Supports multiple values separated by '|' (OR operator).
be_ttypeBeach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva
Supports multiple values separated by '|' (OR operator).
be_dintMaximal house to beach distance.
isolationboolHouse is located in isolation.
poolboolHouse with pool.
acboolAccommodation unit with air conditioner.
stvboolAccommodation unit with satellite TV.
foodboolHouse with food service.
petboolHouse with pet approval.
boatboolHouse with boat rent service.
moorboolHouse with boat moor.
outer_view_seaboolHouse with sea view.
outer_grillboolHouse with outer grill.
inetboolHouse with internet.
disboolUnit access suitable for disabled persons.
bedroomsintNumber of bedrooms. It can be used in combination with p_dist param.
more_bathroomsboolAccommodation unit has two or more bathrooms, omitted when p_dist param is set.
obboolOnline booking - Book the apartment right away! Adriatic.hr guarantees the availability of facilities in this program.
sorttypeSort criterion. Supported types are:
  • standard
  • price
  • beach - Distance from the beach.
  • centre - Distance from the town centre.
  • grade - Guest grade average.
  • distance - Houses that have straight line distance from the referent house(defined by the id_ref parameter) shorter than 1000m. If the referent house does not have GPS coordinates defined, result set is empty.
Default value is standard.
sort_dirtypeSort direction. Supported types are:
  • asc - Ascending
  • desc - Descending
Default value is asc.
pageintPage number. Default value is 1.
limitintNumber of results per page (max. 25). Default value is 10.

Response

<list> - List data
itemsarrayItems on current page. Array of <item> elements. See <item> (List item data) for details.
pagersetSet of pager elements. See <pager> (List pager data) for details.
<item> - List item data
housesetFound house. See <house> (House data) for details. Element has the following attributes:
  • id [int]: House ID.
unitsarrayAccommodation units which belongs to house from the same <item> element. Only units that match search criteria are enlisted here. Array of <unit> elements. See <unit> (Accommodation unit data) for details.
<pager> - List pager data
totalItemsintTotal items that match search criteria.
totalPagesintTotal pages.
currentPageintCurrent page.
pageLimitintMaximum number of items per page.
<house> - House data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: House ID.
namestringHouse name.
capacityintNumber of beds.
foodboolFood service available?
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
directBookingboolAvailability status is accurate - order is possible without agency confirmation?
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria). Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
geosetGeography location. See <geo> (Geography location data) for details.
distancesetDistances. See <distance> (Distance data) for details.
categoriesarrayCategories which house belongs to. Array of <category> elements. See <category> (House category data) for details.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit (see Private_getUnit response), whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
relatesetRelated houses. See <relate> (Related objects) for details.
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
imagearrayImage of house. Array of <variant> elements. See <variant> (Image variant data) for details.
<unit> - Accommodation unit data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Accommodation unit ID.
namestringName.
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
typetypeType. Supported types are:
  • house
  • apartment
  • studio-apartment
  • room
labelstringAccommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
capacitysetCapacity data. See <capacity> (Capacity data) for details.
classsetClassification data. See <class> (Accommodation unit classification data) for details.
priceRangearrayAccommodation unit price range (discounts are applied if available). Contains two amounts (range), single amount (exact price is known) or no amounts (price is unknown). Value depends on search parameters used (date interval and number of persons). Array of <amount> elements. See <amount> (Price amount (per day).) for details.
regularPriceRangearrayAccommodation unit price range without discounts. Contains two amounts (range), single amount (exact price is known) or no amounts (price is unknown). Value depends on search parameters used (date interval and number of persons). Array of <amount> elements. See <amount> (Price amount (per day).) for details.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit, whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
lowPriceboolAccommodation unit has a low price?
imagearrayImage of house. Array of <variant> elements. See <variant> (Image variant data) for details.
<unit> - Accommodation unit reference data
selfstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
  • capacityBasic [int]: Basic capacity of the accommodation unit.
  • capacityAdditional [int]: Additional capacity of the accommodation unit.
<geo> - Geography location data
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
placestringPlace name. Element has the following attributes:
  • id [string]: Place ID.
  • isletName [string]: Islet name, if set, the place is located on a islet.
beachnullBeach placeholder - beaches does not have names, only IDs. Element has the following attributes:
  • id [string]: Beach ID.
<distance> - Distance data
beachintDistance from beach (meters).
houseintDistance from the referent house (meters) - available if sort type is "distance" and id_ref parameter is provided.
currentLocationintDistance from the referent coordinates (meters) - available if coord_lat, coord_lng parameters are provided. Default sort type is "distance". If object is closer than 1000 m method returns 1000 m
<category> - House category data
selftypeHouse category. Supported types are:
  • luxury
  • pool
  • house
  • pension
  • family_owned_hotel
  • family_friendly
  • beach
  • quiet
  • robinson
<discount> - Discount/additional payment data
typetypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
namestringName.
valuesetPercent, money or freeDays value. See <value> (Discount/additional payment value) for details.
<relate> - Related objects
existboolIs object related with any other object?
housesarrayOther houses that are related to this house. Array of <house> elements. See <house> (Related House element) for details.
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large (max. 365px, horizontal or vertical)
    • s - small (115x86px)
    • m - medium (200x133px)
    • o - small medium (150x100px)
    • xl - extra large (max. height 600px)
urlstringImage variant URL.
<rating> - Ratings (1-5)
placeintAverage place rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
beachintAverage beach rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
accomodationintAverage accomodation rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
hostintAverage host rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
totalintTotal average rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
<capacity> - Capacity data
totalintTotal number of beds.
basicintNumber of basic (main) beds.
additionalintNumber of additional beds.
<class> - Accommodation unit classification data
official intOfficial classification mark (by Croatian authority).
adriaticfloatAdriatic.hr classification mark.
<amount> - Price amount (per day).
selffloatPrice amount. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
<value> - Discount/additional payment value
Percent, money or freeDays amount. Negative values are discounts, positive values are additional payments.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Value type. Supported types are:
    • percent
    • amount
    • extra_day
percentfloatPercent value.
amountfloatMoney amount value. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
freeDaysintNumber of free days. Element has the following attributes:
  • total [int]: Total number of days.
<house> - Related House element
namestringHouse name
capacityintNumber of beds
sameBuildingboolThis house belong to the same building.

Example usage

Find apartments available in date interval 2015-08-09 to 2015-08-15.

https://www.adriatic.hr/services/rest/
  ?method=Private_find
  &i_from=2015-08-09
  &i_to=2015-08-15
  &t=apartment
  &aid=af151
  &lang=en
  &sig=e449a43f7f2c6ac9e4af475d0607c5c1

Private_findReviews

Search guest comments for objects. Method is pagination aware (results are split across multiple pages).

Request parameters

idintObject ID. This parameter is required.
pageintPage number. Default value is 1.
limitintNumber of results per page (max. 25). Default value is 10.

Response

<list> - List data
itemsarrayItems on current page. Array of <item> elements. See <item> (List item data) for details.
pagersetSet of pager elements. See <pager> (List pager data) for details.
<item> - List item data
unitstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
idintReview id.
authorstringReview author name.
createddatetimeReview creation time. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
customerboolAdriatic.hr customer.
reviewstringReview text. Element has the following attributes:
  • deleted [bool]: Has the review been deleted due to inappropriate contents?
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
<pager> - List pager data
totalItemsintTotal items that match search criteria.
totalPagesintTotal pages.
currentPageintCurrent page.
pageLimitintMaximum number of items per page.
<rating> - Ratings (1-5)
placeintPlace rating.
beachintBeach rating.
accomodationintAccomodation rating.
hostintHost rating.

Example usage

Find reviews for object with ID 1005.

https://www.adriatic.hr/services/rest/
  ?method=Private_findReviews
  &id=1005
  &aid=af151
  &lang=en
  &sig=d5f34cd9084c08130929e02b57b0630f

Private_getHouse

Retrieve house data.

Request parameters

idintHouse ID. This parameter is required.

Response

<house> - House data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: House ID.
namestringHouse name.
capacityintNumber of beds.
publishDatedateHouse publish date. Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
postalCodestringPostal code.
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
directBookingboolAvailability status is accurate - order is possible without agency confirmation?
preferredReservationsarrayAll prefered reservations by the lessor. Array of <period> elements. See <period> (Period of prefered reservation.) for details.
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria). Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
geosetGeography location. See <geo> (Geography location data) for details.
exteriorsetHouse exterior. See <exterior> (Exterior data) for details.
servicesetAvailability and details of services. See <service> (Service data) for details.
distancesetDistances. See <distance> (Distance data) for details.
locationsetLocation data. See <location> (Location data) for details.
communicationsetPossibilities of communication inside house. See <communication> (Communication data) for details.
categoriesarrayCategories which house belongs to. Array of <category> elements. See <category> (House category data) for details.
robinsonsetList of items related to "Robinson Crusoe style" type of tourism. See <robinson> (Robinson tourism data) for details.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit (see Private_getUnit response), whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
lowPriceboolHouse contains at least one unit that has a low price?
relatesetRelated houses. See <relate> (Related objects) for details.
notesarrayAdditional house characteristics. Array of <note> elements. See <note> (Additional house characteristic) for details.
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
imagesarrayHouse images. Array of <image> elements. See <image> (House image) for details.
descriptionsetObject description. See <description> (Object description) for details.
guidesetObject tourist guide. See <guide> (Object location tourist guide) for details.
<period> - Period of prefered reservation.
selfn/a Element has no value. Element has the following attributes:
  • arrivalDay [type]: Prefered reservation arrival day Supported types are:
    • monday
    • tuesday
    • wednesday
    • thursday
    • friday
    • saturday
    • sunday
  • departureDay [type]: Prefered reservation departure day Supported types are:
    • monday
    • tuesday
    • wednesday
    • thursday
    • friday
    • saturday
    • sunday
<unit> - Accommodation unit reference data
selfstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
  • capacityBasic [int]: Basic capacity of the accommodation unit.
  • capacityAdditional [int]: Additional capacity of the accommodation unit.
<geo> - Geography location data
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
placestringPlace name. Element has the following attributes:
  • id [string]: Place ID.
beachnullBeach placeholder - beaches does not have names, only IDs. Element has the following attributes:
  • id [string]: Beach ID.
<exterior> - Exterior data
disabledPersonsboolIs suitable for disabled persons?
courtyardsetExistence and description of courtyard. See <courtyard> (Courtyard data) for details.
infieldtypeInfield description. Supported types are:
  • decorated
  • tidy
  • messy
  • none
underConstructionboolObject is under construction?
facadeUncompletedboolObject facade is uncompleted?
poolsetAvailability and terms of pool usage. See <pool> (Pool data) for details.
parkingsarrayArray of parking units. Array of <parking> elements. See <parking> (Multiple parking data.) for details.
grillsarrayList of grills available. Array of <grill> elements. See <grill> (Grill data) for details. This element is deprecated. See <fixedGrill> (Fixed grill data).
fixedGrillsetFixed grills. See <fixedGrill> (Fixed grill data) for details.
showerboolHas shower in the courtyard?
<service> - Service data
checkinsetCheckin service data. See <checkin> (Checkin service data) for details.
ecoTaxsetEcological taxation service data. See <ecoTax> (Ecological taxation service data) for details.
insurancesetMandatory insurance service data. See <insurance> (Mandatory insurance service data) for details.
phonesetPhone usage data. See <phone> (Phone service data) for details. This element is deprecated.
faxsetFax usage data. See <fax> (Fax service data) for details. This element is deprecated.
internetsetInternet access usage data. See <internet> (Internet access service data) for details.
foodsetFood service data. See <food> (Food service data) for details.
laundrysetLaundry service outside of the accommodation unit data. See <laundry> (Laundry service outside of the accommodation unit data) for details.
boatsetBoat usage data. See <boat> (Boat service data. Service available on request) for details.
moorsetMoor usage data. See <moor> (Moor service data. Service available on request) for details.
petsetUnit with pet approval. See <pet> (Pet service data) for details.
ironsetIron. See <iron> (Equipment data: Iron) for details.
ironingBoardsetIroning board. See <ironingBoard> (Equipment data: Ironing board) for details.
hairDryersetHair dryer. See <hairDryer> (Equipment data: Hair dryer) for details.
portableGrillsetPortable grill. See <portableGrill> (Portable grill data) for details.
bicyclesetbicycle. See <bicycle> (Equipment data: Bicycle) for details.
rentAScootersetrent-a-scooter. See <rentAScooter> (Rent-a-scooter) for details.
rentACarsetrent-a-car. See <rentACar> (Rent-a-car) for details.
tableTennissetTable tennis. See <tableTennis> (Table tennis) for details. This element is deprecated.
fitnesssetGym. See <fitness> (Equipment data: Gym) for details. This element is deprecated.
beachUmbrellasetSun umbrellas. See <beachUmbrella> (Equipment data: Sun umbrellas) for details.
deckChairsetDeckchairs. See <deckChair> (Equipment data: Deckchairs) for details.
fansetVentilators. See <fan> (Equipment data: Ventilators) for details. This element is deprecated.
transportsetShuttle service. See <transport> (Service data: Shuttle service) for details.
infantBedsetInfant bed. See <infantBed> (Infant bed data) for details.
extraBedsetExtra bed. See <extraBed> (Extra bed data) for details.
extraBabysetOne baby up to 4 years (with no extra bed) is allowed. See <extraBaby> (One baby up to 4 years (with no extra bed) is allowed data) for details.
smokingsetSmoking allowed. See <smoking> (Smoking data) for details.
smokingTerracesetSmoking allowed at the terrace. See <smokingTerrace> (Smoking at the terrace data) for details.
tvJointRoomsetTV in the common room. See <tvJointRoom> (Equipment data: TV in the common room) for details.
sharedFridgesetShared refrigerator. See <sharedFridge> (Equipment data: Shared fridge) for details.
sharedFreezersetShared freezer. See <sharedFreezer> (Equipment data: Shared freezer) for details.
luxurysetLuxury services. See <luxury> (Luxury services.) for details.
<distance> - Distance data
seaintDistance from sea (meters).
beachintDistance from beach (meters).
shopintDistance from shop (meters). Element has the following attributes:
  • inHouse [bool]: Shop is located in the facility?
restaurantintDistance from restaurant (meters). Element has the following attributes:
  • inHouse [bool]: Restaurant is located in the facility?
ambulanceintDistance from ambulance (meters). Element has the following attributes:
  • inHouse [bool]: Ambulance is located in the facility?
postOfficeintDistance from post office (meters). Element has the following attributes:
  • inHouse [bool]: Post office is located in the facility?
discointDistance from disco (meters). Element has the following attributes:
  • inHouse [bool]: Disco is located in the facility?
hotelPoolintDistance from hotel pool (meters). Element has the following attributes:
  • inHouse [bool]: Hotel pool is located in the facility?
sportsGroundintDistance from sports ground (meters). Element has the following attributes:
  • inHouse [bool]: Sports ground is located in the facility?
divingintDistance from diving center (meters). Element has the following attributes:
  • inHouse [bool]: Diving center is located in the facility?
pharmacyintDistance from pharmacy (meters). Element has the following attributes:
  • inHouse [bool]: Pharmacy is located in the facility?
atmintDistance from atm (meters). Element has the following attributes:
  • inHouse [bool]: Atm is located in the facility?
internetCaffeintDistance from internet caffe (meters). Element has the following attributes:
  • inHouse [bool]: Internet caffe is located in the facility?
exchangeOfficeintDistance from exchange office (meters). Element has the following attributes:
  • inHouse [bool]: Exchange office is located in the facility?
touristInfointDistance from tourist info (meters). Element has the following attributes:
  • inHouse [bool]: Tourist info is located in the facility?
infirmaryintDistance from infirmary (meters). Element has the following attributes:
  • inHouse [bool]: Infirmary is located in the facility?
airportintDistance from airport (meters). Element has the following attributes:
  • inHouse [bool]: Airport is located in the facility?
autocampintDistance from autocamp (meters). Element has the following attributes:
  • inHouse [bool]: Autocamp is located in the facility?
golfCourseintDistance from golf course (meters). Element has the following attributes:
  • inHouse [bool]: Golf course is located in the facility?
tennisCourtintDistance from tennis court (meters). Element has the following attributes:
  • inHouse [bool]: Tennis court is located in the facility?
playgroundintDistance from playground (meters). Element has the following attributes:
  • inHouse [bool]: Playground is located in the facility?
This element is deprecated.
nationalParkintDistance from entrance of the national park (meters). Element has the following attributes:
  • inHouse [bool]: Facility is located in the national park?
otherParkingintDistance of public parking or parking that is charged extra from facility. Element has the following attributes:
  • inHouse [bool]: Parking is located within the facility?
centreintDistance from place center (meters).
<location> - Location data
notByTheRoadboolIs not by the road?
byD8RoadboolIs near Adriatic Highway?
byMainRoadboolIs near main road?
byLocalRoadboolIs near local road?
noRoadBeforeBeachboolIs there no road between house and beach?
roadD8BeforeBeachboolIs there a Adriatic Highway between house and beach?
mainRoadBeforeBeachboolIs there a main road between house and beach?
localRoadBeforeBeach boolIs there a local road between house and beach?
overpassBeforeBeachboolIs there a overpass between house and beach?
underpassBeforeBeach boolIs there a underpass between house and beach?
nearBeachboolIs near beach?
stairsToBeachintNumber of stairs between house and beach.
reachableByCarboolIs object reachable by car? Element has the following attributes:
  • carApproachDistance [int]: Nearest car approach distance.
slopeboolAccess by slope road? Element has the following attributes:
  • length [int]: Length (m).
macadamboolAccess by macadam road? Element has the following attributes:
  • length [int]: Length (m).
narrowStreetboolAccess by narrow street? Element has the following attributes:
  • length [int]: Length (m).
highUndercarriageboolRoad is not suitable for cars with low undercarriage?
accessByBoatboolObject accessible only by boat?
boatTransferUnavailableboolBoat transfer offer is unavailable?
boatLineNoCarsboolBoat line transfer is available but not for cars?
boatTransferOffersetBoat transfer offer by lessor. See <boatTransferOffer> (Boat transfer offer data) for details.
parkDistanceintDistance from nearest parking place (meters). This element is deprecated.
noisePollutiontypeNoise pollution. Supported types are:
  • low
  • medium
  • high
  • potential
isolationboolHouse is isolated?
greenerytypeGreen vegetation. Supported types are:
  • high
  • medium
  • none
<communication> - Communication data
hostPresentboolIs host presence possible?
otherGuestsboolIs other guests presence possible (in accommodation units outside of our offering)?
hostLanguagesarrayForeign languages which the host is familiar with. Array of <language> elements. See <language> (Host foreign language data) for details.
<category> - House category data
selftypeHouse category. Supported types are:
  • luxury
  • pool
  • house
  • pension
  • family_owned_hotel
  • family_friendly
  • beach
  • quiet
  • robinson
<robinson> - Robinson tourism data
watersetWater availability data. See <water> (Water availability data) for details.
waterHeatingsetWater heating data. See <waterHeating> (Water heating data) for details.
powersetPower data. See <power> (Power data) for details.
othersetOther data. See <other> (Other robinson tourism related data) for details.
<discount> - Discount/additional payment data
typetypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
namestringName.
valuesetPercent, money or freeDays value. See <value> (Discount/additional payment value) for details.
<relate> - Related objects
existboolIs object related with any other object?
housesarrayOther houses that are related to this house. Array of <house> elements. See <house> (Related House element) for details.
<note> - Additional house characteristic
selfstringDescription.
<rating> - Ratings (1-5)
placeintAverage place rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
beachintAverage beach rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
accomodationintAverage accomodation rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
hostintAverage host rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
totalintTotal average rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
<image> - House image
selfarrayImage variants. Array of <variant> elements. See <variant> (Image variant data) for details. Element has the following attributes:
  • type [type]: Image type (based on subject). Supported types are:
    • exterior
    • courtyard
    • parking
    • host
<courtyard> - Courtyard data
existboolCourtyard exists?
sizeintCourtyard size (in square meters).
shareboolIs shared with other objects?
playgroundboolHas children playground?
seatsboolHas seating place?
<pool> - Pool data
existboolCommon or private pool exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request? This element is deprecated.
lengthfloatPool length in meters.
widthfloatPool width in meters,
depthfloatPool depth in meters.
waterTypestringPool water type.
heatingboolPool has heating?
shareboolSharing pool with another object? This element is deprecated.
privatesetPrivate pool data. See <private> (Private pool data.) for details.
<private> - Private pool data.
existboolPrivate pool exists in units?
unitsarrayReferences to all accommodation units which belong to this house (not necessarily matching search criteria) and have access to private pool. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
<parking> - Multiple parking data.
typetypeParking description. Supported types are:
  • private
  • public
This element is deprecated.
isGarageboolIs designated parking actually a garage?
onRequestboolParking service available on request? This element is deprecated.
stackParkingboolCars are parked one behind the other?
narrowDrivewayboolIs driveway narrow? This element is deprecated.
reservedPlacesintNumber of reserved parking places.
distanceintDistance in meters.
stairsToParkingintNumber of stairs from house to parking.
guardedboolIs parking guarded? This element is deprecated.
sunProtectionsarraySun protections for parking. Array of <type> elements. See <type> (Parking sun protection data) for details. This element is deprecated.
pricesetPricing data. See <price> (Pricing data) for details.
positionYardboolIs parking in the yard?
positionByTheRoadboolIs parking by the road? This element is deprecated.
positionSteepboolIs parking position steep? This element is deprecated.
<type> - Parking sun protection data
selftypeParking sun protection. Supported types are:
  • natural
  • tent
  • awning
  • chervil
  • objectshade
<grill> - Grill data
existboolGrill exists? This element is deprecated.
locationtypeGrill location. Supported types are:
  • terrace
  • courtyard
This element is deprecated.
onRequestboolService available on request?
typetype Supported types are:
  • portable
  • fixed
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria) and have access to this grill. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
shareCountintNumber of units from other objects that are using this grill.
<fixedGrill> - Fixed grill data
sharedsetShared fixed grill. See <shared> (Shared fixed grill data.) for details.
privatesetPrivate fixed grills. See <private> (Private fixed grills data.) for details.
<shared> - Shared fixed grill data.
existboolShared fixed grill exists?
<private> - Private fixed grills data.
existboolPrivate fixed grill exists?
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria) and have access to private fixed grill. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
<checkin> - Checkin service data
existboolCheckin service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<ecoTax> - Ecological taxation service data
existboolEcological taxation service exists?
pricesetPricing data. See <price> (Pricing data) for details.
freeAgeLt12boolIs ecotax free for children with age under 12 years?
<insurance> - Mandatory insurance service data
existboolMandatory insurance service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<phone> - Phone service data
existboolPhone service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request?
<fax> - Fax service data
existboolFax service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request?
<internet> - Internet access service data
existboolInternet access service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request? This element is deprecated.
typetypeInternet access type. Supported types are:
  • adsl
  • isdn
  • 56k
  • 3G
This element is deprecated.
hostComputerboolPossible access via house host computer? This element is deprecated.
guestComputerboolPossible access via guest computer? This element is deprecated.
guestConnTypetypeGuest computer connection type. Supported types are:
  • wifi - WLAN adapter required
  • ethernet - ethernet port required
  • usb - USB port required
  • isdn - ISDN adapter required
  • analogue - analogue modem required
locationSharedboolIs internet access available in the joint room? This element is deprecated.
<food> - Food service data
breakfastsetBreakfast service data. See <breakfast> (Breakfast service data) for details.
halfboardsetHalf-board service data. See <halfboard> (Half-board service data) for details.
fullboardsetFull-board service data. See <fullboard> ( Full-board service data) for details.
forcedtypeRequired food service type. Empty value means none. Supported types are:
  • breakfast
  • halfboard
  • fullboard
This element is deprecated.
freeAgeLt4boolIs food service free for children with age under 4 years?
halfAge4To12boolIs food service on 50% discount for children with age of 4 to 12 years?
<laundry> - Laundry service outside of the accommodation unit data
existboolLaundry service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request? This element is deprecated.
locationHostboolIs washing machine at the owner's apartment? This element is deprecated.
locationSharedboolIs washing machine in the joint room? This element is deprecated.
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria) and have a laundry machine. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details. This element is deprecated.
<boat> - Boat service data. Service available on request
existboolBoat service exists?
onRequestboolService available on request? This element is deprecated.
mandatoryboolIs boat rental mandatory? This element is deprecated.
pricesetPricing data. See <price> (Pricing data) for details.
fuelIncludedboolIs fuel included? This element is deprecated.
<moor> - Moor service data. Service available on request
existboolMoor service exists?
onRequestboolService available on request? This element is deprecated.
boatMaxLengthintMaximal length of the boat. This element is deprecated.
typetypeMoor type. Supported types are:
  • coast
  • buoy
distanceintDistance from object in meters.
protectedboolIs protected from the open sea? This element is deprecated.
frontOfHouseboolIs located in front of the house? This element is deprecated.
pricesetPricing data. See <price> (Pricing data) for details.
<pet> - Pet service data
existboolPet service exists?
pricesetPricing data. See <price> (Pricing data) for details.
unitsarrayReferences to all accommodation units which belong to this house where pets are allowed. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
<iron> - Equipment data: Iron
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request? This element is deprecated.
<ironingBoard> - Equipment data: Ironing board
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request? This element is deprecated.
<hairDryer> - Equipment data: Hair dryer
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request? This element is deprecated.
<portableGrill> - Portable grill data
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
<bicycle> - Equipment data: Bicycle
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request? This element is deprecated.
quantityintQuantity in numbers.
<rentAScooter> - Rent-a-scooter
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request?
<rentACar> - Rent-a-car
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request?
<tableTennis> - Table tennis
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request?
<fitness> - Equipment data: Gym
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request?
<beachUmbrella> - Equipment data: Sun umbrellas
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request? This element is deprecated.
<deckChair> - Equipment data: Deckchairs
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request? This element is deprecated.
<fan> - Equipment data: Ventilators
existboolDevice available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request?
<transport> - Service data: Shuttle service
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolAvailable on request?
<tvJointRoom> - Equipment data: TV in the common room
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
<sharedFridge> - Equipment data: Shared fridge
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
<sharedFreezer> - Equipment data: Shared freezer
existboolService available?
pricesetPricing data. See <price> (Pricing data) for details.
<infantBed> - Infant bed data
existboolInfant bed available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request? This element is deprecated.
quantityintQuantity in numbers. This element is deprecated.
<extraBed> - Extra bed data
existboolExtra bed available?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request? This element is deprecated.
quantityintQuantity in numbers.
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria) where extra bed is available. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
<extraBaby> - One baby up to 4 years (with no extra bed) is allowed data
existboolExtra baby available?
pricesetPricing data. See <price> (Pricing data) for details.
<smoking> - Smoking data
existboolSmoking allowed?
pricesetPricing data. See <price> (Pricing data) for details.
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria) where smoking is allowed. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
<smokingTerrace> - Smoking at the terrace data
existboolSmoking allowed on the terrace?
pricesetPricing data. See <price> (Pricing data) for details.
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria) where smoking on the terrace is allowed. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
<luxury> - Luxury services.
jacuzziboolIs jacuzzi available?
saunaboolIs sauna available?
wellnessboolIs wellness available?
massageboolIs massage available?
fitnessboolIs fitness available?
wineCellarboolIs wine cellar available?
minibarboolIs minibar available?
additionalCleaningboolIs additional cleaning available?
attendantsboolIs additional staff available?
<water> - Water availability data
waterTankboolHas water tank filled by rainwater or by a cistern.
waterPlumbingboolHas regular water supply.
waterNonDrinkableboolWater is not drinkable?
<waterHeating> - Water heating data
onlyColdWaterboolOnly cold water is available.
oilboolIs water heated by an oil generator.
solarboolIs water heated by solar collectors.
gasBoilerboolIs water heated by a gas boiler.
sunboolWater is heated by direct sunlight.
showerSunboolWater for the outside showers is heated by direct sunlight.
<power> - Power data
solar12bool12V solar energy power supply.
solar220bool220V solar energy power supply.
oil12bool12V power supply through oil generator.
oil220bool220V power supply through oil generator.
socketsboolAre there power sockets in the object.
<other> - Other robinson tourism related data
mobileMarketboolMobile market is available.
gasRefrigeratorboolGas refrigerator.
gasStoveboolGas stove.
outsideToiletboolHas an outside toilet. Element has the following attributes:
  • distance [int]: Distance of outside toilet from the object (in meters).
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large (max. 365px, horizontal or vertical)
    • s - small (115x86px)
    • m - medium (200x133px)
    • o - small medium (150x100px)
    • xl - extra large (max. height 600px)
urlstringImage variant URL.
<boatTransferOffer> - Boat transfer offer data
existboolBoat transfer offer available?
pricesetPricing data. See <price> (Pricing data) for details.
<price> - Pricing data
typetypePrice type. Supported types are:
  • extra - service is charged additionaly
  • extra_adult - service is charged additionaly only for adults
  • included - service is not charged additionaly
  • agreement - service price is subject of agreement with house owner
  • extra_by_device - service is charged additionaly for each device
  • consumption - service is charged additionaly based on consumption
amountfloatPrice amount. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
unittypePrice unit type. Supported types are:
  • onetime
  • day
  • person
  • person_day
  • hour
  • minute
  • second
  • page
  • kb
  • mb
  • gb
  • wash
  • call
  • kwh
  • agreement
  • transport
  • week
  • day_piece
<value> - Discount/additional payment value
Percent, money or freeDays amount. Negative values are discounts, positive values are additional payments.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Value type. Supported types are:
    • percent
    • amount
    • extra_day
percentfloatPercent value.
amountfloatMoney amount value. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
freeDaysintNumber of free days. Element has the following attributes:
  • total [int]: Total number of days.
<language> - Host foreign language data
codestringTwo-letter language code (according to ISO 639-1 standard) in lowercase.
knowledgeintKnowledge mark. Range is from 1 (poor) to 5 (excellent).
<breakfast> - Breakfast service data
existboolBreakfast service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<halfboard> - Half-board service data
existboolHalf-board service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<fullboard> - Full-board service data
existbool Full-board service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<house> - Related House element
namestringHouse name
capacityintNumber of beds
sameBuildingboolThis house belong to the same building.
<description> - Object description
summarystringObject description summary
bodystringObject description body
<guide> - Object location tourist guide
itemsarrayTourist guide information of the place, riviera and region where the object is located. Array of <item> elements. See <item> (Geo location data) for details.
<item> - Geo location data
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Geo location type of the item. Supported types are:
    • place
    • riviera
    • region
namestringGeo location name.
descriptionstringDescription of the geo location.
imagearrayGeo location image. References to all geo location image variants which belong to this tourist guide item. Array of <variant> elements. See <variant> (Image variant data) for details.

Example usage

Retrieve data of private accommodation house with ID 1005.

https://www.adriatic.hr/services/rest/
  ?method=Private_getHouse
  &id=1005
  &aid=af151
  &lang=en
  &sig=6f0dcac4960e0eab40c4bdc1d42b6c03

Private_getUnit

Retrieve accommodation unit data.

Request parameters

idintAccommodation unit ID. This parameter is required.
prc_wodboolPrices without discounts (applies only to an accommodation service price list). Use this if you want to show original price list (without discount, if any exist) and print (advert) discount information elsewhere, instead of just including discounts into price list. Default value is FALSE.

Response

<unit> - Accommodation unit data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Accommodation unit ID.
namestringName (eg. A-1000-c, K-1000, etc.). Name is consisted of type code (K, A, AS or K), house name and character label (not used for house type). This description is for your information only (you don't have to deal with it).
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
typetypeType. Supported types are:
  • house
  • apartment
  • studio-apartment
  • room
labelstringCharacter label. Used to distinguish multiple accommodation units with a same type, within the same house.
housestringName of the house which accommodation unit belongs to. Element has the following attributes:
  • id [int]: House ID.
capacitysetCapacity data. See <capacity> (Capacity data) for details.
classsetClassification data. See <class> (Accommodation unit classification data) for details.
positionsetPosition inside house data. See <position> (Position data) for details.
entrancesetEntrance data. See <entrance> (Entrance data) for details.
disabledPersonsboolIs suitable for disabled persons?
partsarrayAvailable parts. Part is an inner or outer area of accommodation unit (eg. room, terrace, balcony, etc.). Array of <part> elements. See <part> (Part data) for details.
servicesetAvailability and details of services. See <service> (Service data) for details.
priceListsetPrice list data. Accommodation unit daily price depends of date and number of persons. Thus, prices are groupped by date intervals and number of persons. See <priceList> (Price list data) for details.
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
notesarrayAdditional accommodation unit characteristics. Array of <note> elements. See <note> (Additional accommodation unit characteristic) for details.
imagesarrayImages. Array of <image> elements. See <image> (Image) for details.
descriptionsetAccommodation unit description. See <description> (Accommodation unit description) for details.
<capacity> - Capacity data
totalintTotal number of beds.
basicintNumber of basic (main) beds.
additionalintNumber of additional beds.
<class> - Accommodation unit classification data
official intOfficial classification mark (by Croatian authority).
adriaticfloatAdriatic.hr classification mark.
<position> - Position data
floorintFloor. Value of zero represent ground floor, negative values represent basement floors.
floorSpanintNumber of floors through which this accommodation unit spans.
raisedFloorboolIs the unit floor raised? Special examples: if floor is 0 (ground floor) and the floor is raised, it's upper ground floor; if floor is -1 (basement) and the floor is raised, it's half basement.
mezzanineboolIs this a mezzanine floor?
multilevelboolDoes this unit have different levels on the same floor (stairs or ramps)?
atticboolIs this unit in the attic?
flatboolIs this unit flat in building?
detachedUnitboolIs this detached unit?
<entrance> - Entrance data
sharesetEntrance sharing data. See <share> (Resource sharing data) for details.
doorSeparatedboolIs the unit separated by door from other units in the object.
entranceTypetypeType of unit entrance. Supported types are:
  • common
  • host
  • unit_hallway
  • out_offer_unit_hallway
entranceFromUnittextContains accommodation unit name if the entrance to the unit is from the stated unit. Element has the following attributes:
  • id [int]: Accommodation unit ID.
somePartsNotConnectedboolSome parts of this accommodation unit are not connected with the rest of the unit.
<part> - Part data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Part ID.
typetypeType. Supported types are:
  • living
  • dining
  • kitchen
  • bathroom
  • toilet
  • bedroom
  • hall
  • terrace
  • balcony
sizeintSize (in square meters).
houseboolBelongs to the entire house?
onRequestboolService available on request? Used for kitchens only. This element is deprecated.
airConditioningboolHas an opening to the air-conditioning unit.
bedsarrayAvailable beds. Array of <bed> elements. See <bed> (Bed data) for details.
standardboolHas standard equipment? Used for kitchens only. Standard equipment includes: refrigerator, stove (without oven), sink and dishes
smallKitchen boolKitchen is small (kitchenette)? Used for kitchens only. Standard equipment includes: small refrigerator and sink
fridgeboolHas fridge? Used for kitchens only. This element is deprecated.
iceChestboolHas ice-chest? Used for kitchens only.
fridgeIceChestboolHas combine fridge/ice-chest? Used for kitchens only.
dishWasherboolHas dish-washer? Used for kitchens only.
ovenboolHas oven? Used for kitchens only.
stoveboolHas stove? Used for kitchens only.
hotPlateboolHas hot plate (table cooker)? Used for kitchens only.
microwaveboolHas microwave? Used for kitchens only. Element has the following attributes:
  • onRequest [bool]: Service available on request?
pricesetPricing data. Used for kitchens only. See <price> (Pricing data) for details.
bathTubboolHas bathtub? Used for bathrooms only.
showerBathboolHas shower-bath? Used for bathrooms only.
shadesetSun shade data. Used for outer parts (terraces and balconies) only. See <shade> (Sun shade data) for details.
seaViewboolHas sea view? Used for outer parts (terraces and balconies) only.
relatesetRelated data. See <relate> (Related data) for details.
sharesetSharing data. See <share> (Resource sharing data) for details.
passagesetInformation about who has to cross the this part. See <passage> (Part passage data) for details.
separationsetInformation about whether this part is separated from its accommodation unit. Also contains information on entrance into the room. See <separation> (Part separation data) for details.
windowWalledboolInformation about whether the windows shown in the room are walled up.
windowShuttersOnlyboolDo the windows shown in the room have shutters but no window panes?
windowWallViewboolInformation about whether the windows shown in the room face the nearby wall.
<service> - Service data
childBedPricingarrayPrice for accommodation of children in bed for children. Array of <capacity> elements. See <capacity> (Capacity for child bed.) for details. This element is deprecated. See <childBed> (Additional accommodation for children in bed for children data).
terrTvboolIs terrestrial TV program available?
satTvboolIs satellite TV program available?
pcboolIs personal comuter available?
phoneboolIs phone available?
safeboolIs safe deposit box available?
fixedGrillboolIs private fixed grill available?
fridgeboolIs fridge available? This is used only when accommodation unit type is defined as a room.
acsetAir conditioner usage data. See <ac> (Air conditioner data) for details.
heatingsetHeating usage data. See <heating> (Heating data) for details.
kitchensetKitchen usage data. Kitchen service can exist only if accommodation unit type is room. See <kitchen> (Kitchen data) for details. This element is deprecated.
finalCleaningsetFinal cleaning data. See <finalCleaning> (Final cleaning service data) for details.
depositsetDeposit data. See <deposit> (Deposit data) for details.
childBedsetAdditional accommodation for children in bed for children. See <childBed> (Additional accommodation for children in bed for children data) for details.
petboolPet accommodation data.
petOnRequestboolPet friendly on request. This element is deprecated.
extraBedOnRequest boolExtra bed on request.
smokingboolIs smoking allowed in the unit?
smokingTerraceboolIs smoking allowed on the terrace of the unit?
laundryMachineboolDoes unit have a laundry machine?
<priceList> - Price list data
intervalsarrayPrices by intervals. Array of <interval> elements. See <interval> (Interval data) for details.
yearintPrice list year.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit, whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
lowPriceboolAccommodation unit has a low price?
touristTaxIncludedboolAccommodation unit has tourist tax included in price?
shortOrderExtraChargeboolAccommodation unit has short stay charged extra?
<note> - Additional accommodation unit characteristic
selfstringDescription.
<rating> - Ratings (1-5)
placeintAverage place rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
beachintAverage beach rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
accomodationintAverage accomodation rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
hostintAverage host rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
totalintTotal average rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
<image> - Image
selfarrayImage variants. Array of <variant> elements. See <variant> (Image variant data) for details. Element has the following attributes:
  • type [type]: Image type (based on subject). Supported types are:
    • drawing
    • part
  • part [int]: Part ID. This value makes sense only if type has value of part.
  • view [bool]: Does image represent a view from part? This value makes sense only if type has value of part.
<description> - Accommodation unit description
summarystringAccommodation unit description summary.
<bed> - Bed data
capacityintPerson capacity.
typetypeType. Supported types are:
  • single
  • double
  • foldaway
  • three_seater
  • two_seater
  • armchair
  • sofa
childrenboolIs it intended for children only?
smallboolDimensions of the bed aren't standard size (80x190 or 160x190)?
<shade> - Sun shade data
existboolSun shade exists?
typesarrayAll available sun shade types. Array of <type> elements. See <type> (Sun shade data.) for details.
<type> - Sun shade data.
selftypeSun shade type. Supported types are:
  • natural
  • awning
  • canopy
  • chervil
  • sunshade
  • object_shade
<relate> - Related data
existboolIs part related with any other part?
partsarrayParts in our accommodation units (in our offering) which relate with this part. Array of <part> elements. See <part> (Related part data) for details.
hostboolIs part related with part used by the host?
otherUnitssetOther accommodation units (outside of our offering) which relate with this part. See <otherUnits> (Other accommodation units data) for details.
<share> - Resource sharing data
existboolIs resource shared with anyone?
hostboolIs resource shared with the host?
agencyUnitsarrayOur accommodation units (in our offering) which share the resource. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
otherUnitssetOther accommodation units (outside of our offering) which share the resource. See <otherUnits> (Other accommodation units data) for details.
<passage> - Part passage data
existboolDoes anyone have to cross this room?
hostboolDoes the host have to cross this room?
guestsAgencyboolDo guests from other accommodation units in our offer have to cross this room?
guestsAgencyUnitsarrayList of accommodation units in our offer whose guests have to cross this room. Array of <unit> elements. See <unit> (Accommodation unit data) for details.
guestsOtherUnitssetOther accommodation units (outside of our offering) whose guests have to cross the room. See <otherUnits> (Other accommodation units data) for details.
entranceIntoUnit boolIs entrance into the accommodation unit through this room. Available only for 'bedroom' room type.
passageToPartsarrayList of rooms accessed through this room. Only available for 'bedroom' room types. Array of <part> elements. See <part> (Passage to part data) for details.
<separation> - Part separation data
detachedFromUnitboolIs the part detached from its accommodation unit? Not available for parts that belong to an object.
entranceFromtypeSpecifies from where the part is entered from. Supported types are:
  • from yard
  • common_hallway
  • common_parts
  • host_residence
  • from_part
entranceFromPartsetIf part is accessed from another part in our offer, then the data for that part is listed here. See <entranceFromPart> (Entrance from part data) for details.
<capacity> - Capacity for child bed.
selfn/a Element has no value. Element has the following attributes:
  • num [int]: Number of children.
pricesetPricing data. See <price> (Pricing data) for details.
<ac> - Air conditioner data
existboolAir conditioner exists?
pricesetPricing data. See <price> (Pricing data) for details.
devicesarrayAvailable air conditioning devices Array of <device> elements. See <device> (List device data) for details. This element is deprecated.
fixedsetFixed air conditioner data. See <fixed> (Fixed air conditioner data) for details. This element is deprecated. See <exist>.
centralsetCentral air conditioner data. See <central> (Central air conditioner data) for details. This element is deprecated. See <exist>.
mobilesetMobile air conditioner data. See <mobile> (Mobile air conditioner data) for details. This element is deprecated. See <exist>.
<fixed> - Fixed air conditioner data
existboolFixed air conditioner exists?
pricesetPricing data. See <price> (Pricing data) for details.
devicesarrayAvailable fixed air conditioning devices Array of <device> elements. See <device> (List device data) for details.
<central> - Central air conditioner data
existboolCentral air conditioner exists?
pricesetPricing data. See <price> (Pricing data) for details.
<mobile> - Mobile air conditioner data
existboolMobile air conditioner exists?
pricesetPricing data. See <price> (Pricing data) for details.
devicesarrayAvailable mobile air conditioning devices Array of <device> elements. See <device> (List device data) for details.
<device> - List device data
typetypeType of air conditioning. Supported types are:
  • fixed
  • central
  • portable
This element is deprecated.
partn/a Element has no value. Element has the following attributes:
  • id [int]: Part ID.
pricesetPricing data. See <price> (Pricing data) for details.
<heating> - Heating data
existboolHeating exists?
typetypeType of heating. Supported types are:
  • central
  • underfloor
  • wood_stove
  • electric_heater
pricesetPricing data. See <price> (Pricing data) for details.
<kitchen> - Kitchen data
This is used only if accommodation unit type is room.
existboolKitchen exists?
pricesetPricing data. See <price> (Pricing data) for details.
<finalCleaning> - Final cleaning service data
existboolFinal cleaning service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<deposit> - Deposit data
existboolDeposit exists?
pricesetPricing data. See <price> (Pricing data) for details.
<childBed> - Additional accommodation for children in bed for children data
existboolAdditional child bed exists?
pricesetPricing data. See <price> (Pricing data) for details.
<interval> - Interval data
fromdateBegin of interval (format is YYYY-MM-DD). Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
todateEnd of interval (format is YYYY-MM-DD). Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
pricesarrayPrices by number of persons. First price is for maximum number of persons. Array of <price> elements. See <price> (Interval price data) for details.
<discount> - Discount/additional payment data
typetypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
namestringName.
valuesetPercent, money or freeDays value. See <value> (Discount/additional payment value) for details.
<value> - Discount/additional payment value
Percent, money or freeDays amount. Negative values are discounts, positive values are additional payments.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Value type. Supported types are:
    • percent
    • amount
    • extra_day
percentfloatPercent value.
amountfloatMoney amount value. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
freeDaysintNumber of free days. Element has the following attributes:
  • total [int]: Total number of days.
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large (max. 365px, horizontal or vertical)
    • s - small (115x86px)
    • m - medium (200x133px)
    • o - small medium (150x100px)
    • xl - extra large (max. height 600px)
urlstringImage variant URL.
<price> - Pricing data
typetypePrice type. Supported types are:
  • extra - service is charged additionaly
  • extra_adult - service is charged additionaly only for adults
  • included - service is not charged additionaly
  • agreement - service price is subject of agreement with house owner
  • extra_by_device - service is charged additionaly for each device
  • consumption - service is charged additionaly based on consumption
amountfloatPrice amount. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
unittypePrice unit type. Supported types are:
  • onetime
  • day
  • person
  • person_day
  • hour
  • minute
  • second
  • page
  • kb
  • mb
  • gb
  • wash
  • call
  • kwh
  • agreement
  • transport
  • week
  • day_piece
<unit> - Accommodation unit reference data
selfstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
  • capacityBasic [int]: Basic capacity of the accommodation unit.
  • capacityAdditional [int]: Additional capacity of the accommodation unit.
<otherUnits> - Other accommodation units data
existboolOther accommodation units exists?
countintCount of other accommodation units.
<part> - Related part data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Related part ID.
  • type [string]: Related part type.
directboolIs it directly connected? Eg. bedroom could have private (directly connected) toilet. This element is deprecated.
objectintID of the house that the room belongs to. Used for shared rooms. Set to 0 if room belongs to an accommodation unit.
thisUnitboolPart is used by this accommodation unit.
sharesetSharing data. See <share> (Resource sharing data) for details.
<part> - Passage to part data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Related part ID.
  • type [string]: Related part type.
objectintID of the house that the room belongs to. Used for shared rooms. Set to 0 if room belongs to an accommodation unit.
thisUnitboolPart is used by this accommodation unit.
sharesetSharing data. See <share> (Resource sharing data) for details.
<entranceFromPart> - Entrance from part data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Related part ID.
  • type [string]: Related part type.
objectintID of the house that the room belongs to. Used for shared rooms. Set to 0 if room belongs to an accommodation unit.
thisUnitboolPart is used by this accommodation unit.
sharesetSharing data. See <share> (Resource sharing data) for details.
<price> - Interval price data
amountfloatPrice amount (per day). Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
personsintNumber of persons.

Example usage

Retrieve data of private accommodation unit with ID 1868.

https://www.adriatic.hr/services/rest/
  ?method=Private_getUnit
  &id=1868
  &aid=af151
  &lang=en
  &sig=2157c7bf020a291ccb305417651b00c4

Private_getAvailStatus

Get accommodation unit(s)'s availability status.

Request parameters

idlist Comma delimited list of accommodation unit IDs. Example: "1868,1869". This parameter is required.
i_fromdateBegin of interval. Allowed formats are YYYY-MM-DD and unix timestamp. This parameter is required.
i_todateEnd of interval. Allowed formats are YYYY-MM-DD and unix timestamp. This parameter is required.

Response

<status> - Availability data
availboolAll specified accommodation units are available? Element has the following attributes:
  • type [type]: Availability status type. Supported types are:
    • avail - available
    • unavail_temp - temporarily unavailable
    • unavail - unavailable
unitsarrayAvailability by accommodation unit. Array of <unit> elements. See <unit> (Accommodation unit availability) for details.
<unit> - Accommodation unit availability
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Accommodation unit ID.
availboolAccommodation unit is available? Element has the following attributes:
  • type [type]: Availability status type. Supported types are:
    • avail
    • unavail_temp
    • unavail

Example usage

Get availability status of accommodation units with IDs 1868 and 1869 in date interval 2015-08-09 to 2015-08-15.

https://www.adriatic.hr/services/rest/
  ?method=Private_getAvailStatus
  &id=1868%2C1869
  &i_from=2015-08-09
  &i_to=2015-08-15
  &aid=af151
  &lang=en
  &sig=6c3ba357b11e1072467ee3b2a8ce1663

Private_getUnavailDates

Get accommodation unit unavailable dates.

Request parameters

idintAccommodation unit ID. This parameter is required.

Response

<dates> - Unavailable dates data
selfarrayUnavailable dates (if any). Array of <date> elements. See <date> (Unavailable date data) for details.
<date> - Unavailable date data
selfdate Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST). Element has the following attributes:
  • type [type]: Availability status type. Supported types are:
    • unavail_temp
    • unavail

Example usage

Get unavailable dates of accommodation units with ID 2459.

https://www.adriatic.hr/services/rest/
  ?method=Private_getUnavailDates
  &id=2459
  &aid=af151
  &lang=en
  &sig=f03e9ceae26269b266003f4e70a2efbe

Geo_find

Search geography locations (except beaches). Method is pagination aware (results are split across multiple pages).

Request parameters

idintComma delimited list of region, riviera and place IDs. Example: "re-2,ri-17,pl-106".
qstringSearch string (case insensitive).
q_matchtypeString matching mode. Hint: begin and begin_word modes can be used for implementation of location input field with autocomplete support. Supported types are:
  • substring - Anywhere in the string
  • begin - At the beginning of the string
  • begin_word - At the beginning of any word in the string
  • exact - Exact match
Default value is substring.
ttypeLocation type. Supported types are:
  • region
  • riviera
  • place
sorttypeSort criterion. Supported types are:
  • name - Location name
  • type - Location type
Default value is name.
sort_dirtypeSort direction. Supported types are:
  • asc - Ascending
  • desc - Descending
Default value is asc.
pageintPage number. Default value is 1.
limitintNumber of results per page (max. 25). Default value is 10.

Response

<list> - List data
itemsarrayItems on current page. Array of <item> elements. See <item> (List item data) for details.
pagersetSet of pager elements. See <pager> (List pager data) for details.
<item> - List item data
idstringLocation ID.
namestringLocation name.
typetypeLocation type. Supported types are:
  • region
  • riviera
  • place
rivierastringRiviera name. Available only if location type is place. Element has the following attributes:
  • id [string]: Riviera ID.
regionstringRegion name. Available only if location type is place or riviera. Element has the following attributes:
  • id [string]: Region ID.
imagearrayImage of location. Array of <variant> elements. See <variant> (Image variant data) for details.
coordinatessetGeography coordinates. Available only if location type is place. See <coordinates> (Geography coordinates) for details.
<pager> - List pager data
totalItemsintTotal items that match search criteria.
totalPagesintTotal pages.
currentPageintCurrent page.
pageLimitintMaximum number of items per page.
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large (max. 365px, horizontal or vertical)
    • s - small (115x86px)
    • m - medium (200x133px)
    • o - small medium (150x100px)
    • xl - extra large (max. height 600px)
urlstringImage variant URL.
<region> - Region data
namestringRegion name.
rivierasarrayReferences to all rivieras which belong to this region. Array of <riviera_ref> elements. See <riviera_ref> for details.
imagesarrayRegion images. Array of <image> elements. See <image> for details.
<coordinates> - Geography coordinates
longitudedecimalGeographical longitude.
latitudedecimalGeographical latitude.
altitudedecimalGeographical altitude.

Example usage

Find geography locations with word 'hvar' in name.

https://www.adriatic.hr/services/rest/
  ?method=Geo_find
  &q=hvar
  &aid=af151
  &lang=en
  &sig=b01c6631dac94943efe7fabcadcd8bc9

Geo_get

Retrieve geography location data. Supported location types are place, beach, riviera and region.

Request parameters

idstringGeography location data. This parameter is required.

Response

<location> - Location data
selfn/a Element has no value. Element has the following attributes:
  • id [string]: Location ID.
typetypeLocation type. Supported types are:
  • region
  • riviera
  • place
regionsetRegion name. Available only if location type is region. See <region> (Region data) for details. Element has the following attributes:
  • id [string]: Region ID.
rivierasetRiviera name. Available only if location type is riviera. See <riviera> (Riviera data) for details. Element has the following attributes:
  • id [string]: Riviera ID.
placesetPlace name. Available only if location type is place. See <place> (Place data) for details. Element has the following attributes:
  • id [string]: Place ID.
beachsetBeach name. Available only if location type is beach. See <beach> (Beach data) for details. Element has the following attributes:
  • id [string]: Beach ID.
<region> - Region data
namestringRegion name.
rivierasarrayReferences to all rivieras which belong to this region. Array of <riviera> elements. See <riviera> (Riviera reference) for details.
imagesarrayRegion images. Array of <image> elements. See <image> (Image) for details.
<riviera> - Riviera data
namestringRiviera name.
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
typetypeRiviera type. Supported types are:
  • mainland
  • mainland_river
  • island
  • islands
  • island_bridge
  • peninsula
placesarrayReferences to all places which belong to this riviera. Array of <place> elements. See <place> (Place reference) for details.
imagesarrayRiviera images. Array of <image> elements. See <image> (Image) for details.
<place> - Place data
namestringPlace name.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
nationalParkstringNational park name. Element has the following attributes:
  • id [string]: National park ID.
  • inArea [bool]: Place is located within the boundaries of the National park.
typetypePlace type. Supported types are:
  • large_city
  • tourist_city
  • small_city
  • cove
largerPlacesetLarger place data. See <largerPlace> (Larger place data) for details.
isletsetIslet data. See <islet> (Islet data) for details.
beachesGeneralsetGeneral info on beaches which belong to this place. See <beachesGeneral> (Place beaches data) for details.
beachesarrayReferences to all beaches which belong to this place. Array of <beach> elements. See <beach> (Beach reference) for details.
imagesarrayPlace images. Array of <image> elements. See <image> (Image) for details.
coordinatessetGeography coordinates. See <coordinates> (Geography coordinates) for details.
<beach> - Beach data
Note that beaches don't have names.
placestringPlace name. Element has the following attributes:
  • id [string]: Place ID.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
outsideAPlaceboolIs beach outside a place?
coordinatessetGeography coordinates. See <coordinates> (Geography coordinates) for details.
typetypeMain beach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva
typesarrayAll available beach types. Array of <type> elements. See <type> (Beach type) for details.
accesstypeSea access type. Supported types are:
  • long_shallow
  • short_shallow
  • no_shallow
privateboolBeach is 'private' (isolated)?
naturalShadeboolBeach has a natural shade?
showerboolBeach has a shower?
entertainmentboolBeach has an entertainment content?
nudeOfficialboolBeach is official nudist beach?
nudeSuitableboolBeach is suitable for nudism?
extraarrayAll available extra beach content. Array of <extra> elements. See <extra> (Extra beach content) for details.
othersetData of other beaches in the same place. See <other> (Other beaches data) for details.
imagesarrayBeach images. Array of <image> elements. See <image> (Image) for details.
<region> - Region reference
selfstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
<riviera> - Riviera reference
selfstringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
<place> - Place reference
selfstringPlace name. Element has the following attributes:
  • id [string]: Place ID.
<beach> - Beach reference
selfn/a Element has no value. Element has the following attributes:
  • id [string]: Beach ID.
<largerPlace> - Larger place data
existboolLarger place exists?
namestringLarger place name (only if the larger place exists).
idstringLarger place ID (only if the larger place exists).
boatTransportboolBoat transport is necessary to get to the larger place (only if the larger place exists)?
boatDistanceintBoat transport distance from larger place (nautical miles, only if the larger place exists). This element is deprecated.
<islet> - Islet data
existboolPlace is on an islet?
namestringIslet name (only if the islet exists).
transportCarboolCar can be transported onto the islet (only if the islet exists)?
<beachesGeneral> - Place beaches data
nudeOfficialboolPlace has an official nudism beach?
nudeSuitableboolPlace has a beach suitable for nudism?
entertainmentboolPlace has a beach with an entertainment content?
naturalShadeboolPlace has a beach with a natural shade?
showerboolPlace has a beach with a shower?
privateboolPlace has a beach that is 'private' (isolated)?
extraarrayAll available extra beach content. Array of <extra> elements. See <extra> (Extra beach content) for details.
typesarrayAll available beach types. Array of <type> elements. See <type> (Beach type) for details.
accesstypePlace has a beach with this access type. Supported types are:
  • long_shallow
  • short_shallow
  • no_shallow
<other> - Other beaches data
typesarrayAll available beach types. Array of <type> elements. See <type> (Beach type) for details.
accesstypeSea access type. Supported types are:
  • long_shallow
  • short_shallow
  • no_shallow
nudeOfficialboolOfficial nudism beach?
nudeSuitableboolSuitable for nudism?
entertainmentboolEntertainment content?
naturalShadeboolNatural shade?
showerboolHas shower?
privatebool'Private' (isolated)?
extraarrayAll available extra beach content. Array of <extra> elements. See <extra> (Extra beach content) for details.
imagesarrayImages of other beaches. Array of <image> elements. See <image> (Image) for details.
<extra> - Extra beach content
cateringFacilityboolCatering facility?
waterParkboolWater park?
jetSkiboolJet ski?
pedalBoatboolPedal boat?
sportFacilitiesboolSport facilities?
playground boolPlayground?
beachumbrellaDeckchairboolBeachumbrella or/and deckchair?
lifeguardboolIs guarded by lifeguard?
parkingNearboolIs parking near?
adaptedForDisabledboolIs adapted for disabled?
suitableForDisabled boolIs suitable for disabled?
<image> - Image
selfarrayImage variants. Array of <variant> elements. See <variant> (Image variant data) for details. Element has the following attributes:
  • type [type]: Image type (only for place). Supported types are:
    • place
    • beaches
    • country_map
    • region_map
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large (max. 365px, horizontal or vertical)
    • s - small (115x86px)
    • m - medium (200x133px)
    • o - small medium (150x100px)
    • xl - extra large (max. height 600px)
urlstringImage variant URL.
<coordinates> - Geography coordinates
longitudedecimalGeographical longitude.
latitudedecimalGeographical latitude.
altitudedecimalGeographical altitude.
<type> - Beach type
selftypeBeach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva

Example usage

Retrieve data of place with ID 'pl-220'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=pl-220
  &aid=af151
  &lang=en
  &sig=eaee7df5be098c4cabd98959f69e910f

Retrieve data of beach with ID 'be-223'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=be-223
  &aid=af151
  &lang=en
  &sig=eaee7df5be098c4cabd98959f69e910f

Retrieve data of riviera with ID 'ri-17'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=ri-17
  &aid=af151
  &lang=en
  &sig=eaee7df5be098c4cabd98959f69e910f

Retrieve data of region with ID 're-1'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=re-1
  &aid=af151
  &lang=en
  &sig=eaee7df5be098c4cabd98959f69e910f

Geo_getNames

Retrieve geography location names. Supported location types are place, riviera and region. Method can be used for implementation of location input field with autocomplete support.

Request parameters

None

Response

<names> - Location names
selfarrayNames of all available locations (except beaches). Array of <name> elements. See <name> (Location name) for details.
<name> - Location name
selfstring Element has the following attributes:
  • id [string]: Location ID.
  • type [type]: Location type. Supported types are:
    • region
    • riviera
    • place
  • parentId [string]: Parent location ID.

Example usage

Get geography location names.

https://www.adriatic.hr/services/rest/
  ?method=Geo_getNames
  &aid=af151
  &lang=en
  &sig=2887345166a8e931f218270b6421849b

Order_find

Search created orders (except temporary). Method is pagination aware (results are split across multiple pages).

Request parameters

qstringSearch string (case insensitive).
c_fromdateBegin of creation interval. Allowed formats are YYYY-MM-DD and unix timestamp.
c_todateEnd of creation interval. Allowed formats are YYYY-MM-DD and unix timestamp.
stypeStatus. Supported types are:
  • new - Reservation order is successfully submitted, waiting for Adriatic.hr to process it (method Order_confirm is called)
  • allowed - Adriatic.hr has checked the availability, confirmed the service availability, authorized and sent a pre-invoice, reservation confirmation is expected
  • denied - Adriatic.hr has checked the availability, the service is not available or the reservation processing has been stopped
  • failed - You aborted the reservation confirmation, the payment has not been made or the parameters have been changed before the reservation confirmation
  • accepted - You confirmed the reservation and Adriatic.hr confirmed it to the facility owner
  • paid_advance - Your advance payment has settled to our account, we are waiting for the payment of the remaining amount
  • paid - Payment of the remaining amount (or the whole total amount) has settled to our account, Adriatic.hr has to authorize the voucher, or the voucher has already been authorized
  • failed_paid - One of the parties canceled the reservation after the confirmation
  • paid_modified - There has been a change of some of the reservation parameters after the confirmation
sorttypeSort criterion. Supported types are:
  • created - Creation time
  • modified - Modification time
Default value is created.
sort_dirtypeSort direction. Supported types are:
  • asc - Ascending
  • desc - Descending
Default value is asc.
pageintPage number. Default value is 1.
limitintNumber of results per page (max. 25). Default value is 10.

Response

<list> - List data
itemsarrayItems on current page. Array of <item> elements. See <item> (List item data) for details.
pagersetSet of pager elements. See <pager> (List pager data) for details.
<item> - List item data
ordersetOrder data. See Order_get - <order> (Order data) for details.
<pager> - List pager data
totalItemsintTotal items that match search criteria.
totalPagesintTotal pages.
currentPageintCurrent page.
pageLimitintMaximum number of items per page.

Example usage

Find orders.

https://www.adriatic.hr/services/rest/
  ?method=Order_find
  &q=john+smith
  &aid=af151
  &lang=en
  &sig=654427c8d2c7fa1b65045d265b9c0b84

Order_create

Create new temporary order. It should be confirmed during the ordering process. New order is empty and should be populated with order items and guest data before confirmation (closing).

Request parameters

None

Response

Same as in Order_get.

Example usage

Create new empty order. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_create
  &aid=af151
  &lang=en
  &sig=7bdd8b4e5f18083b0be8975f271dd475

Order_get

Retrieve order data.

Request parameters

idintOrder ID. This parameter is required.

Response

<order> - Order data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Order ID.
itemsarrayOrder items. Array of <item> elements. See Order_addItem - <item> (Order item data) for details.
calcsetCosts calculation. See <calc> (Costs calculation data) for details.
userarrayUser data. Array of <user> elements. See <user> (User data) for details.
notesstringUser notes. Special text field which allows user to enter custom notes during (preferably at the last step) the ordering process is highly recommended for better user experience.
statustypeOrder's current status. Supported types are:
  • temp - Order is temporary - it is not finished, i. e. it has not gone through all the steps of the reservation form (method Order_confirm is not called yet)
  • new - Reservation order is successfully submitted, waiting for Adriatic.hr to process it (method Order_confirm is called)
  • allowed - Adriatic.hr has checked the availability, confirmed the service availability, authorized and sent a pre-invoice, reservation confirmation is expected
  • denied - Adriatic.hr has checked the availability, the service is not available or the reservation processing has been stopped
  • failed - You aborted the reservation confirmation, the payment has not been made or the parameters have been changed before the reservation confirmation
  • accepted - You confirmed the reservation and Adriatic.hr confirmed it to the facility owner
  • paid_advance - Your advance payment has settled to our account, we are waiting for the payment of the remaining amount
  • paid - Payment of the remaining amount (or the whole total amount) has settled to our account, Adriatic.hr has to authorize the voucher, or the voucher has already been authorized
  • failed_paid - One of the parties canceled the reservation after the confirmation
  • paid_modified - There has been a change of some of the reservation parameters after the confirmation
<calc> - Costs calculation data
itemsarrayCosts calculation item. Array of <item> elements. See <item> (Costs calculation item data) for details.
totalPricearrayTotal price amounts. Multiple amount elements in case of multiple currencies. Array of <amount> elements. See <amount> (Total price amount data) for details.
commissionfloatPartner (your) commission amount. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
<item> - Costs calculation item data
namestringItem's name.
unittypeItem's unit. Empty in some cases (e.g. if the item is a discount). Supported types are:
  • night
  • night_person
  • night_pet
  • person
unitPricefloatUnit price. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
quantityintQuantity.
pricefloatItem's price. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
groupintIndex of item's group. This is not intended for display, only as a helper if the similar items should be groupped together in the final (displayed to user) costs calculation table.
<amount> - Total price amount data
selffloatValue. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
<user> - User data
firstNamestringFirst name.
lastNamestringLast name.
countrystringCountry name. Element has the following attributes:
  • code [string]: Two-letter country code (according to ISO 3166-1 alpha-2 standard) in lowercase.
emailstringE-mail address.
phonesarrayPhone numbers. Array of <phone> elements. See <phone> (Phone data) for details.
<phone> - Phone data
selfstringPhone number.

Example usage

Retrieve data of order with ID 1234. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_get
  &id=1234
  &aid=af151
  &lang=en
  &sig=3cda0c8fc0530c0fc21a590a2bbfd21f

Order_confirm

Confirm existing order. Should be called at the end of the ordering process.

Request parameters

idintOrder ID. This parameter is required.

Response

No data is returned.

Example usage

Confirm order with ID 1234. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_confirm
  &id=1234
  &aid=af151
  &lang=en
  &sig=09ff15e8261b8adba2d635ad6006e673

Order_cancel

Cancel existing temporary order. Should be called if the order is not accepted (guest changes his mind during the ordering process).

Request parameters

idintOrder ID. This parameter is required.

Response

No data is returned.

Example usage

Cancel order with ID 1234. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_cancel
  &id=1234
  &aid=af151
  &lang=en
  &sig=55959a2413810dcc7365593b8096be13

Order_setGuest

Set guest data. Guest data are required to be set before order confirmation.

Request parameters

idintOrder ID. This parameter is required.
fnstringFirst name. This parameter is required.
lnstringLast name. This parameter is required.
cstringTwo-letter country code (according to ISO 3166-1 alpha-2 standard) in lowercase. This parameter is required.
estringE-mail address. Required only if phone number is not given.
pstringPhone number. Required only if e-mail address is not given.

Response

No data is returned.

Example usage

Set guest data for order with ID 1234. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_setGuest
  &id=1234
  &fn=John
  &ln=Smith
  &c=fr
  &e=john%40smith.xx
  &p=%2B123+45+678-900
  &aid=af151
  &lang=en
  &sig=9303bd2f87c63de042bae511ccf69bd7

Order_addItem

Add new order item.

Request parameters

order_idintOrder ID. This parameter is required.
ttypeItem type. Sole supported type is:
  • private_units
This parameter is required.
ulist Comma delimited list of accommodation unit IDs. One or more accommodation units of the same house are supported only. Example: "1868,1869". This parameter is required.
i_fromdateBegin of interval. Allowed formats are YYYY-MM-DD and unix timestamp. This parameter is required.
i_todateEnd of interval. Allowed formats are YYYY-MM-DD and unix timestamp. This parameter is required.
pintNumber of persons. This parameter is required.
p_agelist Comma delimited list of number of persons per age range. Four age ranges exist and number of persons must be given for all of them (even if it is zero), in the following order: above 18, 12 to 18, 4 to 12 and under 4. Example: "4,0,2,0". This parameter is required.
p_unitlist Comma delimited list of number of persons per accommodation unit. List is 2-dimensional - list item is a semicolon delimited pair of accommodation unit ID and number of persons. This parameter in required only if more then one accommodation unit is chosen. Example: "1868;7,1869;6".
petintNumber of pets. This parameter is required.
pet_descstringPets description. Special text field which allows user to enter pets' description is highly recommended for more efficient ordering process.
foodtypeFood service type. Supported types are:
  • breakfast
  • halfboard
  • fullboard

Response

<item> - Order item data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Order item ID.
  • type [type]: Item type. Sole supported type is:
    • private_units
unitsarrayAccommodation units. Array of <unit> elements. See <unit> (Accommodation unit data) for details.
personsetNumber of persons data. See <person> (Number of persons data) for details.
intervalsetDate interval data. See <interval> (Date interval data) for details.
petCountintNumber of pets.
petDescstringPets description.
foodtypeFood type. Supported types are:
  • breakfast
  • halfboard
  • fullboard
<unit> - Accommodation unit data
selfstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
<person> - Number of persons data
countintTotal number of persons.
agesarrayNumber of persons per age range. Array of <age> elements. See <age> (Number of person per age range data.) for details.
unitsarrayNumber of persons per accommodation unit. Array of <unit> elements. See <unit> (Number of person per accommodation unit data.) for details.
<interval> - Date interval data
fromdateBegin of interval. Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
todateEnd of interval. Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
<age> - Number of person per age range data.
selfintNumber of persons. Element has the following attributes:
  • type [type]: Age range type. Supported types are:
    • 18- - over 18 years
    • 12-18 - 12 to 18 years
    • 4-12 - 4 to 12 years
    • -4 - under 4 years
<unit> - Number of person per accommodation unit data.
selfintNumber of persons. Element has the following attributes:
  • id [int]: Accommodation unit ID.

Example usage

Add new private accommodation order item to order with ID 1234. Order item contains two accommodation units in interval from 2015-07-21 to 2015-07-28, 13 persons and no pets. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_addItem
  &order_id=1234
  &t=private_units
  &u=1868%2C1869
  &i_from=2015-07-21
  &i_to=2015-07-28
  &p=13
  &p_age=7%2C2%2C3%2C1
  &p_unit=1868%3B7%2C1869%3B6
  &pet=0
  &aid=af151
  &lang=en
  &sig=1afc675766ad483b4f90f7ae7b9b5a43

Order_removeItem

Remove existing order item.

Request parameters

idintOrder item ID. This parameter is required.
order_idintOrder ID. This parameter is required.

Response

No data is returned.

Example usage

Remove order item with ID 1 from order with ID 1234. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_removeItem
  &id=1
  &order_id=1234
  &aid=af151
  &lang=en
  &sig=46ff08c1368257c3b0b4827dcdfcbec3

Order_setNotes

Set user's custom notes.

Request parameters

idintOrder ID. This parameter is required.
notesstringUser's notes. This parameter is required.

Response

No data is returned.

Example usage

Set user's notes for order with ID 1234. This is a syntax example only, this method can not be used with the test application ID supplied (for security purposes).

https://www.adriatic.hr/services/rest/
  ?method=Order_setNotes
  &id=1234
  &notes=Hello+world
  &aid=af151
  &lang=en
  &sig=895b42141447fedca619041ab0f7a1b3

System_getText

Retrieve method text.

Request parameters

mtypeMethod name. Supported types are:
  • Geo_find
  • Geo_get
  • Geo_getNames
  • Private_find
  • Private_findReviews
  • Private_getHouse
  • Private_getUnit
  • Private_getAvailStatus
  • Private_getUnavailDates
  • Order_get
  • Order_addItem
  • Order_setNotes
This parameter is required.

Response

<text> - Text data
selfn/a Element has no value. Element has the following attributes:
  • method [string]: Method name.
paramsarrayMethod parameters with associated text. Array of <param> elements. See <param> (Method parameter data) for details.
nodesarrayMethod response XML nodes with associated text. Array of <node> elements. See <node> (Method response XML node data) for details.
typesarrayTypes with associated text. Array of <type> elements. See <type> (Type data) for details.
<param> - Method parameter data
selfstringParameter text. Element has the following attributes:
  • name [string]: Parameter name.
<node> - Method response XML node data
selfstringNode text. Element has the following attributes:
  • path [string]: XPath path.
<type> - Type data
paramsarrayMethod parameters which use this type. Array of <param> elements. See <param> (Method parameter name) for details.
nodesarrayMethod response XML nodes which use this type. Array of <node> elements. See <node> (Method response XML node path) for details.
optionsarrayType options. Array of <option> elements. See <option> (Type option data) for details.
<param> - Method parameter name
selfstringParameter name.
<node> - Method response XML node path
selfstringXPath path.
<option> - Type option data
selfstringOption text. Element has the following attributes:
  • name [string]: Option name.

Example usage

Retrieve text of method Geo_find.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Geo_find
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Geo_get.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Geo_get
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_find.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_find
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_findReviews.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_findReviews
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getHouse.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getHouse
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getUnit.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getUnit
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getAvailStatus.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getAvailStatus
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getUnavailDates.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getUnavailDates
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Order_get.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Order_get
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Order_addItem.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Order_addItem
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Order_setNotes.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Order_setNotes
  &aid=af151
  &lang=en
  &sig=25553b551636e9346ed33da7286ee7de

System_getError

Retrieve error text translation.

Request parameters

codeintError code. This parameter is required.

Response

<error> - Error data
messagetextTranslated error message. Element has the following attributes:
  • code [int]: Error code.

Example usage

Retrieve error message translation for error code 200.

https://www.adriatic.hr/services/rest/
  ?method=System_getError
  &code=200
  &aid=af151
  &lang=en
  &sig=68f132dd19aff816ac67e0e5e56c308c

Retrieve error message translation for error code 217.

https://www.adriatic.hr/services/rest/
  ?method=System_getError
  &code=217
  &aid=af151
  &lang=en
  &sig=68f132dd19aff816ac67e0e5e56c308c

Existing User

Sign in to access user interface

Adriatic.hr
Poljička cesta 26
21000 Split, Croatia
tel: +385 21 456-456
fax: +385 21 456-789
gsm: +385 91 234-5641
e-mail: info@adriatic.hr
OIB: 16364086764
ID: HR-AB-21-020038491
Payment secured by SSL encription
Generiranje: s | XML: s | PHP: s
Memorija: MB | Host: | XML Service(0)
Adriatic.hr uses "cookies" on our website to provide you with a better user experience. By using our website you consent to their use. Learn more... Close