The booking object allows you to retrieve booking data for every booking created or updated in your OnceHub account.

The booking object

The nested data object contains all of the booking information related to the booking lifecycle event, including the following:

• A booking object with a tracking ID
• The booking subject, duration, status, creation time, start time, location, and customer time zone
• Information about related cancellations or rescheduled bookings, when relevant
• Customer data submitted in the booking form, including name, phone, email, company, time zone, as well as customer guests, note, and custom fields when relevant
• Booking page, master page, and event type data

List all bookings

You can request all bookings by using the GET request List all bookings. This is usually requested with a specific data range, booking owner, or other query parameter in mind, filtered to your specific needs.

Get a single booking

If you already have a specific booking ID from past data retrieval and your system requires full, expanded data on a specific booking, you can use the GET request Get a single booking.

You will need to indicate the booking ID using the id path parameter.

Sample booking object

Here you can see a sample booking object, which gives an idea of the information you can receive upon request.

{
  "object": "booking",
  "id": "BKNG-J4FR05BKEWEX",
  "tracking_id": "D36E0002",
  "subject": "Budget management",
  "status": "scheduled",
  "creation_time": "2020-03-22T09:48:48Z",
  "starting_time": "2020-03-22T04:30:00Z",
  "last_updated_time": "2020-03-22T09:48:48Z",
  "owner": "USR-FSD423423",
  "duration_minutes": 60,
  "virtual_conferencing": {
    "join_url": "https://meet.google.com/izv-daci-fyi"
  },
  "location_description": "1600 Pennsylvania Avenue",
  "rescheduled_booking_id": "BKNG-J4FR05BKEWEX",
  "cancel_reschedule_information": {
    "reason": "I was double booked",
    "actioned_by": "user",
    "user_id": "USR-FSD423423"
  },
  "form_submission": {
    "name": "Carrie Customer",
    "email": "[email protected]",
    "phone": "",
    "mobile_phone": "1-2025550195",
    "note": "I want to discuss how to save more money each month.",
    "company": null,
    "guests": [""],
    "custom_fields": [
      { "name": "Profession", "value": "Executive assistant" },
      { "name": "Earned income", "value": "35,000 USD" },
      { "name": "Passive income", "value": "None" }
    ]
  },
  "booking_page": "BP-X0LCRU5LES",
  "master_page": "MP-ZID28U5946",
  "event_type": "ET-7NC41GHIDZ",
  "external_calendar": {
    "type": "google",
    "name": "[email protected]",
    "id": "[email protected]",
    "event_id": "8kvu74dda8kcv0gmmlm3folrhc"
  }
}

Filter the booking object

If you'd like to narrow the scope of your data payload, you can use query parameters (indicated in reference material as QUERY PARAMS) to request only relevant data.