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 Organizations2 API

The organizations2 API from TUI Group — 35 operation(s) for organizations2.

TUI Group Organizations2 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 organizations2. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 51 operations across 35 paths, and defines 93 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.

51 operations 35 paths 93 schemas 6 DELETE21 GET1 PATCH14 POST9 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 Organizations2 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 51

Across 35 paths, the API surfaces 51 operations — 6 DELETE, 21 GET, 1 PATCH, 14 POST, 9 PUT. Each is listed below with its method, path, parameters, and response codes.

organizations2 51
POST
/api/nsk/v1/organizations2
Create a new organization.
nsk_v1_organizations2_post body → 201
GET
/api/nsk/v2/organizations2
Searches for organizations.
nsk_v2_organizations2_get 14 params → 404200
GET
/api/nsk/v1/organizations2/{organizationCode}
Retrieves the organization.
nsk_v1_organizations2_organizationCode_get 1 param → 404200
PUT
/api/nsk/v1/organizations2/{organizationCode}
Updates an organization.
nsk_v1_organizations2_organizationCode_put 1 param body → 200
PATCH
/api/nsk/v1/organizations2/{organizationCode}
Updates an organization.
nsk_v1_organizations2_organizationCode_patch 1 param body → 200
GET
/api/nsk/v1/organizations2/{organizationCode}/account
Retrieves the organization account and collections based on the organization code.
nsk_v1_organizations2_organizationCode_account_get 1 param → 404200
POST
/api/nsk/v1/organizations2/{organizationCode}/account
Creates an organization account based on the organization code.
nsk_v1_organizations2_organizationCode_account_post 1 param body → 201400
POST
/api/nsk/v1/organizations2/{organizationCode}/account/childAccountTransactions
Adjust the available amount of a child account.
nsk_v1_organizations2_organizationCode_account_childAccountTransactions_post 1 param body → 201400
PUT
/api/nsk/v1/organizations2/{organizationCode}/account/childAccountTransactions
Adjust the credit limit of a child account.
nsk_v1_organizations2_organizationCode_account_childAccountTransactions_put 1 param body → 201400
PUT
/api/nsk/v1/organizations2/{organizationCode}/account/status
Updates the organization account status.
nsk_v1_organizations2_organizationCode_account_status_put 2 params → 200500
GET
/api/nsk/v1/organizations2/{organizationCode}/account/transactionsdeprecated
Retrieves the organization account transactions based on the organization code and data in the request.
nsk_v1_organizations2_organizationCode_account_transactions_get 6 params → 200400
POST
/api/nsk/v1/organizations2/{organizationCode}/account/transactions
Creates account transactions based on data in the request and the organization code.
nsk_v1_organizations2_organizationCode_account_transactions_post 1 param body → 201400
GET
/api/nsk/v2/organizations2/{organizationCode}/account/transactions
Retrieves the organization account transactions based on the organization code and data in the request.
nsk_v2_organizations2_organizationCode_account_transactions_get 6 params → 200400404
GET
/api/nsk/v1/organizations2/{organizationCode}/allotments/contracts
Retrieves all allotment contracts for the specified organization.
nsk_v1_organizations2_organizationCode_allotments_contracts_get 1 param → 200400
POST
/api/nsk/v1/organizations2/{organizationCode}/allotments/contracts
Creates the specified allotment contract.
nsk_v1_organizations2_organizationCode_allotments_contracts_post 1 param body → 201400
PUT
/api/nsk/v1/organizations2/{organizationCode}/allotments/contracts/{contractCode}
Updates the specified allotment contract.
nsk_v1_organizations2_organizationCode_allotments_contracts_contractCode_put 2 params body → 200400
POST
/api/nsk/v1/organizations2/{organizationCode}/commissionRates
Create a commission rate.
nsk_v1_organizations2_organizationCode_commissionRates_post 1 param body → 201
GET
/api/nsk/v1/organizations2/{organizationCode}/commissionRates/{commissionRateCode}
Get a commission rate.
nsk_v1_organizations2_organizationCode_commissionRates_commissionRateCode_get 2 params → 200
DELETE
/api/nsk/v1/organizations2/{organizationCode}/commissionRates/{commissionRateCode}
Delete a commission rate.
nsk_v1_organizations2_organizationCode_commissionRates_commissionRateCode_delete 2 params → 201
POST
/api/nsk/v1/organizations2/{organizationCode}/company/phoneNumbers
Create a company phone number.
nsk_v1_organizations2_organizationCode_company_phoneNumbers_post 1 param body → 201
PUT
/api/nsk/v1/organizations2/{organizationCode}/company/phoneNumbers/{phoneNumberType}
Updates a company phone number.
nsk_v1_organizations2_organizationCode_company_phoneNumbers_phoneNumberType_put 2 params body → 200
DELETE
/api/nsk/v1/organizations2/{organizationCode}/company/phoneNumbers/{phoneNumberType}
Deletes a company phone number.
nsk_v1_organizations2_organizationCode_company_phoneNumbers_phoneNumberType_delete 2 params → 200
POST
/api/nsk/v1/organizations2/{organizationCode}/contact/phoneNumbers
Create a contact phone number.
nsk_v1_organizations2_organizationCode_contact_phoneNumbers_post 1 param body → 201
PUT
/api/nsk/v1/organizations2/{organizationCode}/contact/phoneNumbers/{phoneNumberType}
Updates a contact phone number.
nsk_v1_organizations2_organizationCode_contact_phoneNumbers_phoneNumberType_put 2 params body → 200
DELETE
/api/nsk/v1/organizations2/{organizationCode}/contact/phoneNumbers/{phoneNumberType}
Deletes a contact phone number.
nsk_v1_organizations2_organizationCode_contact_phoneNumbers_phoneNumberType_delete 2 params → 200
POST
/api/nsk/v1/organizations2/{organizationCode}/externalAccounts
Create an external account.
nsk_v1_organizations2_organizationCode_externalAccounts_post 1 param body → 201
GET
/api/nsk/v1/organizations2/{organizationCode}/externalAccounts/{externalAccountKey}
Get an external account.
nsk_v1_organizations2_organizationCode_externalAccounts_externalAccountKey_get 2 params → 200
DELETE
/api/nsk/v1/organizations2/{organizationCode}/externalAccounts/{externalAccountKey}
Delete an external account.
nsk_v1_organizations2_organizationCode_externalAccounts_externalAccountKey_delete 2 params → 201
GET
/api/nsk/v1/organizations2/{organizationCode}/processSchedules
Returns a list of Process Schedules for the organization.
nsk_v1_organizations2_organizationCode_processSchedules_get 1 param → 200400404
POST
/api/nsk/v1/organizations2/{organizationCode}/processSchedules/{processScheduleId}
Adds a process schedule to the organization.
nsk_v1_organizations2_organizationCode_processSchedules_processScheduleId_post 2 params → 201
DELETE
/api/nsk/v1/organizations2/{organizationCode}/processSchedules/{processScheduleId}
Deletes a process schedule from the organization.
nsk_v1_organizations2_organizationCode_processSchedules_processScheduleId_delete 2 params → 200
GET
/api/nsk/v1/organizations2/allotments
Retrieves all allotments for the specified leg.
nsk_v1_organizations2_allotments_get 1 param → 200400
GET
/api/nsk/v1/organizations2/allotments/{allotmentBasisCode}
Retrieves a single allotment for the specified leg using the given allotment basis code.
nsk_v1_organizations2_allotments_allotmentBasisCode_get 2 params → 200400
GET
/api/nsk/v1/organizations2/allotments/{contractCode}/bases
Retrieves all allotment bases for the specified contract.
nsk_v1_organizations2_allotments_contractCode_bases_get 3 params → 200400
POST
/api/nsk/v1/organizations2/allotments/{contractCode}/bases
Creates the specified allotment basis.
nsk_v1_organizations2_allotments_contractCode_bases_post 1 param body → 201400
PUT
/api/nsk/v1/organizations2/allotments/{contractCode}/bases/{allotmentBasisCode}
Updates the specified allotment basis.
nsk_v1_organizations2_allotments_contractCode_bases_allotmentBasisCode_put 2 params body → 200400
GET
/api/nsk/v1/organizations2/allotments/bases/{allotmentBasisCode}
Retrieves the specified allotment basis.
nsk_v1_organizations2_allotments_bases_allotmentBasisCode_get 1 param → 200400
GET
/api/nsk/v1/organizations2/allotments/bases/{allotmentBasisCode}/marketFares
Gets all market fares for the given allotment basis.
nsk_v1_organizations2_allotments_bases_allotmentBasisCode_marketFares_get 1 param → 200400404
POST
/api/nsk/v1/organizations2/allotments/bases/{allotmentBasisCode}/marketFares
Creates the specified allotment basis market fare.
nsk_v1_organizations2_allotments_bases_allotmentBasisCode_marketFares_post 1 param body → 201400
GET
/api/nsk/v1/organizations2/allotments/bases/{allotmentBasisCode}/marketFares/{allotmentMarketFareKey}
Gets the specified market fare for the given allotment basis.
nsk_v1_organizations2_allotments_bases_allotmentBasisCode_marketFares_allotmentMarketFareKey_get 2 params → 200400404
PUT
/api/nsk/v1/organizations2/allotments/bases/{allotmentBasisCode}/marketFares/{allotmentMarketFareKey}
Updates the specified allotment basis market fare.
nsk_v1_organizations2_allotments_bases_allotmentBasisCode_marketFares_allotmentMarketFareKey_put 2 params body → 200400
DELETE
/api/nsk/v1/organizations2/allotments/bases/{allotmentBasisCode}/marketFares/{allotmentMarketFareKey}
Deletes the specified allotment basis market fare.
nsk_v1_organizations2_allotments_bases_allotmentBasisCode_marketFares_allotmentMarketFareKey_delete 2 params → 200400
GET
/api/nsk/v1/organizations2/allotments/byAllotmentBasisCode/{allotmentBasisCode}
Retrieves all allotments for the specified allotment basis code.
nsk_v1_organizations2_allotments_byAllotmentBasisCode_allotmentBasisCode_get 1 param → 200400
GET
/api/nsk/v1/organizations2/allotments/contracts/{contractCode}
Retrieves the specified allotment contract.
nsk_v1_organizations2_allotments_contracts_contractCode_get 1 param → 200400
POST
/api/nsk/v1/organizations2/contracts/basis/{allotmentBasisCode}/allotments/legs/{legKey}
Creates an allotment for the specified leg.
nsk_v1_organizations2_contracts_basis_allotmentBasisCode_allotments_legs_legKey_post 2 params body → 201400
PUT
/api/nsk/v1/organizations2/contracts/basis/{allotmentBasisCode}/allotments/legs/{legKey}
Updates an allotment for the specified leg.
nsk_v1_organizations2_contracts_basis_allotmentBasisCode_allotments_legs_legKey_put 2 params body → 200400
GET
/api/nsk/v1/organizations2/processSchedule/{processScheduleId}deprecated
Returns a single Process Schedule object.
nsk_v1_organizations2_processSchedule_processScheduleId_get 1 param → 200404
GET
/api/nsk/v2/organizations2/processSchedule/{processScheduleId}
Returns a single Process Schedule object.
nsk_v2_organizations2_processSchedule_processScheduleId_get 1 param → 200404
GET
/api/nsk/v1/organizations2/processSchedulesdeprecated
Returns a list of active process schedules.
nsk_v1_organizations2_processSchedules_get → 200
GET
/api/nsk/v2/organizations2/processSchedules
Returns a list of active process schedules.
nsk_v2_organizations2_processSchedules_get → 200
POST
/api/nsk/v1/organizations2/register
Requests to register a new organization.
nsk_v1_organizations2_register_post body → 201

