GET api/v1/Vouchers?VoucherCode={VoucherCode}

Gets a voucher with the given code, if it exists

Request Information

URI Parameters

NameDescriptionTypeAdditional information
VoucherCode

The voucher code to get the voucher for

 string

Required

Body Parameters

None.

Response Information

Resource Description

A voucher for the given code. The voucher may not be usable for bookings, there will be an exception when creating a job if this is the case.

Voucher
NameDescriptionTypeAdditional 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

Sample: 
{
  "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"
  },
  "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": "2024-07-27T08:10:50.1078667+00:00",
  "validTo": "2024-07-27T08:10:50.1078667+00:00",
  "pickupAvailableFrom": "2024-07-27T08:10:50.1078667+00:00",
  "pickupAvailableTo": "2024-07-27T08:10:50.1078667+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"
}