API - Planyo Web Services - get_reservation_data

You are here: Planyo » Help » API » get_reservation_data

get_reservation_data

Description:

This method returns details of a reservation.

Input:

reservation_id int required
ID of the reservation
language string optional
by specifying a 2-letter (ISO 639-1) language code (all capital letters e.g. EN, DE, FR, ES, IT) you can change the language of the text values returned
api_key string required
your API key - Click here to get your key. If your API key uses a hash key, you must also include the parameters hash_key and hash_timestamp.

Output:

resource_id int
ID of the resource
user_id int
ID of the user
site_id int
Planyo site ID
start_time DateTime
Beginning of reservation
end_time DateTime
End of reservation
status ReservationStatus
Reservation status
quantity int
Number of resources reserved
wants_share SharingMode
Chosen sharing mode (if available)
creation_time DateTime
Time of entry of the reservation into the system
unit_assignment string
If the admin assigned a specific unit to the reservation, it will be listed here
custom_color string
If the admin assigned a color to the reservation, it will be listed here
user_text string
Reservation status from user's perspective
user_notes string
User's notes at the time of reservation
admin_notes string
Private admin notes
total_price float
Total price for this reservation.
original_price float
Originally quoted price.
flexible_package_assignment_x int
If the resource reserved is a flexible package, for each category this returns the resource ID assigned to the reservation.
amount_paid float
Total amount paid for this reservation.
currency string
Currency used.
discount float
Discount from vouchers used (if any).
email string
User's email address
first_name string
User's first name
last_name string
User's last name
address string
User's address
city string
User's city
zip string
User's zip or postal code
state string
User's state or province
country string
User's two-letter country code (ISO 3166-1 alpha-2)
phone_number string
User's phone number (including country code)
mobile_number string
User's mobile number (including country code)
properties array
All custom reservation form items set for this reservation. This is an array whose key is property name.
log_events array
Log events for the reservation which includes the event time, admin ID (or 0 if event was triggered by the customer), comment and event number -- one of: 1=confirmed, 2=cancelled by admin, 5=cancelled by customer, 6=conflict status removed, 8=customer checked in, 9=reservation created by an admin, 12=email address verified, 13=reservation modified, 14=cancelled automatically, 15=payment removed, 16=payment added, 17=additional products modified, 18=additional form data modified, 19=non-completed reservation marked as reserved, 20=price modified, 21=customer checked out, 22=check-in status cancelled, 23=aborted reservation completed automatically, 24=confirmed status removed, 25=conflict detected, 26=other action, 27=reserved status removed, 28=cancelled status removed, 100=other admin action

API playground:

Click here to test this function in the API playground.