Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
titleget
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

Status
colourGreen
title200

Code Block
languagejson
{
  "analytics_reservation_response": {   
    "listing_id": 12341001,
    "unit_id": 1,
    "booking_id": 100001,
    "status": "confirmed",
    "guest_country": "DE",
    "channel": "",
    "booking_date": "2024-12-20",    
    "cancelcancellation_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

Status
colourRed
title400

Code Block
languagejson
{  
  "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.