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…
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…
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…
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…
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…
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), OrganizationCreateRequest (13 properties), AllotmentBasisResponse (13 properties), Transaction (13 properties). Each schema is shown below with its type and property counts.

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

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