Schemas 93

The contract defines 93 schemas that model the data the API accepts and returns. The most detailed are AllotmentResponse (14 properties), AllotmentBasisResponse (13 properties), OrganizationAccount (13 properties), OrganizationCreateRequest (13 properties). Each schema is shown below with its type and property counts.

OrganizationTransactionRequest
object
The organization account transaction request.
4 properties 2 required
PagedTransactionResponse
object
The paged transaction response.
3 properties
OrganizationEditRequest
object
The base data on the organization.
9 properties
IJsonResponseOfProcessSchedulev2
object
Defines the JSON response contract.
3 properties
OrganizationStatus
integer
Organization status. 0 = Default 1 = Active 2 = Cancelled 3 = Pending
ContactDetails
object
The contact details for an organization.
2 properties
AllotmentBasisRequest
object
The allotment basis request model
11 properties 3 required
IJsonResponseOfIListOfAllotmentMarketFareResponse
object
Defines the JSON response contract.
3 properties
OrganizationProcessSchedule
object
The OrganizationCode defines a link between an Organization and a ProcessSchedule.
1 property
AccountCollectionBase
object
The account collection base model.
4 properties
IJsonResponseOfOrganizationv2
object
Defines the JSON response contract.
3 properties
AllotmentContractProperty
object
The allotment contract property.
2 properties
AllotmentResponse
object
The allotment response model.
14 properties
CompanyEditDetails
object
The organization company details of an organization.
6 properties 1 required
IJsonResponseOfAllotmentCreatedResponse
object
Defines the JSON response contract.
3 properties
MonthWeek
integer
MonthWeek Enumeration. Based on ones for SQL server scheduler, not all included. 0 = None 1 = First 2 = Second 3 = Third 4 = Fourth 5 = Last
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
TransportationIdentifier
object
Represents the transportation identifier model data.
3 properties 2 required
IJsonResponseOfOrganizationAccount
object
Defines the JSON response contract.
3 properties
AllowedTransactionTypes
integer
The dotREZ specific transaction types. 0 = Default 1 = Payment 2 = Adjustment 3 = Supplementary
ExternalDistributionOption
integer
Describes the external distribution option. 0 = NoDistribution 1 = UseOrganizationEmailOnly 2 = UseMessageEmailOnly 3 = UseMessageEmail
OrganizationConfigurationv2
object
The configuration details of an organization.
11 properties
DeltaMapperOfOrganizationEditRequest
object
Map delta changes of a specific type T to another object.
9 properties
AllotmentMarketFareRequest
object
The allotment market fare update request model.
7 properties 3 required
AccountType
integer
The account type enumeration. 0 = Credit 1 = Prepaid 2 = Supplementary 3 = Dependent 4 = Unknown
OrganizationRecord
object
The data on the user related agent's organization.
6 properties 1 required
PhoneNumberBase
object
Defines a common phone number base.
1 property 1 required
IJsonResponseOfPagedTransactionResponse
object
Defines the JSON response contract.
3 properties
IJsonResponseOfIListOfProcessSchedule
object
Defines the JSON response contract.
3 properties
PhoneNumberType
integer
Defines the types of phone numbers. Note: New Skies does not support Mobile for booking contacts. 0 = Other 1 = Home 2 = Work 3 = Mobile 4 = Fax
ReferralType
integer
Referral type. 0 = Default 1 = Allowed 2 = AllowedWithUrlMatch 3 = NotAllowed
AllotmentClassType
integer
The class of service type enumeration. 4 = NegoAllotment 5 = ProrataAllotment
OrganizationExternalAccountRequest
object
The data for an organizations external account.
7 properties
Message
object
Defines a unique informational message.
5 properties
IJsonResponseOfAllotmentContractResponse
object
Defines the JSON response contract.
3 properties
MarketInformation
object
Model information about the market arrival and destination details.
4 properties 4 required
Transaction
object
The transaction model.
13 properties 2 required
RetrieveAllotmentBasisResponse
object
The retrieve allotment basis response model
2 properties
IJsonResponseOfProcessSchedule
object
Defines the JSON response contract.
3 properties
ChildAccountTransactionsRequest
object
The organization account transaction request.
1 property 1 required
AllotmentCreatedResponse
object
Model representing a created allotment.
4 properties
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 properties
AllotmentBasisUpdateRequest
object
The allotment basis update request model
10 properties
OrganizationAccount
object
The organization account model.
13 properties
AllotmentContractUpdateRequest
object
The allotment contract update request model
3 properties
IJsonResponseOfRetrieveAllotmentBasisResponse
object
Defines the JSON response contract.
3 properties
MatchCriteria
integer
Defines the matching criteria for strings. 0 = StartsWith 1 = EndsWith 2 = Contains 3 = ExactMatch
CompanyDetails
object
The organization company details of an organization.
7 properties
Exception
object
4 properties
IJsonResponseOfIListOfAllotmentResponse
object
Defines the JSON response contract.
3 properties
PhoneNumber
object
Defines a common phone number.
2 properties 2 required
AllotmentContractStatus
integer
The allotment contract status enumeration. 0 = Default 1 = Active 2 = Closed
IJsonResponseOfIListOfProcessSchedulev2
object
Defines the JSON response contract.
3 properties
IJsonResponseOfAllotmentBasisResponse
object
Defines the JSON response contract.
3 properties
IJsonResponseOfIListOfOrganizationRecord
object
Defines the JSON response contract.
3 properties
Name
object
Defines a common name.
5 properties
AllowedAccountTypes
integer
The allowed account type enumeration. These are a subset of the AccountTypes enumeartion and represent the currently supported account types for an account cre…
Address
object
Defines a common address.
7 properties
AllotmentBasisStatus
integer
The allotment basis status enumeration. 0 = Default 1 = Active 2 = Closed
AllotmentMarketFareResponse
object
The allotment market fare response model
10 properties
AccountStatus
integer
The account status enumeration. 0 = Open 1 = Closed 2 = AgencyInactive 3 = Unknown
IJsonResponseOfIListOfAllotmentContractResponse
object
Defines the JSON response contract.
3 properties
IJsonResponseOfAllotmentResponse
object
Defines the JSON response contract.
3 properties
OrganizationType
integer
Organization type. 0 = Default 1 = Master 2 = Carrier 3 = TravelAgency 4 = ThirdParty
AllotmentContractRequest
object
The allotment contract request model
5 properties 2 required
ProcessSchedulev2
object
The data for an organizations Process Schedule, v2. Process Schedule is a reporting tool that is used to generate agency commission statements. It’s a batch pr…
9 properties
TransactionType
integer
The dotREZ specific transaction types. This includes some system specific values that are not allowed during a transaction creation. 0 = Default 1 = Payment 2…
IJsonResponseOfIListOfOrganizationProcessSchedule
object
Defines the JSON response contract.
3 properties
AccountOwnerType
integer
The account owner type enumeration. 0 = Organization 1 = Personnal 2 = Booking 3 = Unknown
AllotmentRequest
object
The allotment request model.
7 properties
ClassStatus
integer
Indicates whether a leg class may be used or not. 1 = Active 2 = InActive 3 = AvsOpen 4 = AvsOnRequest 5 = AvsClosed
AllotmentBasisResponseBase
object
The allotment basis response base model
12 properties
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
OrganizationExternalAccountv2
object
The data for an organizations external account.
8 properties
IJsonResponseOfIListOfTransaction
object
Defines the JSON response contract.
3 properties
IJsonResponseOfOrganizationExternalAccountv2
object
Defines the JSON response contract.
3 properties
ProcessSchedule
object
The data for an organizations Process Schedule. Process Schedule is a reporting tool that is used to generate agency commission statements. It’s a batch proces…
9 properties
AllotmentContractResponse
object
The allotment contract response model
6 properties
AllotmentType
integer
Specifies the allotment type. 0 = Fixed 1 = Prorata
IJsonResponseOfAllotmentMarketFareResponse
object
Defines the JSON response contract.
3 properties
AllotmentBasisResponse
object
The allotment basis response model
13 properties
ErrorResponse
object
Defines a unique error response.
8 properties
ClassOfServiceType
integer
The class of service type enumeration. 0 = Default 1 = Normal 2 = Discrete 3 = NonNested 4 = NegoAllotment 5 = ProrataAllotment 6 = OperatingBlockspace 7 = Mar…
IJsonResponseOfOrganizationCommissionRate
object
Defines the JSON response contract.
3 properties
Directionality
integer
Enum representing direction of an object. 0 = None 1 = To 2 = From 3 = Between
OrganizationRegisterRequest
object
The data on the organization register request.
6 properties 1 required
FrequencyType
integer
FrequencyType Enumeration. Based on ones for SQL server scheduler, not all included. 0 = Daily 1 = Weekly 2 = Monthly
CreateOrganizationAccountRequest
object
The create organization account request model.
4 properties
OrganizationCreateRequest
object
The data on the organization.
13 properties
CompanyDetailsRecord
object
The organization company details record results.
5 properties 1 required
OrganizationCommissionRate
object
The commission rate details of an organization.
6 properties
Organizationv2
object
The base data on the organization.
12 properties
ContactEditDetails
object
The contact details for an organization.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tui-group-organizations2-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 Organizations2 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.