...
The getVoucherInformation
operation will return detailed information about a properties voucher account, along with details of any vouchers/tickets configured in the IBE.
Request
Element | Type | Description |
siteIDList | Array | (Mandatory) A list of property IDs for which voucher information should be returned. This must be a subset of properties that are enabled for your API. |
options | Specify one or more of the available options to determine what information is returned in the response. List of Options |
...
Code Block | ||
---|---|---|
| ||
{ "userAuth": { "username": "username", "password": "password" }, "operation": "getVoucherInformation", "siteIDList": [ 1853 ], "options": [ "fullPropertyInformation", "voucherInformation", "ticketInformation", "imageInformation" ] } |
Options
Option | Type | Description |
fullPropertyInformation | String | Property information including name, address, geolocation, facilities and other property configuration options. |
voucherInformation | String | Full voucher including title, description, images pricing and URL. |
ticketInformation | String | Full ticket information including title, description, images and URL. |
imageInformation | String | If this option is specified in conjunction with the voucherInformation or ticketInformation options, full image information will be returned in the response. |
Response
Element | Type | Description | |||
siteList | Array | The siteList array will contain an entry for each site as requested in the siteIDList section of the request. | |||
siteID | Integer | The internal IBE siteID for the property. | |||
primaryName | String | Property name. | |||
address | String | Property address. | |||
phone | String | Property phone number. | |||
fax | String | Property fax number. | |||
url | String | Property website url. | |||
String | Property email address. | ||||
voucherList | Array | The voucherList array will contain an entry for each voucher available for sale. | |||
title | String | The title of the voucher. | |||
description | String | The description of the voucher. | |||
category | String | The voucher category | |||
images | Array | An array of images associated with the voucher. | |||
groupID | Integer | The internal groupID of the image in the IBE. | |||
size | String | The height x width dimensions of the image. | |||
url | String | The URL for where the image is stored. | |||
prices | Array | An array of images associated with the voucher. | |||
type | String | The price type of the voucher. This can be one of 2 values, "fixedValue" or "dynamicValue". | |||
minValue | Integer|Float | The minimum monetary value that this voucher can be sold for. | |||
maxValue | Integer|Float | The maximum monetary value that this voucher can be sold for. | |||
stepValue | Integer|Float | The stepValue can be used in conjunction with the minValue and maxValue to determine the monetary sale amounts for dynamic value vouchers. | |||
strikeValue | Integer|Float | This can be used to indicate that the sale price of a voucher is struck through from a higher price giving the indication that the voucher is on sale or special offer. | |||
totalQuantity | Integer|NULL | The total quantity of this voucher available to be sold. | |||
totalQuantitySold | Integer|NULL | The total quantity of this voucher already sold. | |||
startSell | String | This can be used to indicate the beginning of a sell date restriction period. | |||
endSell | String | This can be used to indicate the end of a sell date restriction period. | |||
maxPerSale | Integer | This can be used to limit the number of vouchers that can be purchased in one transaction. | |||
url | String | The direct link to this voucher in the IBE. | |||
ticketList | Array | The ticketList array will contain an entry for each ticket available for sale. | |||
type | String | The price type of the ticket. This can be one of 2 values, "fixedValue" or "dynamicValue". | |||
minValue | Integer|Float | The minimum monetary value that this ticket can be sold for. | |||
maxValue | Integer|Float | The maximum monetary value that this ticket can be sold for. | |||
stepValue | Integer|Float | The stepValue can be used in conjunction with the minValue and maxValue to determine the monetary sale amounts for dynamic value tickets. | |||
strikeValue | Integer|Float | This can be used to indicate that the sale price of a ticket is struck through from a higher price giving the indication that the ticket is on sale or special offer. | |||
totalQuantity | Integer|NULL | The total quantity of this ticket available to be sold. | |||
totalQuantitySold | Integer|NULL | The total quantity of this ticket already sold. | |||
startSell | String | This can be used to indicate the beginning of a sell date restriction period. | |||
endSell | String | This can be used to indicate the end of a sell date restriction period. | |||
maxPerSale | Integer | This can be used to limit the number of tickets that can be purchased in one transaction. | |||
tiers | Array | An array of pricing tiers that apply to this ticket. | |||
titleShort | String | The short title of the price tier. | |||
titleLong | String | The long title of the price tier. | |||
description | String | The description of the price tier. | |||
unitValue | Integer|Float | The monetary value that this ticket price is to be sold for on this tier. | |||
strikeValue | Integer|Float | This can be used to indicate that the sale price of a ticket is struck through from a higher price giving the indication that the ticket is on sale or special offer. | |||
totalQuantity | Integer|NULL | The total quantity of this ticket available to be sold on this tier. | |||
totalQuantitySold | Integer|NULL | The total quantity of this ticket already sold on this tier. | |||
maxPerSale | Integer | This can be used to limit the number of tickets that can be purchased on this tier in one transaction. | |||
startSell | String | This can be used to indicate the beginning of a sell date restriction period. | |||
endSell | String | This can be used to indicate the end of a sell date restriction period. | |||
url | String | The direct link to this ticket in the IBE. |
Voucher Price Types
Price Type | Description |
fixedValue | Fixed value vouchers have one single monetary value assigned to it. |
dynamicValue | Dynamic value vouchers/tickets can vary in monetary value, used in conjunction with the stepValue to determine the price points available. |
perPersonValue | Per person priced vouchers will charge the assigned monetary value for the number of people selected. |
Ticket Price Types
Price Type | Description |
fixedValue | Fixed value tickets have one single monetary value assigned to it. |
tiersValue | Tiers value tickets will have one or more tiers configured, each tier will have a separate price point. |
perPersonValue | Per person priced tickets will charge the assigned monetary value for the number of people selected. |
...