How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TUI Group Vouchers API

The vouchers API from TUI Group — 11 operation(s) for vouchers.

TUI Group Vouchers API is one of 113 APIs that TUI Group publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Vouchers. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 16 operations across 11 paths, and defines 50 schemas. It is described by OpenAPI 3.2.0, at version 4.8.6.23.

Requests are made against 2 base URLs: https://prod.api.tui/flight/newskies/rest, https://playground.api.tui/flight/newskies/rest.

16 operations 11 paths 50 schemas 1 DELETE9 GET2 PATCH2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
4.8.6.23
Base URL
https://prod.api.tui/flight/newskies/rest
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

TUI Group Vouchers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (jwt) (JWT). By default, every request must be authenticated.

  • JWT — Paste your JWT token from the token endpoint.

Paths & Operations 16

Across 11 paths, the API surfaces 16 operations — 1 DELETE, 9 GET, 2 PATCH, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

vouchers 16
GET
/api/nsk/v2/vouchersdeprecated
Gets vouchers based upon data in the request.
nsk_v2_vouchers_get 20 params → 200404400
GET
/api/nsk/v1/vouchers/{voucherKey}
Gets a specific voucher based upon the voucher key.
nsk_v1_vouchers_voucherKey_get 1 param → 200404
PATCH
/api/nsk/v1/vouchers/{voucherKey}
Changes the voucher status, type, or expiration date.
nsk_v1_vouchers_voucherKey_patch 1 param body → 200400
PATCH
/api/nsk/v1/vouchers/{voucherKey}/owner
Changes the voucher owner.
nsk_v1_vouchers_voucherKey_owner_patch 1 param body → 200400
GET
/api/nsk/v2/vouchers/byAgent
Gets a collection of vouchers based on the specified agent information.
nsk_v2_vouchers_byAgent_get 7 params → 200404400
GET
/api/nsk/v1/vouchers/byDate
Searches for vouchers issued within the given date range.
nsk_v1_vouchers_byDate_get 4 params → 200400404
GET
/api/nsk/v2/vouchers/byIssuance/{voucherIssuanceKey}
Gets vouchers associated with a voucher issuance.
nsk_v2_vouchers_byIssuance_voucherIssuanceKey_get 4 params → 200404400
GET
/api/nsk/v2/vouchers/byMarket
Gets a collection of vouchers based on the market information.
nsk_v2_vouchers_byMarket_get 9 params → 200400404
GET
/api/nsk/v1/vouchers/byReference/{voucherReferenceNumber}
Gets a specific voucher based upon the voucher reference number.
nsk_v1_vouchers_byReference_voucherReferenceNumber_get 1 param → 200404
GET
/api/nsk/v1/vouchers/configuration
Performs a shallow call to get all available voucher configurations.
nsk_v1_vouchers_configuration_get → 200404
POST
/api/nsk/v1/vouchers/configurationdeprecated
Creates a new voucher configuration.
nsk_v1_vouchers_configuration_post body → 404200
PUT
/api/nsk/v1/vouchers/configurationdeprecated
Updates a voucher configuration.
nsk_v1_vouchers_configuration_put body → 404200
DELETE
/api/nsk/v1/vouchers/configuration
Deletes a voucher configuration.
nsk_v1_vouchers_configuration_delete body → 404200
POST
/api/nsk/v2/vouchers/configuration
Creates a new voucher configuration.
nsk_v2_vouchers_configuration_post body → 404200
PUT
/api/nsk/v2/vouchers/configuration
Updates a voucher configuration.
nsk_v2_vouchers_configuration_put body → 404200
GET
/api/nsk/v1/vouchers/configuration/{configurationCode}
Performs a deep call to get a specific voucher configuration based on the configuration code.
nsk_v1_vouchers_configuration_configurationCode_get 1 param → 200404

Schemas 50

The contract defines 50 schemas that model the data the API accepts and returns. The most detailed are VoucherConfigurationRequestv2 (33 properties), VoucherConfigurationRequest (33 properties), VoucherConfiguration (31 properties), VoucherReference (19 properties). Each schema is shown below with its type and property counts.

