NewSkies GoNow API

The NewSkies GoNow API provides access to Navitaire's full Departure Control System (DCS) through the TUI Apigee gateway. The list of allowed operations might vary based on your New Skies agent role permissions, but the supported features include passenger check-in, boarding pass generation, baggage management, flight disruption handling, and operational reporting.

Capabilities

• Check-in — Perform passenger check-in with full validation details (including EES results), reverse check-in, and retrieve check-in requirements (general, custom, security)
• Baggage — Add bags to bookings, print bag tags, and generate bag tag tracking reports
• Boarding — Generate boarding pass print streams and BGR device commands
• Passengers — Search and retrieve passenger information across legs and segments
• Disruption — Combine segments, move passengers, and query alternative journeys
• Reports — Flight manifest, load, summary, availability, and other operational reports
• Printers — Initialize printers, generate print streams for receipts, boarding passes, and reports
• Settings — Retrieve DCS operation settings for check-in, departure, kiosk, and reports
• Documents — Manage scanned travel document data

ENROLLMENT PROCESS

The access to the API involves four different operations:

• An api-key to register and identify your application as a consumer of the GoNow API has been requested and approved.
• An agent is configured in New Skies with the correct permissions to cover your use case.
• Validation of your workflow is performed prior access to prod environment is granted.
• A whitelist request for your production environment's IP(s) has been sent and has been approved by TUI (Not required for the non-production environments).

Please, check below a general guide on how to complete each of these steps.

API-Key Request

Each of the client applications consuming the GoNow API must be identified by a unique API key. To request your key, please register on developer.tui portal for the API named NewSkies GoNow Api.

Once done and approved, you will retrieve your API-Key to use with the GoNow API.

The GoNow API uses API keys as a simple identification layer. As such, OAuth tokens are not needed because the actual authentication is handled by the New Skies platform itself (see more details).

Notice: The developer portal will only show the production and playground (test environment for development) API key. To access other environments, a different API key will be needed.

Workflow Validation (prior PROD go-live)

To ensure correct usage of the GoNow API, validation of your workflow prior go-live is mandatory. You will need to provide a few details, which are:

• Contact details (general email-address of your company)
• App-Name you used on the portal for registration to the GoNow API
• Production environment IP addresses or ranges
• Other environment IP addresses or ranges (like your test/development environment)
• Brief description of your use case
• Endpoints used by your workflow, including information about the purpose of each request
• Overall workflow diagram
• Expected throughputs (Requests per Minute)
• Test cases performed on our playground-environment, preferably by providing a correlation-id and a time-range when the tests were performed

You should provide all those information using this form.

Please be aware that missing information may cause the whitelisting and go-live to be delayed.

IP Whitelist (PROD only)

The production environment is protected by an IP whitelisting that will deny all requests unless the requester's IP has been whitelisted.

Please file a request at api.flightproduction@tui.com, providing all IPs you will use on our production API, with the subject GoNow API - Whitelist Request (prod).

Access to the GoNow API production environment must be done only from your own production system. Access to the production environment from a lower environment (dev, test, ...) is absolutely prohibited.

New Skies Agent Configuration

The New Skies agent credentials are usually sent by your TUI Business Partner. For any question about NewSkies credentials, feel free to reach out to user.flightproduction@tui.com

USING THE GONOW API

When all the previous requirements are met, please continue reading on the Get Started page to learn how to authenticate and make your first request to the GoNow API.

Further Reading

• Get Started — Authentication, headers, and first request
• Check-in Workflow — Step-by-step DCS check-in workflow with examples
• Backwards Compatibility — Versioning policy and breaking change definitions

Contact

For any further question, please reach out to api.flightproduction@tui.com.