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…
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.

VouchersSummaryResponse
object
The voucher by date search response item.
2 properties
VoucherConfiguration
object
The voucher configuration model.
31 properties 6 required
IJsonResponseOfVoucher
object
Defines the JSON response contract.
3 properties
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
VoucherRequirements
integer
The voucher requirements enumeration. 0 = None 1 = RecordLocator 2 = CustomerNumber 3 = Both
Exception
object
4 properties
VoucherNameRestriction
integer
Defines how the name on the voucher will be validated. 0 = None 1 = MustBePassenger 2 = MustBePassengerOrContact
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 =…
Message
object
Defines a unique informational message.
5 properties
VoucherItem
object
The voucher item model.
13 properties
IJsonResponseOfPagedVouchersResponse
object
Defines the JSON response contract.
3 properties
RestrictFlightBatchIssuance
integer
The restrict flight batch issuance enumeration 0 = All 1 = Confirmed 2 = ConfirmedAndPaidRequired
VoucherIssuanceControl
integer
The voucher issuance control enumeration. 0 = IssuedToPassengers 1 = IssuedToContact
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
VoucherUpdateType
integer
Defines the type of voucher that can be updated to. 1 = SingleUseCredit 3 = SingleUse 4 = MultiUse 5 = SingleUseNegativeAdjustment 6 = PassengerSelect
VoucherSummary
object
The voucher summary model.
6 properties
VoucherStatus
integer
Defines the status of a voucher. 0 = Available 1 = Void 2 = Redeemed 3 = Expired
VoucherMarketRestriction
object
The voucher market restriction model.
8 properties
VoucherConfigurationRequestv2
object
The voucher configuration request model v2.
33 properties 6 required
VoucherExpirationType
integer
The voucher expiration type. 0 = TravelBy 1 = TravelCompleteBy 2 = BookingBy
VoucherReference
object
The voucher model.
19 properties
VoucherStatusUpdate
integer
An enumeration to indicate what status the voucher should be changed to. 0 = Reinstate 1 = Void
ErrorResponse
object
Defines a unique error response.
8 properties
MarketRestrictionType
integer
The market restriction type enumeration. 0 = MustBeOne 1 = MustNot
PagedVouchersResponse
object
The paged voucher search response item.
3 properties
IJsonResponseOfIListOfVoucherConfiguration
object
Defines the JSON response contract.
3 properties
Directionality
integer
Enum representing direction of an object. 0 = None 1 = To 2 = From 3 = Between
AmountControl
integer
The amount control enumeration. 0 = Fixed 1 = FixedAtIssuance 2 = Calculated
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…
TravelRestrictionType
integer
The travel restriction type. 0 = Default 1 = Blackout 2 = Season
VoucherConfigurationDeleteRequest
object
The voucher configuration delete request model.
2 properties 2 required
IJsonResponseOfVoucherReference
object
Defines the JSON response contract.
3 properties
VoucherTravelRestriction
object
The voucher configuration model.
5 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…
IJsonResponseOfVouchersSummaryResponse
object
Defines the JSON response contract.
3 properties
VoucherType
integer
Defines the type of voucher. 0 = Credit 1 = SingleUseCredit 2 = Service 3 = SingleUse 4 = MultiUse 5 = SingleUseNegativeAdjustment 6 = PassengerSelect
VoucherExpirationControl
integer
The voucher expiration control. 0 = None 1 = Fixed 2 = FixedAtIssuance 3 = Calculated
VoucherConfigurationFareClass
object
The voucher configuration model.
2 properties
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
CalculatedAmountControl
integer
Represents the different types of service a voucher could be used for. 0 = Default 1 = Fares 2 = FaresPlusTaxes 3 = FaresTaxesAndFees 4 = FaresTaxesFeesAndOthe…
VoucherTransaction
object
The voucher transaction model.
7 properties
VoucherConfigurationRequest
object
The voucher configuration request model.
33 properties 6 required
IssuanceType
integer
The issuance type. 0 = Individual 1 = Batch 2 = FlightBatch 3 = HighVolumeBatch 4 = OdBatch
VoucherTripType
integer
The types of trips a voucher could be user for. 0 = Any 1 = OneWay 2 = RoundTrip 3 = None
VoucherOwnerUpdateRequest
object
The voucher owner update request.
3 properties
Voucher
object
The voucher model.
18 properties
VoucherUpdateRequestv2
object
The voucher update request.
3 properties
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 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…

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 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
TUI Group Booking 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.