Reservation
Returns a specific reservation.
Retrieves a reservation, specified by its ID.<br>You must have at least one of these scopes: 'reservations.read, reservations.manage'.<br>For fine-grained clients, you must have this permission: 'core.reservations.read'.
get/booking/v0-nsfw/reservations/{id}
Request
- Base URLhttps://api.apaleo.com (the document declares no server; this is the origin it was published from)
- URLhttps://api.apaleo.com/booking/v0-nsfw/reservations/{id}
- AuthOAuth 2Implicit: https://identity.apaleo.com/connect/authorizeScopes: reservations.read, reservations.manage, admin
Path parameters
idstring required
Id of the reservation to be retrieved.
Query parameters
expandstring[]
List of all embedded resources that should be expanded in the response. Possible values are: timeSlices, services, booker, actions, company, assignedUnits. All other values will be silently ignored.
Response
Success
Example response
{
"id": "XPGMSXGF-1",
"bookingId": "XPGMSXGF",
"status": "Confirmed",
"unit": {
"id": "MUC-MTA",
"name": "A.101",
"description": "Single room",
"unitGroupId": "MUC-SGL"
},
"property": {
"id": "MUC",
"code": "MUC",
"name": "Demo Hotel Munich",
"description": "This is the demo hotel Munich"
},
"ratePlan": {
"id": "MUC-NONREF_SGL",
"code": "NONREF",
"name": "Non Refundable",
"description": "Non Refundable",
"isSubjectToCityTax": false
},
"unitGroup": {
"id": "MUC-SGL",
"code": "SGL",
"name": "Single",
"description": "Single",
"type": "BedRoom"
},
"totalGrossAmount": {
"amount": 222,
"currency": "EUR"
},
"arrival": "2026-11-01T17:00:00+01:00",
"departure": "2026-11-03T11:00:00+01:00",
"created": "2026-10-30T12:12:37.4447906+01:00",
"modified": "2026-10-30T12:12:37.4447906+01:00",
"adults": 1,
"childrenAges": [
6
],
"externalCode": "812864414|369",
"channelCode": "BookingCom",
"primaryGuest": {
"title": "Mr",
"gender": "Male",
"firstName": "Jon",
"middleInitial": "D",
"lastName": "Doe",
"email": "john.d@doe.com",
"phone": "+4989123343",
"address": {
"addressLine1": "My Street 5",
"postalCode": "12453",
"city": "MyCity",
"countryCode": "GB"
},
"vehicleRegistration": {
"number": "APA322",
"countryCode": "DE"
},
"loyaltyMemberships": [
{
"program": "MARRIOTT",
"membershipNumber": "123456789",
"tier": "Gold"
}
]
},
"paymentAccount": {
"accountNumber": "1111",
"accountHolder": "John Doe",
"expiryMonth": "8",
"expiryYear": "2018",
"paymentMethod": "visa",
"payerEmail": "s.hopper@test.com",
"isVirtual": false,
"isActive": false
},
"hasActivePaymentAccount": false,
"registeredCard": {
"cardNumber": "1111",
"cardHolder": "John Doe",
"expiryMonth": "8",
"expiryYear": "2018",
"paymentMethod": "visa",
"payerEmail": "s.hopper@test.com",
"note": "Credit card will be available after 2025-06-23 10:00:00",
"isVirtual": false
},
"timeSlices": [
{
"from": "2026-11-01T17:00:00+01:00",
"to": "2026-11-02T11:00:00+01:00",
"serviceDate": "2026-11-01",
"ratePlan": {
"id": "MUC-FLEX_SGL",
"code": "FLEX",
"name": "Flexible",
"description": "Flexible",
"isSubjectToCityTax": false
},
"unitGroup": {
"id": "MUC-SGL",
"code": "SGL",
"name": "Single",
"description": "Single",
"type": "BedRoom"
},
"baseAmount": {
"grossAmount": 65,
"netAmount": 60.75,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 86,
"currency": "EUR"
},
"requestedTimeSlicePrice": {
"amount": 80,
"currency": "EUR"
},
"requestedPricingType": "AfterTaxes",
"includedServices": [
{
"service": {
"id": "MUC-BRKF",
"code": "BRKF",
"name": "Breakfast",
"description": "Best breakfast on this side of the Weißwurstäquator."
},
"serviceDate": "2026-11-02",
"count": 0,
"amount": {
"grossAmount": 9.99,
"netAmount": 8.39,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"bookedAsExtra": false,
"taxes": [
{
"taxDefinitionCode": "SERVICE-TAX",
"amount": {
"grossAmount": 2,
"netAmount": 2,
"vatType": "Without",
"vatPercent": 0,
"currency": "EUR"
},
"remittedBy": "Hotel"
}
]
}
]
},
{
"from": "2026-11-02T17:00:00+01:00",
"to": "2026-11-03T11:00:00+01:00",
"serviceDate": "2026-11-02",
"ratePlan": {
"id": "MUC-NONREF_SGL",
"code": "NONREF",
"name": "Non Refundable",
"description": "Non Refundable",
"isSubjectToCityTax": false
},
"unitGroup": {
"id": "MUC-SGL",
"code": "SGL",
"name": "Single",
"description": "Single",
"type": "BedRoom"
},
"baseAmount": {
"grossAmount": 91.01,
"netAmount": 85.06,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 101,
"currency": "EUR"
},
"requestedTimeSlicePrice": {
"amount": 101,
"currency": "EUR"
},
"includedServices": [
{
"service": {
"id": "MUC-BRKF",
"code": "BRKF",
"name": "Breakfast",
"description": "Best breakfast on this side of the Weißwurstäquator."
},
"serviceDate": "2026-11-03",
"count": 0,
"amount": {
"grossAmount": 9.99,
"netAmount": 8.39,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"bookedAsExtra": false,
"taxes": [
{
"taxDefinitionCode": "SERVICE-TAX",
"amount": {
"grossAmount": 2,
"netAmount": 2,
"vatType": "Without",
"vatPercent": 0,
"currency": "EUR"
},
"remittedBy": "Hotel"
}
]
}
]
}
],
"services": [
{
"service": {
"id": "MUC-YOGA",
"code": "YOGA",
"name": "Sun Salutation",
"description": "Start the day with a private Yoga session with one of our certified trainers.",
"pricingUnit": "Person",
"defaultGrossPrice": {
"amount": 35,
"currency": "EUR"
}
},
"totalAmount": {
"grossAmount": 35,
"netAmount": 29.41,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"dates": [
{
"serviceDate": "2026-11-02",
"count": 1,
"amount": {
"grossAmount": 35,
"netAmount": 29.41,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"isMandatory": false,
"taxes": [
{
"taxDefinitionCode": "SERVICE-TAX",
"amount": {
"grossAmount": 2,
"netAmount": 2,
"vatType": "Without",
"vatPercent": 0,
"currency": "EUR"
},
"remittedBy": "Hotel"
}
]
}
]
}
],
"guaranteeType": "CreditCard",
"cancellationFee": {
"id": "MUC-FLEX",
"code": "FLEX",
"name": "Flexible",
"description": "Free cancellation.",
"dueDateTime": "2026-11-01T17:00:00+01:00",
"fee": {
"amount": 202,
"currency": "EUR"
}
},
"noShowFee": {
"id": "MUC-NOSHOW",
"code": "NOSHOW",
"name": "Non Refundable",
"description": "No free no-show",
"fee": {
"amount": 202,
"currency": "EUR"
}
},
"balance": {
"amount": 220,
"currency": "EUR"
},
"validationMessages": [
{
"category": "OfferNotAvailable",
"code": "RatePlanRestrictionsViolated",
"message": "The restrictions of the rate plan are not considered"
}
],
"allFoliosHaveInvoice": false,
"taxDetails": [
{
"vatType": "Null",
"vatPercent": 0,
"net": {
"amount": 10,
"currency": "EUR"
},
"tax": {
"amount": 10,
"currency": "EUR"
}
}
],
"hasCityTax": true,
"commission": {
"commissionAmount": {
"amount": 10,
"currency": "EUR"
},
"beforeCommissionAmount": {
"amount": 100,
"currency": "EUR"
}
},
"payableAmount": {
"guest": {
"amount": 10,
"currency": "EUR"
}
},
"isOpenForCharges": true,
"isPreCheckedIn": false,
"isUnitAssignmentLocked": false,
"externalReferences": {
"globalDistributionSystemId": "A2PA6WHY",
"onlineTravelAgencyId": "5247241379",
"onlineBookingToolId": "APA_HQL-C26181420|WAW-MUN-BC2-1U1",
"channelManagerId": "123295310",
"centralReservationSystemId": "91200088",
"legacyId": "988232144060772"
}
}Changes
No operation changes recorded.