VoucherStatusUpdate
integer
An enumeration to indicate what status the voucher should be changed to. 0 = Reinstate 1 = Void
TravelRestrictionType
integer
The travel restriction type. 0 = Default 1 = Blackout 2 = Season
VoucherExpirationControl
integer
The voucher expiration control. 0 = None 1 = Fixed 2 = FixedAtIssuance 3 = Calculated
IJsonResponseOfIListOfVoucherConfiguration
object
Defines the JSON response contract.
3 properties
VoucherExpirationType
integer
The voucher expiration type. 0 = TravelBy 1 = TravelCompleteBy 2 = BookingBy
MarketRestrictionType
integer
The market restriction type enumeration. 0 = MustBeOne 1 = MustNot
FindVoucherSortCriteria
integer
Defines the criteria in which the find vouchers result can be sorted. Defaults to CreatedDateAscending if not specified or invalid. 0 = CreatedDateAscending 1…
VouchersSummaryResponse
object
The voucher by date search response item.
2 properties
IJsonResponseOfPagedVouchersResponse
object
Defines the JSON response contract.
3 properties
VoucherTravelRestriction
object
The voucher configuration model.
5 properties
VoucherRequirements
integer
The voucher requirements enumeration. 0 = None 1 = RecordLocator 2 = CustomerNumber 3 = Both
VoucherItem
object
The voucher item model.
13 properties
IJsonResponseOfVoucherConfiguration
object
Defines the JSON response contract.
3 properties
VoucherTransactionType
integer
Defines voucher transaction type. 0 = Debit 1 = Credit 2 = Void 3 = Reinstate 4 = Adjustment 5 = ExpirationDateChange 6 = VoucherTypeChange 7 = VoucherOwnerCha…
Exception
object
4 properties
VoucherIssuanceControl
integer
The voucher issuance control enumeration. 0 = IssuedToPassengers 1 = IssuedToContact
VoucherReference
object
The voucher model.
19 properties
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
IJsonResponseOfVouchersSummaryResponse
object
Defines the JSON response contract.
3 properties
VoucherStatus
integer
Defines the status of a voucher. 0 = Available 1 = Void 2 = Redeemed 3 = Expired
IssuanceType
integer
The issuance type. 0 = Individual 1 = Batch 2 = FlightBatch 3 = HighVolumeBatch 4 = OdBatch
VoucherConfigurationRequest
object
The voucher configuration request model.
33 properties 6 required
VoucherSummary
object
The voucher summary model.
6 properties
IJsonResponseOfVoucher
object
Defines the JSON response contract.
3 properties
RegionType
integer
Enum reprenting the the region type used to indicate the kind of region an item is associated with. 0 = Default 1 = Station 2 = City 3 = ProvinceState 4 = Coun…
VoucherConfigurationFareClass
object
The voucher configuration model.
2 properties
VoucherUsageBaseFeeType
integer
Voucher usage type specifies whether the voucher can be used for included taxes of non-fare components (e.g. SSR fees). 0 = None 1 = BaseFeeOnly
VoucherTripType
integer
The types of trips a voucher could be user for. 0 = Any 1 = OneWay 2 = RoundTrip 3 = None
AmountControl
integer
The amount control enumeration. 0 = Fixed 1 = FixedAtIssuance 2 = Calculated
ErrorResponse
object
Defines a unique error response.
8 properties
IJsonResponseOfVoucherReference
object
Defines the JSON response contract.
3 properties
Message
object
Defines a unique informational message.
5 properties
VoucherOwnerUpdateRequest
object
The voucher owner update request.
3 properties
CalculatedAmountControl
integer
Represents the different types of service a voucher could be used for. 0 = Default 1 = Fares 2 = FaresPlusTaxes 3 = FaresTaxesAndFees 4 = FaresTaxesFeesAndOthe…
VoucherUsageType
integer
Voucher usage type specifies what parts of a booking this voucher can pay for. 0 = None 1 = Fares 2 = Taxes 3 = TravelFees 4 = ServiceFees 5 = PenaltyFees 6 =…
Directionality
integer
Enum representing direction of an object. 0 = None 1 = To 2 = From 3 = Between
VoucherConfigurationRequestv2
object
The voucher configuration request model v2.
33 properties 6 required
Voucher
object
The voucher model.
18 properties
VoucherMarketRestriction
object
The voucher market restriction model.
8 properties
RestrictFlightBatchIssuance
integer
The restrict flight batch issuance enumeration 0 = All 1 = Confirmed 2 = ConfirmedAndPaidRequired
VoucherUpdateRequestv2
object
The voucher update request.
3 properties
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 properties
VoucherUpdateType
integer
Defines the type of voucher that can be updated to. 1 = SingleUseCredit 3 = SingleUse 4 = MultiUse 5 = SingleUseNegativeAdjustment 6 = PassengerSelect
VoucherConfiguration
object
The voucher configuration model.
31 properties 6 required
VoucherType
integer
Defines the type of voucher. 0 = Credit 1 = SingleUseCredit 2 = Service 3 = SingleUse 4 = MultiUse 5 = SingleUseNegativeAdjustment 6 = PassengerSelect
DayOfWeek
integer
Defines the day of the week with none as an option. 0 = None 1 = Monday 2 = Tuesday 3 = Wednesday 4 = Thursday 5 = Friday 6 = Saturday 7 = Sunday
PagedVouchersResponse
object
The paged voucher search response item.
3 properties
VoucherNameRestriction
integer
Defines how the name on the voucher will be validated. 0 = None 1 = MustBePassenger 2 = MustBePassengerOrContact
VoucherConfigurationDeleteRequest
object
The voucher configuration delete request model.
2 properties 2 required
VoucherTransaction
object
The voucher transaction model.
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tui-group-vouchers-api-openapi.yml Raw ↑

Other APIs TUI Group publishes across the network.

TUI Group Account API
TUI Group Airline Profile API
TUI Group Air Shopping API
TUI Group APIS Message API
TUI Group Apo API
TUI Group Auth API
TUI Group Availability API
TUI Group Baggage API
TUI Group Bag Tag API
TUI Group Boarding API
TUI Group Boarding Devices API
TUI Group Booking/addons API
Where this information came from

This is an independent, third-party profile of TUI Group Vouchers API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.