| Status | ||||
|---|---|---|---|---|
|
Use this endpoint to retireve an existing listingreservation.
...
PATH PARAMS
listingbooking_id string required | Listing Icnea’s booking ID. |
|---|
QUERY PARAMS
usr string required | API_key for your company, provided by Icnea. |
|---|---|
listing_id integer required | Listing ID. |
...
RESPONSES
| Status | ||||
|---|---|---|---|---|
|
| Code Block | ||
|---|---|---|
| ||
{
"analytics_listingreservation_response": {
"listing_id": 12341001,
"activeunit_id": "true"1,
"namebooking_id": "Casa Freya"100001,
"internal_namestatus": "C-Freyaconfirmed",
"propertyguest_type_groupcountry": "houseDE",
"property_type_category"channel": "villa",
"addressbooking_date": {
"city": "Pineda de Mar","2024-12-20",
"zipcancellation_date": "08342",
"regionarrival_date": "Maresme2025-06-02",
"countrydeparture_date": "ES2025-06-04",
"latitudenights": 2.34324324,
"longitudepeople": 0.3243242343
{
}, "surfaceadults": 502,
"min_capacity": 1, "max_capacity"children": 5,
"units": 1,
"ownersinfants": [0
{
"unit_id": ""},
"owner_idcurrency": "EUR",
"ownertotal_nameamount": ""
}
], 150.00,
"groupsfees": [ {
"group_id"booking_fee": ""10.00,
"groupcleaning_namefee": ""
}
], 40.00,
"bedrooms": 2, "bathroomstowels_fee": 10.00,
"toilets": 0, "singlebedlinen_bedsfee": 0.00,
"double_beds": 2,
"sofa_beds"internet_fee": 0.00,
"bunkcheckin_bedsfee": 0,
"currency": "EUR".00,
"fees": { "bookingshortstay_fee": 0.00,
"cleaning_fee": 40, "towelstourist_feetax": 0.00,
"bedlinen_fee": 0, "security_deposit_"creditcard_fee": 200
},
"amenities": [ ... ],0.00
"restrictions": [ ... ] },
"viewsdiscounts": [ ... ],
"distances": {
"cityearly_centerbooking": 0,
"airportlong_stay": 0,
"harbour": 0,
"railway_stationlast_minute": 0,
"public_transportstandard": 0,
"hospitalpromotion": 0,
"pharmacy": 0},
"marketextras": 020.00,
"skichannel_slopecomission": 0.00,
"beachowner_comission": 0.00,
"golf": 0, "public_park"rate_name": 0,"Standard 2 "historic_district": 0pax",
}, "reviewsdates": [
{
"date": "2025-0106-0402",
"countryimport": "ES",40.00
"language": "en",},{
"channeldate": "Airbnb2025-06-03",
"booking_idimport": "102345",40.00
}
"rating": { ]
"total": 9.2,
"location": 4,
"staff": 5,
"cleanliness": 5,
"comfort": 3,
"value": 4,
"accuracy": 0,
"communication": 0,
"surroundings": 0,
"tranquility": 0
}
}
]
}
} |
...
Parameter
...
Type
...
}
} |
Parameter | Type | Description |
|---|---|---|
listing_id | integer | |
unit_id | integer | |
booking_id | string | |
status | string | |
guest_country | string | |
channel | string | |
booking_date | date | |
cancellation_date | date | |
arrival_date | date | |
departure_date | date | |
nights | integer | |
people | object | |
currency | string | |
total_amount | decimal | |
fees | object | |
discounts | object | |
extras | decimal | |
channel_comission | decimal | |
owner_comission | decimal | |
rate_name | string | |
dates | array of objects |
people
Parameter | Type | Description |
|---|---|---|
adults | integer | |
children | integer | |
infants | integer |
fees
Parameter | Type | Description |
|---|---|---|
booking_fee | decimal | |
cleaning_fee | decimal | |
towels_fee | decimal | |
bedlinen_fee | decimal | |
internet_fee | decimal | |
checkin_fee | decimal | |
shortstay_fee | decimal | |
tourist_tax | decimal | |
creditcard_fee | decimal |
discounts
Parameter | Type | Description |
|---|---|---|
early_booking | integer | |
long_stay | integer | |
last_minute | integer | |
standard | integer | |
promotion | integer |
dates
Parameter | Type | Description |
|---|---|---|
date | date | |
import | decimal |
| Status | ||||
|---|---|---|---|---|
|
| Code Block | ||
|---|---|---|
| ||
{
"analytics_reservation_response": {
"error_code": "",
"error_message": ""
}
} |
Field | Type | Description |
|---|---|---|
error_code | string | Icnea internal error_id to help with debugging. |
error_message | string | Human readable description of error. |