powering tour and activity businesses worldwide

Field Definitions

Field Name Value
total total number of found tours
item an item node of matched tours
num position of the item node in the item array
uid unique numerical item ID
com common ID that groups tour options together
item tour name
option option name
code custom tour code
updated unix time stamp (last updated)
tags comma separated list of tags
starting submitted starting price for tour
group require group/passenger information {request; require; hide} – request: optional; require: required; hide: do not show
per minimum number of people required for booking to be allowed
cutoff minimum number of days in advance that booking must be made
duration text description of duration of the tour
date_selection how dates are selected, always, single_date, date_range
date node of prices for the day in the value attribute(in Y-m-d format) – refer to date node definition; only returned if there is availability for the given date
active indicates whether the date is active or not (1 or 0)
availability total number of available spots for this tour on that day
price_adult cost for adult price option
price_child cost for child price option
price_senior cost for senior price option
price4 – price9 cost for (price4 – price9) price option
adult_label label for adult price option; only returned if date is specified
child_label label for child price option; only returned if date is specified
senior_labe label for senior price option; only returned if date is specified
price4_label – price9_label label for (price4 – price9) price option; only returned if date is specified
adult_required flag to indicate if adult price option is required (0 or 1); only returned if date is specified
child_required flag to indicate if child price option is required (0 or 1); only returned if date is specified
senior_required flag to indicate if senior price option is required (0 or 1); only returned if date is specified
price4_required – price9_required flag to indicate if (price4 – price9) price option is required (0 or 1); only returned if date is specified
currency_symbol currency symbol used by company (eg. $ £ € ¥)
currency_separator symbol used as decimal point/indicator
currency_decimals number of trailing decimal places to display
currency_base the base currency that the company uses – this is for use in portals
location name name of the location
location address address of the location
city location of tour – city
state location of tour – state
country location of tour – country
lat geotag latitude
lon geotag longitude
zoom geotag map zoom level
start_date UNIX timestamp of tour start date
end_date UNIX timestamp of tour end date
line_items node of line items associated with this option
label name of this line item (e.g. Sales Tax, Booking Fee)
amount amount of line item in base currency
percent percent of line item (if no amount declared)
multi flag to indicate that this line item is charged per person (0 or 1)
tax flag to indicate if line item is a tax (0 or 1)
total_adult the total cost sum of adult price option; only returned if date is specified
total_child the total cost sum of child price option; only returned if date is specified
total_senior the total cost sum of senior price option; only returned if date is specified
total_price4 – total_price9 the total cost of (price4 – price9) price option; only returned if date is specified
sub_total calculated sub-total
taxes calculated tax value (returned with a value when passenger info has been passed)
tax_calc calculated tax value (returned with a value when passenger info has been passed)
overall_total the total cost of the booking (only returned when passenger info has been passed); only returned if date is specified
deposit deposit amount required upon booking discrete value or percentage or amount required to be paid as deposit upon booking; only returned if date is specified
deposit_value currently not used
total_availability total number of available spots for this tour on that day; only returned if date is specified
group_forms node of forms given during booking – refer to group forms node definition; only returned if date is specified
id unique numerical form ID
type forms type of input
title title of the form
instructions the instructions associated with the field
require flag to indicate if form is required to be filled (0 or 1)
options for type select, these are the options available with this field
price price of the option (either added or subtracted for enabling this option) – only enabled for checkbox forms
primary_forms node of forms given during booking – refer to primary forms node definition; only returned if date is specified
id unique numerical form ID
type forms type of input
title title of the form
instructions the instructions associated with the field
require flag to indicate if form is required to be filled (0 or 1)
options for type select, these are the options available with this field
price price of the option (either added or subtracted for enabling this option) – only enabled for checkbox forms
details node of detailed info – refer to details node definition
overview text – overview (HTML-formatted)
itinerary text – itinerary (HTML-formatted)
pick_up text – pick-up and departure info
drop_off text – drop-off and return info
bring text – things to bring info
inclusions text – inclusion info
exclusions text – exclusion info
cancellation text – cancellation info
description_name text – name of the customizable additional info field
description text – description of item (HTML-formatted)
specifications node of customized inventory layout fields – these are fields created by the account holder to share additional information about the inventory item
name name of the custom inventory field
value value of the custom inventory field
seo node of seo info
title seo page title for inventory item (used as page title if declared)
introduction meta description for inventory item
related node of related inventory items
item node of individual related item
com SKU of the inventory item (not option level SKU)
name name of the inventory item
media node of images – number of results found included in the value attribute
path absolute path of the image
caption the text caption associated with the image
 cid  unique numerical ID to identify the company that supplies this item
 v  version of the API being used
 gt  time to generate the result (used for SLA purposes)

Written by

Stephen is the CEO and Co-Founder of Rezgo. He has been working as a travel & tourism technology consultant since 1995. Stephen is active in fostering tourism technology and is a Past Chair of the OpenTravel Alliance. He is also a regular contributor for Tnooz, a leading travel technology media site, and speaks regularly at conferences around the Globe on travel & tourism technology, messaging standards, and industry trends.