Get booking details

How you get your details

📘

Get bookings basics

  • This endpoint is a GET endpoint
  • It is useful to GET all details of a Holidu booking
  • The response is what we share via API for every Holidu booking

To get a bookings details, you just need to call the endpoint with the following parameters

ParameterRequiredTypeUsage
providerYesStringA unique identifier for every provider on our side
providerBookingIdYesStringEither the booking id orholiduBookingId
holiduBookingIdYesInt64Either the Holidu booking id orproviderBookingId

Example of a response body

{
  "providerApartmentId": "string",
  "arrival": "2022-09-01",
  "departure": "2022-09-01",
  "guests": [
    {
      "age": 0
    }
  ],
  "customer": {
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "gender": "MALE",
    "zip": "string",
    "city": "string",
    "street": "string",
    "country": "DE",
    "phone": "string",
    "language": "string"
  },
  "specialCustomerRequest": "string",
  "guestReceipt": {
    "costs": [
      {
        "id": "string",
        "name": "string",
        "basisOfCalculation": "string",
        "paymentTime": "string",
        "type": "string",
        "pricePerUnit": {
          "amount": 0,
          "currency": "string"
        },
        "unitsSelected": 0,
        "totalPrice": {
          "amount": 0,
          "currency": "string"
        }
      }
    ],
    "discount": {
      "name": "string",
      "percentage": 0,
      "amount": {
        "amount": 0,
        "currency": "string"
      }
    },
    "bareRentalPrice": {
      "amount": 0,
      "currency": "string"
    }
  },
  "paymentProcessing": {
    "paymentWithBooking": {
      "paymentPlanUuid": "string",
      "paymentHandler": "string",
      "paymentMethod": "string",
      "paymentTotalWithBooking": {
        "amount": 0,
        "currency": "string"
      },
      "paymentRates": [
        {
          "dueDate": "2022-09-01T08:43:02.189Z",
          "value": {
            "amount": 0,
            "currency": "string"
          }
        }
      ]
    },
    "paymentOnsite": [
      {
        "amount": 0,
        "currency": "string"
      }
    ]
  },
  "cancellationFees": [
    {
      "validUntil": "2022-09-01T08:43:02.189Z",
      "feeInPercentage": 0
    }
  ],
  "metaData": {
    "bookedAt": "2022-09-01T08:43:02.189Z",
    "createdAt": "2022-09-01T08:43:02.189Z",
    "updatedAt": "2022-09-01T08:43:02.189Z",
    "status": "PENDING",
    "cancelledAt": "2022-09-01T08:43:02.189Z",
    "holiduBookingId": 0,
    "commission": {
      "percentage": 0,
      "commissionToHolidu": {
        "amount": 0,
        "currency": "string"
      }
    }
  }
}