The Partner API lets you search, book, and manage travel ancillary products and sell them under your own brand. You pass us customer and travel details; we handle supplier relationships, confirmations, and fulfilment.
| Product | Status |
|---|---|
| Airport Parking | Available |
| Transfers | Coming soon |
| Lounges | Coming soon |
| Fast Track | Coming soon |
| Hotels | Coming soon |
| Hotels With Parking | Coming soon |
New to the platform, or evaluating an upgrade? See Why Partner API 2026.
These apply across all products.
| Environment | Base URL |
|---|---|
| Sandbox | https://api-sandbox.holidayextras.com/partner-api |
| Staging | https://api-staging.holidayextras.com/partner-api |
| Production | https://api.holidayextras.com/partner-api |
For the full route from sandbox access to launch, see Getting started with Partner API 2026.
Start in sandbox. We'll work with you as you move through each environment and prepare to go live.
Sandbox uses fake data to return predictable responses for documented scenarios. See Sandbox testing for how to use it.
The live OpenAPI spec is available at https://api-staging.holidayextras.com/partner-api/v2/schema.json.
API version: All endpoints are prefixed /v2/. The v1 API will be deprecated; the date is to be confirmed.
Authentication: OAuth 2.0 client_credentials flow. See Authentication Integration Guide.
To get your client_id and client_secret, contact partnerconnect@holidayextras.com. These are scoped to your account. Keep your client_secret secure.
Content type: All requests and responses are application/json.
These endpoints apply across all products.
| Purpose | Method | Path |
|---|---|---|
| Auth token | POST | https://auth.holidayextras.com/oauth2/token |
| List locations | GET | /v2/locations |
Technical documentation for developers building against the Partner API, covering authentication, endpoint flows, and end-to-end booking journeys.
| Guide | Description |
|---|---|
| API Overview | Base URLs, environments and key endpoints |
| Authentication | OAuth 2.0 client credentials flow - getting and managing tokens |
| Sandbox testing | How to use predictable sandbox scenarios and choose the responses to test |
| Search endpoints | When to use the detailed endpoint vs separate search and content endpoints |
| Price Lock | Carry selected prices through checkout and handle exceptional changes |
| Webhooks | Receive signed booking-impact notifications and refetch the latest booking state |
| Error handling | How to handle validation errors, retries, idempotency conflicts, expired tokens, and support diagnostics |
| Versioning and changelog | How API versions, backwards-compatible changes, deprecations, and schema updates are handled |
| Price Lock | Carry selected prices through checkout and handle exceptional changes |
| Sandbox scenario catalogue | Sandbox values for booking, access, amendment, cancellation, and Price Lock scenarios |
| Purpose | Method | Path |
|---|---|---|
| Search parking (with content) | GET | /v2/products/parking/detailed |
| Search parking | GET | /v2/products/parking |
| Parking content | GET | /v2/content/parking |
| Create booking | POST | /v2/bookings/parking |
| Get booking | GET | /v2/bookings/parking/{ref} |
| Amendment quote | PATCH | /v2/bookings/parking/{ref}/amendments/quote |
| Confirm amendment | POST | /v2/bookings/parking/{ref}/amendments/confirm |
| Cancellation quote | GET | /v2/bookings/parking/{ref}/cancellations/quote |
| Confirm cancellation | POST | /v2/bookings/parking/{ref}/cancellations/confirm |
Guidance on how to present and sell parking effectively, covering content, conversion best practices, and customer experience.
| Guide | Scope | Description |
|---|---|---|
| Displaying Prices | All products | How to format and display prices correctly across currencies and locales |
| Customer Journey | Airport Parking | What customers need from search through post-booking updates |
| Parking Integration Paths | Airport Parking | How to shape the parking journey when selling standalone, alongside a wider travel booking, or alongside a flight |
| Selling Parking | Airport Parking | Product types, content fields to surface, and how to present parking to customers |
| Accessing Parking | Airport Parking | How to deliver booking details, entry codes, and confirmation content to customers |
Other common questions are answered in our FAQs page.