GET api/v1/Vouchers?AccountCode={AccountCode}&fromCreateDate={fromCreateDate}&toCreateDate={toCreateDate}
Retrieves a list of vouchers which were created between given dates for given account
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| AccountCode |
Account under which the vouchers exist. Mandatory |
string |
Default value is Empty |
| fromCreateDate |
The create time of the voucher is later than this (in UTC). Mandatory |
string |
Default value is Empty |
| toCreateDate |
The create time of the voucher is earlier than this (in UTC). Mandatory |
string |
Default value is Empty |
Body Parameters
None.
Response Information
Resource Description
A list of vouchers matching the search criteria. If no vouchers are found, an empty list is returned
Collection of Voucher| Name | Description | Type | Additional information |
|---|---|---|---|
| Partner |
The partner associated with this voucher |
Partner |
None. |
| Clients |
The clients this voucher is associated with |
Collection of Client |
None. |
| ConfigurationName |
Name of the configuration the voucher should be part of |
string |
None. |
| Code |
The unique voucher code |
string |
None. |
| IsEnabled |
Whether the voucher is enabled |
boolean |
None. |
| ValidFrom |
The date the voucher is valid from (inclusive) / Voucher cannot be used before this date |
date |
None. |
| ValidTo |
The date the voucher is valid until (inclusive) / Voucher cannot be used after this date |
date |
None. |
| PickupAvailableFrom |
The booking has to start after this date (inclusive) |
date |
None. |
| PickupAvailableTo |
The booking has to start before this date (inclusive) |
date |
None. |
| PaymentType |
How payment should be handled when using the voucher (eg. credit card, voucher only, etc) |
string |
None. |
| TermsAndConditions |
Terms and Conditions of voucher use |
string |
None. |
| RemainingUsages |
The remaining number of times the voucher may be used, or -1 for unlimited |
integer |
None. |
| MaximumUsages |
Maximum number of times the voucher may be used, or -1 for unlimited |
integer |
None. |
| DiscountPercent |
A discount in percent that this voucher will enable. 0 if no discount |
decimal number |
None. |
| DiscountAmount |
A discount in monetary terms that this voucher will enable. 0 if no discount |
decimal number |
None. |
| Attributes |
A dictionary of custom attributes for the voucher. To pre-populate fields when booking, you can use the following attributes: CardHolderCountryID: Country ID for the passenger (for visa vouchers only).; VBook field values: BookerName: Name of booker; BookerEmail: Email of booker; BookerIsPax: Set booker details as passenger details; CardHolderName: Passenger name; CardHolderEmail: Passenger email; CardHolderPhoneNumber: Passenger phone number; PaxTotalNumber: Total number of passengers(max value depends on vehicle); PaxSignboard: Passenger signboard; TransportationType: Flight, Train, Other; FlightDateTime: Date of flight; IsArrival: Is arrival flight; FlightNumber: Flight number; AirportCode: Airport code used to pick up / drop off passenger; AddressLine: Address line used to pick up / drop off passenger; VehicleCategory : Select chosen vehicle category.Business, First Class, etc.; |
Dictionary of string [key] and string [value] |
None. |
| LogoURL |
File path of the logo used for the voucher campaign. |
string |
None. |
| GroupBookingName |
Name of the group booking selected in the voucher config. |
string |
None. |
| BrandName |
Name of the brand associated with the voucher campaign. |
string |
None. |
| NewBookingCutOff |
Cut-off time (in hours) for new bookings. |
integer |
None. |
| ModifyBookingCutoff |
Cut-off time (in hours) for modifying bookings. |
integer |
None. |
| Status |
Voucher Status (See ) |
string |
None. |
| VehicleName |
Vehicle ID on the config. It will have a value when the payment type is 'Funded Base Rate'. |
string |
None. |
| AlwaysShowPrice |
If Always Show Price is set on the voucher config then prices will always show when quoting on VBook even if using a payment type where no payment is needed like voucher |
boolean |
None. |
| AlwaysRequirePaymentDetails |
If set, we must collect payment details from the booker even if there is no outstanding excess. |
boolean |
None. |
| ExtRefID |
An external reference provided by you returned to you. This should not be visible to the end user and only serves the purpose to link up different system. |
string |
None. |
Response Formats
application/json, text/json
[
{
"partner": {
"name": "sample string 1",
"address": {
"airportCode": "sample string 1",
"addressLine1": "sample string 2",
"addressLine2": "sample string 3",
"addressLine3": "sample string 4",
"postcode": "sample string 5",
"city": "sample string 6",
"country": "sample string 7",
"state": "sample string 8",
"longitude": 9.1,
"latitude": 10.1,
"postalAddress": "sample string 11",
"googlePlaceID": "sample string 12",
"googleUserInputAddress": "sample string 13",
"locationType": "sample string 14"
},
"email": "sample string 2",
"websiteURL": "sample string 3",
"bookingWebsiteURL": "sample string 4",
"notesToBooker": "sample string 5",
"notes": "sample string 6",
"phone": "sample string 7",
"tariffEmail": "sample string 8"
},
"clients": [
{
"accountCode": 1,
"name": "sample string 2",
"address": {
"airportCode": "sample string 1",
"addressLine1": "sample string 2",
"addressLine2": "sample string 3",
"addressLine3": "sample string 4",
"postcode": "sample string 5",
"city": "sample string 6",
"country": "sample string 7",
"state": "sample string 8",
"longitude": 9.1,
"latitude": 10.1,
"postalAddress": "sample string 11",
"googlePlaceID": "sample string 12",
"googleUserInputAddress": "sample string 13",
"locationType": "sample string 14"
},
"phone": "sample string 3",
"email": "sample string 4",
"logoUrl": "sample string 5",
"language": "sample string 6",
"settings": {
"sample string 1": {},
"sample string 3": {}
},
"userDefinedFields": [
{
"name": "sample string 1",
"required": true
},
{
"name": "sample string 1",
"required": true
}
]
},
{
"accountCode": 1,
"name": "sample string 2",
"address": {
"airportCode": "sample string 1",
"addressLine1": "sample string 2",
"addressLine2": "sample string 3",
"addressLine3": "sample string 4",
"postcode": "sample string 5",
"city": "sample string 6",
"country": "sample string 7",
"state": "sample string 8",
"longitude": 9.1,
"latitude": 10.1,
"postalAddress": "sample string 11",
"googlePlaceID": "sample string 12",
"googleUserInputAddress": "sample string 13",
"locationType": "sample string 14"
},
"phone": "sample string 3",
"email": "sample string 4",
"logoUrl": "sample string 5",
"language": "sample string 6",
"settings": {
"sample string 1": {},
"sample string 3": {}
},
"userDefinedFields": [
{
"name": "sample string 1",
"required": true
},
{
"name": "sample string 1",
"required": true
}
]
}
],
"configurationName": "sample string 1",
"code": "sample string 2",
"isEnabled": true,
"validFrom": "2025-11-05T14:17:46.8216883+00:00",
"validTo": "2025-11-05T14:17:46.8216883+00:00",
"pickupAvailableFrom": "2025-11-05T14:17:46.8216883+00:00",
"pickupAvailableTo": "2025-11-05T14:17:46.8216883+00:00",
"paymentType": "sample string 8",
"termsAndConditions": "sample string 9",
"remainingUsages": 10,
"maximumUsages": 11,
"discountPercent": 12.0,
"discountAmount": 13.0,
"attributes": {
"sample string 1": "sample string 2",
"sample string 3": "sample string 4"
},
"logoURL": "sample string 14",
"groupBookingName": "sample string 15",
"brandName": "sample string 16",
"newBookingCutOff": 17,
"modifyBookingCutoff": 18,
"status": "sample string 19",
"vehicleName": "sample string 20",
"alwaysShowPrice": true,
"alwaysRequirePaymentDetails": true,
"extRefID": "sample string 23"
},
{
"partner": {
"name": "sample string 1",
"address": {
"airportCode": "sample string 1",
"addressLine1": "sample string 2",
"addressLine2": "sample string 3",
"addressLine3": "sample string 4",
"postcode": "sample string 5",
"city": "sample string 6",
"country": "sample string 7",
"state": "sample string 8",
"longitude": 9.1,
"latitude": 10.1,
"postalAddress": "sample string 11",
"googlePlaceID": "sample string 12",
"googleUserInputAddress": "sample string 13",
"locationType": "sample string 14"
},
"email": "sample string 2",
"websiteURL": "sample string 3",
"bookingWebsiteURL": "sample string 4",
"notesToBooker": "sample string 5",
"notes": "sample string 6",
"phone": "sample string 7",
"tariffEmail": "sample string 8"
},
"clients": [
{
"accountCode": 1,
"name": "sample string 2",
"address": {
"airportCode": "sample string 1",
"addressLine1": "sample string 2",
"addressLine2": "sample string 3",
"addressLine3": "sample string 4",
"postcode": "sample string 5",
"city": "sample string 6",
"country": "sample string 7",
"state": "sample string 8",
"longitude": 9.1,
"latitude": 10.1,
"postalAddress": "sample string 11",
"googlePlaceID": "sample string 12",
"googleUserInputAddress": "sample string 13",
"locationType": "sample string 14"
},
"phone": "sample string 3",
"email": "sample string 4",
"logoUrl": "sample string 5",
"language": "sample string 6",
"settings": {
"sample string 1": {},
"sample string 3": {}
},
"userDefinedFields": [
{
"name": "sample string 1",
"required": true
},
{
"name": "sample string 1",
"required": true
}
]
},
{
"accountCode": 1,
"name": "sample string 2",
"address": {
"airportCode": "sample string 1",
"addressLine1": "sample string 2",
"addressLine2": "sample string 3",
"addressLine3": "sample string 4",
"postcode": "sample string 5",
"city": "sample string 6",
"country": "sample string 7",
"state": "sample string 8",
"longitude": 9.1,
"latitude": 10.1,
"postalAddress": "sample string 11",
"googlePlaceID": "sample string 12",
"googleUserInputAddress": "sample string 13",
"locationType": "sample string 14"
},
"phone": "sample string 3",
"email": "sample string 4",
"logoUrl": "sample string 5",
"language": "sample string 6",
"settings": {
"sample string 1": {},
"sample string 3": {}
},
"userDefinedFields": [
{
"name": "sample string 1",
"required": true
},
{
"name": "sample string 1",
"required": true
}
]
}
],
"configurationName": "sample string 1",
"code": "sample string 2",
"isEnabled": true,
"validFrom": "2025-11-05T14:17:46.8216883+00:00",
"validTo": "2025-11-05T14:17:46.8216883+00:00",
"pickupAvailableFrom": "2025-11-05T14:17:46.8216883+00:00",
"pickupAvailableTo": "2025-11-05T14:17:46.8216883+00:00",
"paymentType": "sample string 8",
"termsAndConditions": "sample string 9",
"remainingUsages": 10,
"maximumUsages": 11,
"discountPercent": 12.0,
"discountAmount": 13.0,
"attributes": {
"sample string 1": "sample string 2",
"sample string 3": "sample string 4"
},
"logoURL": "sample string 14",
"groupBookingName": "sample string 15",
"brandName": "sample string 16",
"newBookingCutOff": 17,
"modifyBookingCutoff": 18,
"status": "sample string 19",
"vehicleName": "sample string 20",
"alwaysShowPrice": true,
"alwaysRequirePaymentDetails": true,
"extRefID": "sample string 23"
}
]