Retrieve a reservation
- Irene Marín
get https://ws.icnea.net/analytics/reservations/{booking_id}/
Use this endpoint to retireve an existing reservation.
PATH PARAMS
booking_id string required | Icnea’s booking ID. |
|---|
QUERY PARAMS
usr string required | API_key for your company, provided by Icnea. |
|---|---|
listing_id integer required | Listing ID. |
RESPONSES
200
{
"analytics_reservation_response": {
"listing_id": 12341001,
"unit_id": 1,
"booking_id": 100001,
"status": "confirmed",
"guest_country": "DE",
"channel": "",
"booking_date": "2024-12-20",
"cancellation_date": "",
"arrival_date": "2025-06-02",
"departure_date": "2025-06-04",
"nights": 2,
"people": {
"adults": 2,
"children": 1,
"infants": 0
},
"currency": "EUR",
"total_amount": 150.00,
"fees": {
"booking_fee": 10.00,
"cleaning_fee": 40.00,
"towels_fee": 0.00,
"bedlinen_fee": 0.00,
"internet_fee": 0.00,
"checkin_fee": 0.00,
"shortstay_fee": 0.00,
"tourist_tax": 0.00,
"creditcard_fee": 0.00
},
"discounts": {
"early_booking": 0,
"long_stay": 0,
"last_minute": 0,
"standard": 0,
"promotion": 0
},
"extras": 20.00,
"channel_comission": 0.00,
"owner_comission": 0.00,
"rate_name": "Standard 2 pax",
"dates": [
{
"date": "2025-06-02",
"import": 40.00
},{
"date": "2025-06-03",
"import": 40.00
}
]
}
}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 |
|
400
{
"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. |