Postman Collections
A set of Postman collections and environments is available to help you explore and test the NDC Gateway API interactively.
Download
Download NDC Gateway Postman Collections
The zip file contains:
- NDC — Manual collection for learning and exploring the API step-by-step
- NDC (Scripted) — Fully scripted collection with end-to-end scenarios
- Playground.Tui.NDC — Environment pre-configured for the Playground/Test environment
- Prod.Tui.NDC — Environment pre-configured for the Production environment
Collections
NDC (Manual)
The manual collection is designed for learning and exploring the NDC API. Each folder represents a specific booking scenario, and requests are meant to be run sequentially within a folder.
After each request, you need to manually copy relevant IDs (e.g., OfferID, OrderID, SegmentRefID) from the response into the next request. This helps you understand the full request/response flow and how data connects between API calls.
Included scenarios (12 folders):
| # | Scenario | Description |
|---|---|---|
| 1 | OW (One-Way) | Simple one-way booking |
| 2 | RT (Round-Trip Mixed Pax) | Round-trip with mixed passenger types (ADT/CHD/INF) |
| 3 | RT with SSRs | Round-trip with ancillary services |
| 4 | RT with Seat | Round-trip with seat selection |
| 5 | OW with Promo Code | One-way booking using a promo code |
| 6 | OW Re-Price Promo (from OfferPrice) | Re-pricing with promo applied at OfferPrice stage |
| 7 | OW Re-Price Promo (from AirShopping) | Re-pricing with promo applied at AirShopping stage |
| 8 | RT LongSell (Specific Flight) | Round-trip targeting a specific flight number |
| 9 | Post-Booking Add SSR | Adding an ancillary service after booking |
| 10 | Post-Booking Remove SSR | Removing an ancillary service after booking |
| 11 | Post-Booking Change SSR | Changing an ancillary service after booking |
| 12 | Airline Profile | Retrieve airline profile information |
NDC (Scripted)
The scripted collection provides end-to-end automated scenarios. Pre-request and test scripts automatically extract IDs, tokens, and other data from responses and pass them to subsequent requests. You can run an entire folder without manual intervention.
This is ideal for regression testing, demos, or quickly verifying API behavior without manually copying values between requests.
Included scenarios (14 folders):
| # | Scenario | Description |
|---|---|---|
| 1 | OW (One-Way) | Simple one-way booking |
| 2 | RT (Round-Trip Mixed Pax) | Round-trip with mixed passenger types |
| 3 | OW with SSRs | One-way with ancillary services |
| 4 | RT with SSRs | Round-trip with ancillary services |
| 5 | OW with Seat | One-way with seat selection |
| 6 | RT with Seat | Round-trip with seat selection |
| 7 | OW with Promo Code | One-way booking using a promo code |
| 8 | OW Re-Price Promo (from OfferPrice) | Re-pricing with promo at OfferPrice stage |
| 9 | OW Re-Price Promo (from AirShopping) | Re-pricing with promo at AirShopping stage |
| 10 | RT LongSell (Specific Flight) | Round-trip targeting a specific flight number |
| 11 | Post-Booking Add SSR | Adding an ancillary service after booking |
| 12 | Post-Booking Remove SSR | Removing an ancillary service after booking |
| 13 | Post-Booking Change SSR | Changing an ancillary service after booking |
| 14 | Airline Profile | Retrieve airline profile information |
Setup
1. Import into Postman
- Download and extract the zip file.
- In Postman, click Import and select all extracted JSON files (both collections and both environments).
2. Configure your environment
Select either Playground.Tui.NDC or Prod.Tui.NDC as your active environment. Each environment has the baseUrl pre-configured. You only need to fill in your credentials:
| Variable | Description | Example |
|---|---|---|
Tui.NDC.ApiKey |
Your API key from the developer.tui portal | (your consumer key) |
Newskies.Agent.Username |
Your NewSkies agent username in domain format | EXT\AgentName |
Newskies.Agent.Password |
Your NewSkies agent password | (your password) |
Note: The username must include the domain prefix in the format
EXT\AgentName(backslash-separated).
The Newskies.Agent.Location field is optional and can usually be left empty.
3. Set collection variables
Both collections use variables at the collection level to define your test scenario. Edit the collection variables to specify flight details:
Common variables (both collections):
| Variable | Description | Default |
|---|---|---|
Flight.DepartureAirport |
IATA departure airport code | HAJ |
Flight.ArrivalAirport |
IATA arrival airport code | PMI |
Flight.OutboundDate |
Outbound flight date (YYYY-MM-DD) | 2027-05-15 |
Flight.InboundDate |
Inbound flight date (YYYY-MM-DD) | 2027-05-29 |
Flight.CarrierCode |
Airline carrier code | X3 |
Flight.OutboundNumber |
Specific outbound flight number (for LongSell) | — |
Flight.InboundNumber |
Specific inbound flight number (for LongSell) | — |
Additional variables (scripted collection only):
| Variable | Description | Default |
|---|---|---|
Preferred.PriceClassCode |
Preferred fare class code | F2 |
Preferred.SSR.ServiceCodes |
SSR service codes to add during booking | CLIM |
Preferred.SSR.PostBookingCode |
SSR code for post-booking scenarios | CLIM |
Preferred.SSR.ChangeToCode |
SSR code to change to in change scenarios | DING |
Preferred.PromoCode |
Promo code for promo scenarios | NDCX20 |
All other variables in the scripted collection (OfferIDs, OrderIDs, seat details, etc.) are automatically populated by the test scripts during execution.
4. Run requests
- Manual collection: Run requests one by one within a folder. Copy IDs from each response into the next request body or variables.
- Scripted collection: Run an entire folder using Postman's Collection Runner, or run requests sequentially — scripts handle the data flow automatically.
Environments
| Environment | Base URL | Use for |
|---|---|---|
| Playground.Tui.NDC | https://playground.api.tui/flight/ndc |
Development, testing, learning. No IP whitelist required. |
| Prod.Tui.NDC | https://prod.api.tui/flight/ndc |
Production usage. IP whitelist required. |
Need help?
- For detailed API documentation, see the Get Started page and the NDC Workflow guide.
- For request/response examples beyond what's in the collections, contact your TUI contact person.
- For credentials or access issues, contact api.flightproduction@tui.com.
