Meta Partner Packages & Flights 1.0.0

Getting Started

This guide walks you through calling the Meta Partner Packages & Flights API, from obtaining an access token to running your first package and flight searches. All endpoints are served over HTTPS and return application/json.

To integrate, you will need:

• A Client ID and Client Secret, provided to you by TUI.
• An agent code, agreed with TUI. Use the same agent code for every request.

If you don't yet have credentials, contact the Meta Package Team to request access: pip.meta.packages@mail.tuigroup.com

Base URLs

Use the Pre-Production environment to build and test your integration before going live.

Authentication

The API uses the OAuth 2.0 Client Credentials flow. Before calling any endpoint, request an access token and then send it as a Bearer token on every request.

1. Request an access token

Send your Client ID and Client Secret as HTTP Basic credentials (base64(clientId:clientSecret)) to the token endpoint.

curl --request POST \
--url https://prod.api.tui/oauth2/token \
--header 'Accept: application/json' \
--header 'Authorization: Basic <base64(clientId:clientSecret)>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'grant_type=client_credentials'

The response contains an access_token. Reuse the token until it expires rather than requesting a new one per call. The token grants the read:sales-meta-package scope.

2. Call the API with the token

Send the token in the Authorization header:

--header 'Authorization: Bearer <access_token>'

Search Flights

GET /{market}/flights/search/{agent}

Returns available flights for a market, with live pricing and availability.

Parameters

Example

curl --location 'https://prod.api.tui/sales/pip-package/partner/no/flights/search/tui?adults=2&limit=10&offset=0' \
--header 'Authorization: Bearer <access_token>'

Flight Route Feed

GET /{market}/flights/{agent}/route-feed

Returns the current flight route feed for a market.

Parameters

Example

curl --location 'https://prod.api.tui/sales/pip-package/partner/no/flights/tui/route-feed' \
--header 'Authorization: Bearer <access_token>'

Search Packages

GET /{market}/packages/{pax}

Returns all available packages for a market and passenger configuration.

Important: Remember to append your own agent string (&agent=youragentstring) to the urlToBooking link in each returned package.

Parameters

Example

curl --location 'https://prod.api.tui/sales/pip-package/partner/se/packages/2000?agent=tui&limit=10&offset=0' \
--header 'Authorization: Bearer <access_token>'

Paging Through Packages Efficiently

For best performance, provide a departuredate together with the offset. Supplying only an offset is resource-intensive: it causes significant CPU load per request and can overwhelm the backend with as few as five concurrent requests. Adding a departure date limits the number of candidate records, which lowers CPU usage, lets the backend handle far more concurrent requests, and returns results faster.

Page through one departure date at a time, incrementing the offset by limit:

https://prod.api.tui/sales/pip-package/partner/se/packages/2000?agent=tui&limit=1000&offset=0&departuredate=2024-09-25
https://prod.api.tui/sales/pip-package/partner/se/packages/2000?agent=tui&limit=1000&offset=1000&departuredate=2024-09-25
https://prod.api.tui/sales/pip-package/partner/se/packages/2000?agent=tui&limit=1000&offset=2000&departuredate=2024-09-25

Then move on to the next date:

https://prod.api.tui/sales/pip-package/partner/se/packages/2000?agent=tui&limit=1000&offset=0&departuredate=2024-09-26
https://prod.api.tui/sales/pip-package/partner/se/packages/2000?agent=tui&limit=1000&offset=1000&departuredate=2024-09-26
https://prod.api.tui/sales/pip-package/partner/se/packages/2000?agent=tui&limit=1000&offset=2000&departuredate=2024-09-26

Keep incrementing the offset by limit while totalNumberOfItems equals your limit (e.g. 1000), then continue with the next date.

Fetch Schedules

To keep request/response efficient, package fetching uses a market-driven schedule. Subscribe to the time slots that apply to your market; you will receive the corresponding schedule when you are onboarded. This schedule applies to Packages only.

Reference

• Interactive docs: https://prod.api.tui/sales/pip-package/partner/docs/ — open to the internet, but requests require authentication.
• OpenAPI spec: https://prod.api.tui/sales/pip-package/partner/docs/spec