From 43319e781cb93a7ff34a799313be72936e99e512 Mon Sep 17 00:00:00 2001 From: Samuel Wiseman Date: Thu, 3 Sep 2026 11:41:24 +0100 Subject: [PATCH 1/4] Update problems with latest types --- site/partner/v2/index.md | 27 ++++---- .../v2/problems/dependency-unavailable.md | 34 ++++++++++ site/partner/v2/problems/forbidden.md | 32 +++++++++ site/partner/v2/problems/gateway-timeout.md | 36 ++++++++++ site/partner/v2/problems/gone.md | 31 +++++++++ site/partner/v2/problems/index.md | 65 +++++++++++++++++++ site/partner/v2/problems/request-timeout.md | 32 +++++++++ .../v2/problems/service-unavailable.md | 34 ++++++++++ site/partner/v2/problems/too-many-requests.md | 32 +++++++++ site/partner/v2/problems/unauthorized.md | 33 ++++++++++ 10 files changed, 340 insertions(+), 16 deletions(-) create mode 100644 site/partner/v2/problems/dependency-unavailable.md create mode 100644 site/partner/v2/problems/forbidden.md create mode 100644 site/partner/v2/problems/gateway-timeout.md create mode 100644 site/partner/v2/problems/gone.md create mode 100644 site/partner/v2/problems/index.md create mode 100644 site/partner/v2/problems/request-timeout.md create mode 100644 site/partner/v2/problems/service-unavailable.md create mode 100644 site/partner/v2/problems/too-many-requests.md create mode 100644 site/partner/v2/problems/unauthorized.md diff --git a/site/partner/v2/index.md b/site/partner/v2/index.md index 2f872b60..d9f1da74 100644 --- a/site/partner/v2/index.md +++ b/site/partner/v2/index.md @@ -2,23 +2,18 @@ Partner API 2026 (APIConnect) is the next step for our platform. It brings UK and EU integrations together in one place, with OAuth 2.0 authentication and standardised contracts defined using an OpenAPI schema. The platform is built to scale as we expand into more markets. -This documentation is subject to change. Further features, including a booking list capability to support reconciliation and recovery flows, as well as wider product coverage, will be introduced in later phases. - -## Environments - -| | Production | Staging | -|---|---|---| -| **API** | `https://api.holidayextras.com` | `https://api-sandbox.holidayextras.com` | -| **Auth** | `https://auth.holidayextras.com` | `https://auth-staging.holidayextras.com` | -| **OpenAPI Schema** | `https://api.holidayextras.com/partner-api/v2/schema.json` | `https://api-sandbox.holidayextras.com/partner-api/v2/schema.json` | +## Documentation -Use staging for development and testing. Authenticate against the matching auth environment -- staging credentials will not work against production and vice versa. +Partner API 2026 documentation: -View the schema in [Swagger Editor](https://editor.swagger.io/) or import into [Postman](https://www.postman.com/). +### **[holidayextras/partner-api-documentation](https://github.com/holidayextras/partner-api-documentation)** -## Documentation +Start with the [README](https://github.com/holidayextras/partner-api-documentation/blob/main/README.md) for environments, base URLs, authentication and the current OpenAPI schema. -* [Authentication](./authentication.md) - OAuth 2.0 client credentials flow -* [Understanding the OpenAPI Documentation](./api-endpoint-navigation-guide.md) - Endpoint workflows and integration guide -* [Event Notifications](./webhook-integration-guide.md) - Webhook integration for booking status updates -* [Error Responses](./problems/bad-request.md) - HTTP error codes and resolution guidance +| | | +|---|---| +| [Getting started](https://github.com/holidayextras/partner-api-documentation/blob/main/onboarding.md) | The route from sandbox access to launch | +| [Integration guides](https://github.com/holidayextras/partner-api-documentation/tree/main/docs/integration-guides) | Authentication, sandbox testing, search, webhooks, versioning, price lock | +| [API reference](https://github.com/holidayextras/partner-api-documentation/tree/main/docs/api-reference) | Per-endpoint request and response detail | +| [Error handling](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/errors.md) | How to respond to errors in your integration | +| [FAQs](https://github.com/holidayextras/partner-api-documentation/blob/main/faqs.md) | Common questions | diff --git a/site/partner/v2/problems/dependency-unavailable.md b/site/partner/v2/problems/dependency-unavailable.md new file mode 100644 index 00000000..813ded6e --- /dev/null +++ b/site/partner/v2/problems/dependency-unavailable.md @@ -0,0 +1,34 @@ +# Dependency Unavailable + +| Field | Value | +|-------|-------| +| **Status** | 503 | +| **Code** | `dependency_unavailable` | + +A service the request depended on could not be reached. This is the second of two `503` problems: [Service Unavailable](/partner/v2/problems/service-unavailable/) says the service itself cannot serve the request, while `dependency_unavailable` says the service is healthy but something it needed is not answering. + +## Common causes + +- A downstream booking, content or supply service was unreachable +- Repeated failures caused the API to stop calling a struggling dependency for a short period, so the call fails immediately rather than waiting +- The authentication service could not be reached to verify your token + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/dependency-unavailable", + "title": "Dependency Unavailable", + "status": 503, + "detail": null, + "code": "dependency_unavailable", + "trace_id": "abc123def456", + "errors": [] +} +``` + +`detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message. + +## How to resolve + +Retry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. Because the call may have been rejected without being attempted, retries are cheap, but keep the backoff -- retrying immediately will only extend the period the dependency is treated as unavailable. If the error persists, contact support with the `trace_id`. diff --git a/site/partner/v2/problems/forbidden.md b/site/partner/v2/problems/forbidden.md new file mode 100644 index 00000000..32f19407 --- /dev/null +++ b/site/partner/v2/problems/forbidden.md @@ -0,0 +1,32 @@ +# Forbidden + +| Field | Value | +|-------|-------| +| **Status** | 403 | +| **Code** | `forbidden` | + +The credentials are valid, but the account they belong to is not permitted to perform this operation. Unlike a `401`, refreshing the token will not help. + +## Common causes + +- The account is not entitled to the product or operation being requested +- The requested resource belongs to a different account +- The operation is enabled for some environments or brands on the account but not the one being called + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/forbidden", + "title": "Forbidden", + "status": 403, + "detail": "Not permitted to perform this operation", + "code": "forbidden", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Do not retry -- the outcome will not change. Check that the resource being requested belongs to the authenticating account. If the operation should be available to you, contact your account manager or support with the `trace_id` to have the entitlement reviewed. diff --git a/site/partner/v2/problems/gateway-timeout.md b/site/partner/v2/problems/gateway-timeout.md new file mode 100644 index 00000000..89ed1fd7 --- /dev/null +++ b/site/partner/v2/problems/gateway-timeout.md @@ -0,0 +1,36 @@ +# Gateway Timeout + +| Field | Value | +|-------|-------| +| **Status** | 504 | +| **Code** | `gateway_timeout` | + +A service the request depended on did not respond within the time budget for the request. The call was abandoned, not refused -- so unlike a `503`, the downstream operation may or may not have completed. + +## Common causes + +- A downstream booking or content service was slow to respond +- The time budget for the request was already exhausted by earlier calls in the chain +- A dependency was recovering from load and responding well below its usual speed + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/gateway-timeout", + "title": "Gateway Timeout", + "status": 504, + "detail": null, + "code": "gateway_timeout", + "trace_id": "abc123def456", + "errors": [] +} +``` + +`detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message. + +## How to resolve + +For reads, retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. + +For writes -- creating a booking, or confirming an amendment or cancellation -- a `504` does not tell you whether the operation completed. Retry the request with the **same** `Idempotency-Key` rather than a new one, so a request that did land is returned to you instead of being duplicated. If the error persists, look the booking up before creating it again, and contact support with the `trace_id`. diff --git a/site/partner/v2/problems/gone.md b/site/partner/v2/problems/gone.md new file mode 100644 index 00000000..eca0a249 --- /dev/null +++ b/site/partner/v2/problems/gone.md @@ -0,0 +1,31 @@ +# Gone + +| Field | Value | +|-------|-------| +| **Status** | 410 | +| **Code** | `gone` | + +The resource was once available but has been permanently removed. Unlike a `404`, this is a statement that the resource will not come back, so there is nothing to poll for. + +## Common causes + +- The endpoint belongs to a retired API version +- The resource was permanently deleted rather than cancelled + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/gone", + "title": "Gone", + "status": 410, + "detail": "This resource is no longer available", + "code": "gone", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Do not retry. If the endpoint has been retired, move to the current version -- see [Versioning](/versioning/) for how versions are published and withdrawn. Otherwise stop requesting the resource and remove any stored reference to it. diff --git a/site/partner/v2/problems/index.md b/site/partner/v2/problems/index.md new file mode 100644 index 00000000..694e952c --- /dev/null +++ b/site/partner/v2/problems/index.md @@ -0,0 +1,65 @@ +# Error Responses + +This page is the reference for the problem `type` URIs the API returns. For guidance on how your integration should respond to each one -- when to retry, what to show the customer -- see the [error handling guide](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/errors.md) in [partner-api-documentation](https://github.com/holidayextras/partner-api-documentation), which is the source of truth for Partner API documentation. + +Every error returned by Partner API v2 uses the same problem details body, served as `application/problem+json`: + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/conflict", + "title": "Conflict", + "status": 409, + "detail": "The amendment token has expired", + "code": "token_expired", + "trace_id": "abc123def456", + "errors": [] +} +``` + +| Field | Description | +|-------|-------------| +| `type` | A stable URI identifying the class of problem. It resolves to the page for that problem, listed below. | +| `title` | A short, human-readable summary of the problem class. | +| `status` | The HTTP status code, repeated in the body. | +| `detail` | A human-readable explanation of this specific occurrence. Always `null` on a `5xx`. | +| `code` | A machine-readable value for this specific occurrence. Branch on this, not on `title` or `detail`. | +| `trace_id` | The identifier to quote when contacting support. Present whenever a trace is available. | +| `errors` | Field-level failures, each with `field`, `message` and an optional `code`. Always empty on a `5xx`. | + +## `type` and `code` are not the same thing + +`type` names the class of problem and is drawn from the fixed list below. `code` names the specific occurrence and can be more precise than the `type`. In the example above, an expired amendment token is a conflict, so `type` is `.../conflict`, but `code` is the narrower `token_expired`. + +Treat `type` as the stable link to documentation and `code` as the value your integration switches on. A new `code` can appear within an existing `type` without the `type` changing, so match `code` values you know and fall back on `status` for the rest rather than failing closed on an unrecognised value. + +## Problem types + +| Status | Canonical `code` | Problem | +|--------|------------------|---------| +| 400 | `bad_request` | [Bad Request](/partner/v2/problems/bad-request/) | +| 401 | `unauthorized` | [Unauthorized](/partner/v2/problems/unauthorized/) | +| 403 | `forbidden` | [Forbidden](/partner/v2/problems/forbidden/) | +| 404 | `resource_not_found` | [Resource Not Found](/partner/v2/problems/resource-not-found/) | +| 405 | `method_not_allowed` | [Method Not Allowed](/partner/v2/problems/method-not-allowed/) | +| 406 | `not_acceptable` | [Not Acceptable](/partner/v2/problems/not-acceptable/) | +| 408 | `request_timeout` | [Request Timeout](/partner/v2/problems/request-timeout/) | +| 409 | `conflict` | [Conflict](/partner/v2/problems/conflict/) | +| 410 | `gone` | [Gone](/partner/v2/problems/gone/) | +| 415 | `unsupported_media_type` | [Unsupported Media Type](/partner/v2/problems/unsupported-media-type/) | +| 422 | `unprocessable_entity` | [Unprocessable Entity](/partner/v2/problems/unprocessable-entity/) | +| 425 | `too_early` | [Too Early](/partner/v2/problems/too-early/) | +| 429 | `too_many_requests` | [Too Many Requests](/partner/v2/problems/too-many-requests/) | +| 500 | `internal_error` | [Internal Server Error](/partner/v2/problems/internal-error/) | +| 502 | `bad_gateway` | [Bad Gateway](/partner/v2/problems/bad-gateway/) | +| 502 | `upstream_error` | [Upstream Error](/partner/v2/problems/upstream-error/) | +| 503 | `service_unavailable` | [Service Unavailable](/partner/v2/problems/service-unavailable/) | +| 503 | `dependency_unavailable` | [Dependency Unavailable](/partner/v2/problems/dependency-unavailable/) | +| 504 | `gateway_timeout` | [Gateway Timeout](/partner/v2/problems/gateway-timeout/) | + +## Retrying + +`4xx` problems describe something about the request and will fail again unchanged -- fix the request rather than retrying it. The exceptions are [Request Timeout](/partner/v2/problems/request-timeout/), [Too Early](/partner/v2/problems/too-early/) and [Too Many Requests](/partner/v2/problems/too-many-requests/), where the request itself was never processed and a later attempt can succeed. + +`5xx` problems are server-side and usually transient. Retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts, then contact support with the `trace_id`. + +When retrying a write -- creating a booking, or confirming an amendment or cancellation -- always send the **same** `Idempotency-Key` as the original request. A retry with a fresh key can duplicate an operation that had already succeeded. diff --git a/site/partner/v2/problems/request-timeout.md b/site/partner/v2/problems/request-timeout.md new file mode 100644 index 00000000..e65c68a8 --- /dev/null +++ b/site/partner/v2/problems/request-timeout.md @@ -0,0 +1,32 @@ +# Request Timeout + +| Field | Value | +|-------|-------| +| **Status** | 408 | +| **Code** | `request_timeout` | + +The request was not completed within the time the server was prepared to wait for it. Nothing was processed, so no booking or amendment will have been made. + +## Common causes + +- The request body was sent too slowly, or the connection stalled part-way through +- A connection was opened and held without a complete request being sent +- Network conditions between your client and the API delayed the request + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/request-timeout", + "title": "Request Timeout", + "status": 408, + "detail": "Request Timeout", + "code": "request_timeout", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Retry the request on a new connection. Because nothing was processed, a retry is safe. If timeouts recur, check for network issues or proxies between your client and the API, and confirm your client sends the full request body without long pauses. diff --git a/site/partner/v2/problems/service-unavailable.md b/site/partner/v2/problems/service-unavailable.md new file mode 100644 index 00000000..17b545e9 --- /dev/null +++ b/site/partner/v2/problems/service-unavailable.md @@ -0,0 +1,34 @@ +# Service Unavailable + +| Field | Value | +|-------|-------| +| **Status** | 503 | +| **Code** | `service_unavailable` | + +The service is temporarily unable to handle the request. This is a transient, server-side condition and can be retried. + +## Common causes + +- A service is being deployed or restarted +- A service is shedding load while it recovers +- A downstream booking or content service reported itself unavailable + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/service-unavailable", + "title": "Service Unavailable", + "status": 503, + "detail": null, + "code": "service_unavailable", + "trace_id": "abc123def456", + "errors": [] +} +``` + +`detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message. + +## How to resolve + +Retry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. If the error persists, contact support with the `trace_id` from the response. See also [Dependency Unavailable](/partner/v2/problems/dependency-unavailable/), the other `503` this API can return. diff --git a/site/partner/v2/problems/too-many-requests.md b/site/partner/v2/problems/too-many-requests.md new file mode 100644 index 00000000..01909895 --- /dev/null +++ b/site/partner/v2/problems/too-many-requests.md @@ -0,0 +1,32 @@ +# Too Many Requests + +| Field | Value | +|-------|-------| +| **Status** | 429 | +| **Code** | `too_many_requests` | + +The request rate limit for your account has been exceeded. The request was rejected before it was processed, so nothing was created or changed. + +## Common causes + +- Sustained request volume above the rate agreed for your account +- A burst of parallel requests, such as a batch job started all at once +- A retry loop with no backoff, which multiplies the original request rate + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/too-many-requests", + "title": "Too Many Requests", + "status": 429, + "detail": "Rate limit exceeded", + "code": "too_many_requests", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Back off before retrying. If the response carries a `Retry-After` header, wait at least that long; otherwise retry with exponential backoff (e.g. 1s, 2s, 4s) and add jitter so parallel clients do not retry in lockstep. Cap the number of concurrent in-flight requests rather than relying on retries alone. If your integration needs a higher limit, contact your account manager. diff --git a/site/partner/v2/problems/unauthorized.md b/site/partner/v2/problems/unauthorized.md new file mode 100644 index 00000000..ce73a43c --- /dev/null +++ b/site/partner/v2/problems/unauthorized.md @@ -0,0 +1,33 @@ +# Unauthorized + +| Field | Value | +|-------|-------| +| **Status** | 401 | +| **Code** | `unauthorized` | + +The request did not carry credentials the API could verify. Responses to this problem also carry a `WWW-Authenticate: Bearer` header. + +## Common causes + +- No `Authorization` header was sent, or it was not in the form `Bearer {token}` +- The access token has expired +- The token was issued by a different environment to the one being called (a staging token against production, or the reverse) +- The token's signature could not be verified + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/unauthorized", + "title": "Unauthorized", + "status": 401, + "detail": "Invalid or expired token", + "code": "unauthorized", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Request a fresh access token from the token endpoint and retry once with the new token. See the [Authentication integration guide](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/integration-guides/02-authentication.md) for the client credentials flow. Do not retry with the same token -- it will fail again. If a newly issued token is still rejected, check that the token and the API host belong to the same environment, then contact support with the `trace_id`. From 1cad190619b78ac9adf43dc9e662f4f3f807307d Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 3 Sep 2026 10:43:10 +0000 Subject: [PATCH 2/4] Update dist --- docs/feed.xml | 2 +- docs/hxapi/asynchronous-bookings/index.html | 8 +- docs/hxapi/carhire/availability/index.html | 4 +- docs/hxapi/parking/av/airport/index.html | 20 +- docs/hxapi/productlibrary/index.html | 28 +-- docs/hxapi/transfers/av/index.html | 24 +- docs/hxapi/transfers/cancel/index.html | 4 +- .../transfers/cancellation-policy/index.html | 8 +- docs/hxapi/transfers/view/index.html | 4 +- docs/hxapi/upgrade/index.html | 16 +- docs/hxapi/viewamendcancel/view/index.html | 20 +- docs/partner/v2/index.html | 47 ++-- docs/partner/v2/index.md | 27 +-- .../v2/problems/dependency-unavailable.md | 34 +++ .../dependency-unavailable/index.html | 97 ++++++++ docs/partner/v2/problems/forbidden.md | 32 +++ docs/partner/v2/problems/forbidden/index.html | 95 ++++++++ docs/partner/v2/problems/gateway-timeout.md | 36 +++ .../v2/problems/gateway-timeout/index.html | 99 ++++++++ docs/partner/v2/problems/gone.md | 31 +++ docs/partner/v2/problems/gone/index.html | 94 ++++++++ docs/partner/v2/problems/index.html | 226 ++++++++++++++++++ docs/partner/v2/problems/index.md | 65 +++++ docs/partner/v2/problems/request-timeout.md | 32 +++ .../v2/problems/request-timeout/index.html | 95 ++++++++ .../v2/problems/service-unavailable.md | 34 +++ .../problems/service-unavailable/index.html | 97 ++++++++ docs/partner/v2/problems/too-many-requests.md | 32 +++ .../v2/problems/too-many-requests/index.html | 95 ++++++++ docs/partner/v2/problems/unauthorized.md | 33 +++ .../v2/problems/unauthorized/index.html | 96 ++++++++ docs/search/index.html | 213 +++++++++++------ 32 files changed, 1562 insertions(+), 186 deletions(-) create mode 100644 docs/partner/v2/problems/dependency-unavailable.md create mode 100644 docs/partner/v2/problems/dependency-unavailable/index.html create mode 100644 docs/partner/v2/problems/forbidden.md create mode 100644 docs/partner/v2/problems/forbidden/index.html create mode 100644 docs/partner/v2/problems/gateway-timeout.md create mode 100644 docs/partner/v2/problems/gateway-timeout/index.html create mode 100644 docs/partner/v2/problems/gone.md create mode 100644 docs/partner/v2/problems/gone/index.html create mode 100644 docs/partner/v2/problems/index.html create mode 100644 docs/partner/v2/problems/index.md create mode 100644 docs/partner/v2/problems/request-timeout.md create mode 100644 docs/partner/v2/problems/request-timeout/index.html create mode 100644 docs/partner/v2/problems/service-unavailable.md create mode 100644 docs/partner/v2/problems/service-unavailable/index.html create mode 100644 docs/partner/v2/problems/too-many-requests.md create mode 100644 docs/partner/v2/problems/too-many-requests/index.html create mode 100644 docs/partner/v2/problems/unauthorized.md create mode 100644 docs/partner/v2/problems/unauthorized/index.html diff --git a/docs/feed.xml b/docs/feed.xml index e49cf2f8..2de2282b 100644 --- a/docs/feed.xml +++ b/docs/feed.xml @@ -1,2 +1,2 @@ -Jekyll2026-08-06T08:31:44+00:00/feed.xmlHoliday Extras APIDocumentation to give to partners who would like to integrate with our API. +Jekyll2026-09-03T10:43:06+00:00/feed.xmlHoliday Extras APIDocumentation to give to partners who would like to integrate with our API. \ No newline at end of file diff --git a/docs/hxapi/asynchronous-bookings/index.html b/docs/hxapi/asynchronous-bookings/index.html index 646084e2..d74a5f4a 100644 --- a/docs/hxapi/asynchronous-bookings/index.html +++ b/docs/hxapi/asynchronous-bookings/index.html @@ -77,7 +77,7 @@

Availability Request

UK Products Availability Request

-
    +
    • XML
    • @@ -85,7 +85,7 @@

      UK Products Availability Request

    -
      +
      • https://api.holidayextras.com/v1/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-01-07&ArrivalTime=1200&DepartDate=2025-01-08&DepartTime=1200&NumberOfPax=1&includeAsyncOnlyProducts=true
        @@ -102,7 +102,7 @@ 

        UK Products Availability Request

        European Products Availability Request

        -
          +
          • XML
          • @@ -110,7 +110,7 @@

            European Products Availability R

          -
            +
            • https://api.holidayextras.com/v1/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-12-01&ArrivalTime=1200&DepartDate=2025-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en&includeAsyncOnlyProducts=true
              diff --git a/docs/hxapi/carhire/availability/index.html b/docs/hxapi/carhire/availability/index.html
              index 4a2e9f32..d518e9c8 100644
              --- a/docs/hxapi/carhire/availability/index.html
              +++ b/docs/hxapi/carhire/availability/index.html
              @@ -53,7 +53,7 @@ 

              Request

              Example request:

              -
                +
                • XML
                • @@ -61,7 +61,7 @@

                  Request

                -
                  +
                  • https://api.holidayextras.com/v1/sandbox/carHire/products?key=1&From=06NOV16&ArrivalTime=1200&To=13NOV&DepartTime=1600&PickupLocation=FL965&DropoffLocation=FL965&DateOfBirth=1990-10-13
                    diff --git a/docs/hxapi/parking/av/airport/index.html b/docs/hxapi/parking/av/airport/index.html
                    index 9a76bac7..dd959290 100644
                    --- a/docs/hxapi/parking/av/airport/index.html
                    +++ b/docs/hxapi/parking/av/airport/index.html
                    @@ -49,7 +49,7 @@ 

                    Endpoint

                    For example, for London Gatwick the endpoint is:

                    -
                      +
                      • XML
                      • @@ -57,7 +57,7 @@

                        Endpoint

                      -
                        +
                        • https://api.holidayextras.com/v1/carpark/LGW
                          @@ -444,7 +444,7 @@ 

                          Worked Examples

                          UK Products Availability Request

                          -
                            +
                            • XML
                            • @@ -452,7 +452,7 @@

                              UK Products Availability Request

                            -
                              +
                              • https://api.holidayextras.com/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1
                                @@ -471,7 +471,7 @@ 

                                UK Products Availability Response

                                NB: This is a shortened example compiled from a full availability response.

                                -
                                  +
                                  • XML
                                  • @@ -479,7 +479,7 @@

                                    UK Products Availability Response

                                    -
                                      +
                                      • <?xml version="1.0"?>
                                        @@ -707,7 +707,7 @@ 

                                        UK Products Availability Response

                                        European Products Availability Request -
                                          +
                                          • XML
                                          • @@ -715,7 +715,7 @@

                                            European Products Availability R

                                          -
                                            +
                                            • https://api.holidayextras.com/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en
                                              @@ -734,7 +734,7 @@ 

                                              European Products Availability

                                              NB: This is a shortened example compiled from a full availability response.

                                              -
                                                +
                                                • XML
                                                • @@ -742,7 +742,7 @@

                                                  European Products Availability

                                                -
                                                  +
                                                  • <?xml version="1.0"?>
                                                    diff --git a/docs/hxapi/productlibrary/index.html b/docs/hxapi/productlibrary/index.html
                                                    index 3b5c45cc..fd5b198c 100644
                                                    --- a/docs/hxapi/productlibrary/index.html
                                                    +++ b/docs/hxapi/productlibrary/index.html
                                                    @@ -83,7 +83,7 @@ 

                                                    Available Fields

                                                    The available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.

                                                    -
                                                      +
                                                      • Parking
                                                      • @@ -97,7 +97,7 @@

                                                        Available Fields

                                                      -
                                                        +
                                                        • @@ -968,7 +968,7 @@

                                                          Example 1 - Default Response

                                                          Request

                                                          -
                                                            + -
                                                              +
                                                              • https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey
                                                                @@ -1008,7 +1008,7 @@ 

                                                                Request

                                                                Response

                                                                -
                                                                  +
                                                                  • XML
                                                                  • @@ -1016,7 +1016,7 @@

                                                                    Response

                                                                  -
                                                                    +
                                                                    • <?xml version="1.0"?>
                                                                      @@ -1403,7 +1403,7 @@ 

                                                                      Example 2 - Restricted field list

                                                                      Request

                                              -
                                                + -
                                                  +
                                                  • https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude
                                                    @@ -1443,7 +1443,7 @@ 

                                                    Request

                                                    Response

                                                    -
                                                      +
                                                      • XML
                                                      • @@ -1451,7 +1451,7 @@

                                                        Response

                                                      -
                                                        +
                                                        • <?xml version="1.0"?>
                                                          @@ -1512,7 +1512,7 @@ 

                                                          Request

                                                          Requests for German products return a different set of fields. Explanation of fields not currently available.

                                                          -
                                                            + -
                                                              +
                                                              • https://api.holidayextras.com/v1/product/FRA0?key=mytestkey
                                                                @@ -1552,7 +1552,7 @@ 

                                                                Request

                                                                Response

                                                                -
                                                                  +
                                                                  • XML
                                                                  • @@ -1560,7 +1560,7 @@

                                                                    Response

                                                                  -
                                                                    +
                                                                    • <?xml version="1.0"?>
                                                                      diff --git a/docs/hxapi/transfers/av/index.html b/docs/hxapi/transfers/av/index.html
                                                                      index 6d009e6f..0a07c4c5 100644
                                                                      --- a/docs/hxapi/transfers/av/index.html
                                                                      +++ b/docs/hxapi/transfers/av/index.html
                                                                      @@ -856,7 +856,7 @@ 

                                                                      Worked Examples

                                                                      Airport to GIATA

                                                                      Request
                                                                      -
                                                                        +
                                                                        • XML
                                                                        • @@ -864,7 +864,7 @@
                                                                          Request
                                                                        -
                                                                          +
                                                                          • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602
                                                                            @@ -882,7 +882,7 @@ 
                                                                            Request
                                                                            Response

                                                                            NB: This is a shortened example compiled from a full availability response.

                                                                            -
                                                                              +
                                                                              • XML
                                                                              • @@ -890,7 +890,7 @@
                                                                                Response
                                                                              -
                                                                                +
                                                                                • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 13:06:41">
                                                                                  @@ -1128,7 +1128,7 @@ 
                                                                                  Response

                                                                                  Airport to TTI

                                                                                  Request
                                                                                  -
                                                                                    +
                                                                                    • XML
                                                                                    • @@ -1136,7 +1136,7 @@
                                                                                      Request
                                                                                    -
                                                                                      +
                                                                                      • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602
                                                                                        @@ -1155,7 +1155,7 @@ 
                                                                                        Response

                                                                                        NB: This is a shortened example compiled from a full availability response.

                                                                                        -
                                                                                          +
                                                                                          • XML
                                                                                          • @@ -1163,7 +1163,7 @@
                                                                                            Response
                                                                                          -
                                                                                            +
                                                                                            • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 13:06:41">
                                                                                              @@ -1400,7 +1400,7 @@ 
                                                                                              Response

                                                                                              Airport to Postal Address

                                                                                              Request
                                                                                              -
                                                                                                +
                                                                                                • XML
                                                                                                • @@ -1408,7 +1408,7 @@
                                                                                                  Request
                                                                                                -
                                                                                                  +
                                                                                                  • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602
                                                                                                    @@ -1427,7 +1427,7 @@ 
                                                                                                    Response

                                                                                                    NB: This is a shortened example compiled from a full availability response.

                                                                                                    -
                                                                                                      +
                                                                                                      • XML
                                                                                                      • @@ -1435,7 +1435,7 @@
                                                                                                        Response
                                                                                                      -
                                                                                                        +
                                                                                                        • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 16:31:35">
                                                                                                          diff --git a/docs/hxapi/transfers/cancel/index.html b/docs/hxapi/transfers/cancel/index.html
                                                                                                          index 4370b7d2..55cc7cb6 100644
                                                                                                          --- a/docs/hxapi/transfers/cancel/index.html
                                                                                                          +++ b/docs/hxapi/transfers/cancel/index.html
                                                                                                          @@ -160,7 +160,7 @@ 

                                                                                                          Cancel Booking Response

                                                                                                          Example

                                                                                                          -
                                                                                                            +
                                                                                                            • XML
                                                                                                            • @@ -168,7 +168,7 @@

                                                                                                              Example

                                                                                                            -
                                                                                                              +
                                                                                                              • <Booking>
                                                                                                                diff --git a/docs/hxapi/transfers/cancellation-policy/index.html b/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                index 9df1133a..4b3a2e9f 100644
                                                                                                                --- a/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                +++ b/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                @@ -145,7 +145,7 @@ 

                                                                                                                Cancellation Policy Response

                                                                                                                Example

                                                                                                                -
                                                                                                                  +
                                                                                                                  • XML
                                                                                                                  • @@ -153,7 +153,7 @@

                                                                                                                    Example

                                                                                                                  -
                                                                                                                    +
                                                                                                                    • <BookingRef>TB12345</BookingRef>
                                                                                                                      @@ -179,7 +179,7 @@ 

                                                                                                                      Example

                                                                                                                      Example - Non-Cancellable Booking

                                                                                                                      -
                                                                                                                        +
                                                                                                                        • XML
                                                                                                                        • @@ -187,7 +187,7 @@

                                                                                                                          Example - Non-Cancellable Booking

                                                                                                                          -
                                                                                                                            +
                                                                                                                            • <BookingRef>TB12345</BookingRef>
                                                                                                                              diff --git a/docs/hxapi/transfers/view/index.html b/docs/hxapi/transfers/view/index.html
                                                                                                                              index 4a66a0da..a9b771d4 100644
                                                                                                                              --- a/docs/hxapi/transfers/view/index.html
                                                                                                                              +++ b/docs/hxapi/transfers/view/index.html
                                                                                                                              @@ -295,7 +295,7 @@ 

                                                                                                                              FlightDetails Fields

                                                                                                                              Example

                                                                                                                              -
                                                                                                                                +
                                                                                                                                • XML
                                                                                                                                • @@ -303,7 +303,7 @@

                                                                                                                                  Example

                                                                                                                                -
                                                                                                                                  +
                                                                                                                                  • <Booking>
                                                                                                                                    diff --git a/docs/hxapi/upgrade/index.html b/docs/hxapi/upgrade/index.html
                                                                                                                                    index 79bcc845..0e49d66f 100644
                                                                                                                                    --- a/docs/hxapi/upgrade/index.html
                                                                                                                                    +++ b/docs/hxapi/upgrade/index.html
                                                                                                                                    @@ -239,7 +239,7 @@ 

                                                                                                                                    Example 1 - Carpark Upgrades

                                                                                                                                    Request

                                                                                                                                    -
                                                                                                                                      +
                                                                                                                                      • XML
                                                                                                                                      • @@ -247,7 +247,7 @@

                                                                                                                                        Request

                                                                                                                                      -
                                                                                                                                        +
                                                                                                                                        • https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45
                                                                                                                                          @@ -265,7 +265,7 @@ 

                                                                                                                                          Request

                                                                                                                                          Response

                                                                                                                                          -
                                                                                                                                            +
                                                                                                                                            • XML
                                                                                                                                            • @@ -273,7 +273,7 @@

                                                                                                                                              Response

                                                                                                                                            -
                                                                                                                                              +
                                                                                                                                              • <?xml version="1.0"?>
                                                                                                                                                @@ -610,7 +610,7 @@ 

                                                                                                                                                Example 1 - Hotel Upgrades

                                                                                                                                                Request

                                                                                                                                                -
                                                                                                                                                  +
                                                                                                                                                  • XML
                                                                                                                                                  • @@ -618,7 +618,7 @@

                                                                                                                                                    Request

                                                                                                                                                  -
                                                                                                                                                    +
                                                                                                                                                    • https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45
                                                                                                                                                      @@ -634,7 +634,7 @@ 

                                                                                                                                                      Request

                                                                                                                                                      Response

                                                                                                                                                      -
                                                                                                                                                        +
                                                                                                                                                        • XML
                                                                                                                                                        • @@ -642,7 +642,7 @@

                                                                                                                                                          Response

                                                                                                                                                        -
                                                                                                                                                          +
                                                                                                                                                          • <?xml version="1.0"?>
                                                                                                                                                            diff --git a/docs/hxapi/viewamendcancel/view/index.html b/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                            index fa94c0a9..d76db8f8 100644
                                                                                                                                                            --- a/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                            +++ b/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                            @@ -46,7 +46,7 @@ 

                                                                                                                                                            Endpoint

                                                                                                                                                            The endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):

                                                                                                                                                            -
                                                                                                                                                              +
                                                                                                                                                              • XML
                                                                                                                                                              • @@ -54,7 +54,7 @@

                                                                                                                                                                Endpoint

                                                                                                                                                              -
                                                                                                                                                                +
                                                                                                                                                                • https://api.holidayextras.com/v1/booking/YourBookingRef
                                                                                                                                                                  @@ -358,7 +358,7 @@ 

                                                                                                                                                                  UK Products View Booking (for a

                                                                                                                                                                  Request

                                                                                                                                                                  -
                                                                                                                                                                    +
                                                                                                                                                                    • XML
                                                                                                                                                                    • @@ -366,7 +366,7 @@

                                                                                                                                                                      Request

                                                                                                                                                                    -
                                                                                                                                                                      +
                                                                                                                                                                      • https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com
                                                                                                                                                                        @@ -383,7 +383,7 @@ 

                                                                                                                                                                        Request

                                                                                                                                                                        Response

                                                                                                                                                                        -
                                                                                                                                                                          +
                                                                                                                                                                          • XML
                                                                                                                                                                          • @@ -391,7 +391,7 @@

                                                                                                                                                                            Response

                                                                                                                                                                          -
                                                                                                                                                                            +
                                                                                                                                                                            • <?xml version="1.0"?>
                                                                                                                                                                              @@ -917,7 +917,7 @@ 

                                                                                                                                                                              Response

                                                                                                                                                                              UK Products View Booking (for a transfer)

                                                                                                                                                                              Request

                                                                                                                                                                              -
                                                                                                                                                                                +
                                                                                                                                                                                • XML
                                                                                                                                                                                • @@ -925,7 +925,7 @@

                                                                                                                                                                                  Request

                                                                                                                                                                                -
                                                                                                                                                                                  +
                                                                                                                                                                                  • https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com
                                                                                                                                                                                    @@ -942,7 +942,7 @@ 

                                                                                                                                                                                    Request

                                                                                                                                                                                    Response

                                                                                                                                                                                    -
                                                                                                                                                                                      +
                                                                                                                                                                                      • XML
                                                                                                                                                                                      • @@ -950,7 +950,7 @@

                                                                                                                                                                                        Response

                                                                                                                                                                                      -
                                                                                                                                                                                        +
                                                                                                                                                                                        • <?xml version="1.0"?>
                                                                                                                                                                                          diff --git a/docs/partner/v2/index.html b/docs/partner/v2/index.html
                                                                                                                                                                                          index 81ea3c92..6a69e6fe 100644
                                                                                                                                                                                          --- a/docs/partner/v2/index.html
                                                                                                                                                                                          +++ b/docs/partner/v2/index.html
                                                                                                                                                                                          @@ -34,50 +34,45 @@ 

                                                                                                                                                                                          Partner API 2026 (APIConnect)

                                                                                                                                                                                          Partner API 2026 (APIConnect) is the next step for our platform. It brings UK and EU integrations together in one place, with OAuth 2.0 authentication and standardised contracts defined using an OpenAPI schema. The platform is built to scale as we expand into more markets.

                                                                                                                                                                                          -

                                                                                                                                                                                          This documentation is subject to change. Further features, including a booking list capability to support reconciliation and recovery flows, as well as wider product coverage, will be introduced in later phases.

                                                                                                                                                                                          +

                                                                                                                                                                                          Documentation

                                                                                                                                                                                          + +

                                                                                                                                                                                          Partner API 2026 documentation:

                                                                                                                                                                                          -

                                                                                                                                                                                          Environments

                                                                                                                                                                                          +

                                                                                                                                                                                          holidayextras/partner-api-documentation

                                                                                                                                                                                          + +

                                                                                                                                                                                          Start with the README for environments, base URLs, authentication and the current OpenAPI schema.

                                                                                                                                                                                          - - + - - - + + - - - + + - - - + + + + + + + + + +
                                                                                                                                                                                           ProductionStaging 
                                                                                                                                                                                          APIhttps://api.holidayextras.comhttps://api-sandbox.holidayextras.comGetting startedThe route from sandbox access to launch
                                                                                                                                                                                          Authhttps://auth.holidayextras.comhttps://auth-staging.holidayextras.comIntegration guidesAuthentication, sandbox testing, search, webhooks, versioning, price lock
                                                                                                                                                                                          OpenAPI Schemahttps://api.holidayextras.com/partner-api/v2/schema.jsonhttps://api-sandbox.holidayextras.com/partner-api/v2/schema.jsonAPI referencePer-endpoint request and response detail
                                                                                                                                                                                          Error handlingHow to respond to errors in your integration
                                                                                                                                                                                          FAQsCommon questions
                                                                                                                                                                                          -

                                                                                                                                                                                          Use staging for development and testing. Authenticate against the matching auth environment – staging credentials will not work against production and vice versa.

                                                                                                                                                                                          - -

                                                                                                                                                                                          View the schema in Swagger Editor or import into Postman.

                                                                                                                                                                                          - -

                                                                                                                                                                                          Documentation

                                                                                                                                                                                          - - -
                                                                                                                                                                                          diff --git a/docs/partner/v2/index.md b/docs/partner/v2/index.md index 2f872b60..d9f1da74 100644 --- a/docs/partner/v2/index.md +++ b/docs/partner/v2/index.md @@ -2,23 +2,18 @@ Partner API 2026 (APIConnect) is the next step for our platform. It brings UK and EU integrations together in one place, with OAuth 2.0 authentication and standardised contracts defined using an OpenAPI schema. The platform is built to scale as we expand into more markets. -This documentation is subject to change. Further features, including a booking list capability to support reconciliation and recovery flows, as well as wider product coverage, will be introduced in later phases. - -## Environments - -| | Production | Staging | -|---|---|---| -| **API** | `https://api.holidayextras.com` | `https://api-sandbox.holidayextras.com` | -| **Auth** | `https://auth.holidayextras.com` | `https://auth-staging.holidayextras.com` | -| **OpenAPI Schema** | `https://api.holidayextras.com/partner-api/v2/schema.json` | `https://api-sandbox.holidayextras.com/partner-api/v2/schema.json` | +## Documentation -Use staging for development and testing. Authenticate against the matching auth environment -- staging credentials will not work against production and vice versa. +Partner API 2026 documentation: -View the schema in [Swagger Editor](https://editor.swagger.io/) or import into [Postman](https://www.postman.com/). +### **[holidayextras/partner-api-documentation](https://github.com/holidayextras/partner-api-documentation)** -## Documentation +Start with the [README](https://github.com/holidayextras/partner-api-documentation/blob/main/README.md) for environments, base URLs, authentication and the current OpenAPI schema. -* [Authentication](./authentication.md) - OAuth 2.0 client credentials flow -* [Understanding the OpenAPI Documentation](./api-endpoint-navigation-guide.md) - Endpoint workflows and integration guide -* [Event Notifications](./webhook-integration-guide.md) - Webhook integration for booking status updates -* [Error Responses](./problems/bad-request.md) - HTTP error codes and resolution guidance +| | | +|---|---| +| [Getting started](https://github.com/holidayextras/partner-api-documentation/blob/main/onboarding.md) | The route from sandbox access to launch | +| [Integration guides](https://github.com/holidayextras/partner-api-documentation/tree/main/docs/integration-guides) | Authentication, sandbox testing, search, webhooks, versioning, price lock | +| [API reference](https://github.com/holidayextras/partner-api-documentation/tree/main/docs/api-reference) | Per-endpoint request and response detail | +| [Error handling](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/errors.md) | How to respond to errors in your integration | +| [FAQs](https://github.com/holidayextras/partner-api-documentation/blob/main/faqs.md) | Common questions | diff --git a/docs/partner/v2/problems/dependency-unavailable.md b/docs/partner/v2/problems/dependency-unavailable.md new file mode 100644 index 00000000..813ded6e --- /dev/null +++ b/docs/partner/v2/problems/dependency-unavailable.md @@ -0,0 +1,34 @@ +# Dependency Unavailable + +| Field | Value | +|-------|-------| +| **Status** | 503 | +| **Code** | `dependency_unavailable` | + +A service the request depended on could not be reached. This is the second of two `503` problems: [Service Unavailable](/partner/v2/problems/service-unavailable/) says the service itself cannot serve the request, while `dependency_unavailable` says the service is healthy but something it needed is not answering. + +## Common causes + +- A downstream booking, content or supply service was unreachable +- Repeated failures caused the API to stop calling a struggling dependency for a short period, so the call fails immediately rather than waiting +- The authentication service could not be reached to verify your token + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/dependency-unavailable", + "title": "Dependency Unavailable", + "status": 503, + "detail": null, + "code": "dependency_unavailable", + "trace_id": "abc123def456", + "errors": [] +} +``` + +`detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message. + +## How to resolve + +Retry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. Because the call may have been rejected without being attempted, retries are cheap, but keep the backoff -- retrying immediately will only extend the period the dependency is treated as unavailable. If the error persists, contact support with the `trace_id`. diff --git a/docs/partner/v2/problems/dependency-unavailable/index.html b/docs/partner/v2/problems/dependency-unavailable/index.html new file mode 100644 index 00000000..11740f36 --- /dev/null +++ b/docs/partner/v2/problems/dependency-unavailable/index.html @@ -0,0 +1,97 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Dependency Unavailable

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status503
                                                                                                                                                                                          Codedependency_unavailable
                                                                                                                                                                                          + +

                                                                                                                                                                                          A service the request depended on could not be reached. This is the second of two 503 problems: Service Unavailable says the service itself cannot serve the request, while dependency_unavailable says the service is healthy but something it needed is not answering.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • A downstream booking, content or supply service was unreachable
                                                                                                                                                                                          • +
                                                                                                                                                                                          • Repeated failures caused the API to stop calling a struggling dependency for a short period, so the call fails immediately rather than waiting
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The authentication service could not be reached to verify your token
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/dependency-unavailable",
                                                                                                                                                                                          +  "title": "Dependency Unavailable",
                                                                                                                                                                                          +  "status": 503,
                                                                                                                                                                                          +  "detail": null,
                                                                                                                                                                                          +  "code": "dependency_unavailable",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          detail is always null and errors always empty on a 5xx – server-side failures are described by code and trace_id, not by a message.

                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          Retry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. Because the call may have been rejected without being attempted, retries are cheap, but keep the backoff – retrying immediately will only extend the period the dependency is treated as unavailable. If the error persists, contact support with the trace_id.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/forbidden.md b/docs/partner/v2/problems/forbidden.md new file mode 100644 index 00000000..32f19407 --- /dev/null +++ b/docs/partner/v2/problems/forbidden.md @@ -0,0 +1,32 @@ +# Forbidden + +| Field | Value | +|-------|-------| +| **Status** | 403 | +| **Code** | `forbidden` | + +The credentials are valid, but the account they belong to is not permitted to perform this operation. Unlike a `401`, refreshing the token will not help. + +## Common causes + +- The account is not entitled to the product or operation being requested +- The requested resource belongs to a different account +- The operation is enabled for some environments or brands on the account but not the one being called + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/forbidden", + "title": "Forbidden", + "status": 403, + "detail": "Not permitted to perform this operation", + "code": "forbidden", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Do not retry -- the outcome will not change. Check that the resource being requested belongs to the authenticating account. If the operation should be available to you, contact your account manager or support with the `trace_id` to have the entitlement reviewed. diff --git a/docs/partner/v2/problems/forbidden/index.html b/docs/partner/v2/problems/forbidden/index.html new file mode 100644 index 00000000..46404ad1 --- /dev/null +++ b/docs/partner/v2/problems/forbidden/index.html @@ -0,0 +1,95 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Forbidden

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status403
                                                                                                                                                                                          Codeforbidden
                                                                                                                                                                                          + +

                                                                                                                                                                                          The credentials are valid, but the account they belong to is not permitted to perform this operation. Unlike a 401, refreshing the token will not help.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • The account is not entitled to the product or operation being requested
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The requested resource belongs to a different account
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The operation is enabled for some environments or brands on the account but not the one being called
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/forbidden",
                                                                                                                                                                                          +  "title": "Forbidden",
                                                                                                                                                                                          +  "status": 403,
                                                                                                                                                                                          +  "detail": "Not permitted to perform this operation",
                                                                                                                                                                                          +  "code": "forbidden",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          Do not retry – the outcome will not change. Check that the resource being requested belongs to the authenticating account. If the operation should be available to you, contact your account manager or support with the trace_id to have the entitlement reviewed.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/gateway-timeout.md b/docs/partner/v2/problems/gateway-timeout.md new file mode 100644 index 00000000..89ed1fd7 --- /dev/null +++ b/docs/partner/v2/problems/gateway-timeout.md @@ -0,0 +1,36 @@ +# Gateway Timeout + +| Field | Value | +|-------|-------| +| **Status** | 504 | +| **Code** | `gateway_timeout` | + +A service the request depended on did not respond within the time budget for the request. The call was abandoned, not refused -- so unlike a `503`, the downstream operation may or may not have completed. + +## Common causes + +- A downstream booking or content service was slow to respond +- The time budget for the request was already exhausted by earlier calls in the chain +- A dependency was recovering from load and responding well below its usual speed + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/gateway-timeout", + "title": "Gateway Timeout", + "status": 504, + "detail": null, + "code": "gateway_timeout", + "trace_id": "abc123def456", + "errors": [] +} +``` + +`detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message. + +## How to resolve + +For reads, retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. + +For writes -- creating a booking, or confirming an amendment or cancellation -- a `504` does not tell you whether the operation completed. Retry the request with the **same** `Idempotency-Key` rather than a new one, so a request that did land is returned to you instead of being duplicated. If the error persists, look the booking up before creating it again, and contact support with the `trace_id`. diff --git a/docs/partner/v2/problems/gateway-timeout/index.html b/docs/partner/v2/problems/gateway-timeout/index.html new file mode 100644 index 00000000..b28d012b --- /dev/null +++ b/docs/partner/v2/problems/gateway-timeout/index.html @@ -0,0 +1,99 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Gateway Timeout

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status504
                                                                                                                                                                                          Codegateway_timeout
                                                                                                                                                                                          + +

                                                                                                                                                                                          A service the request depended on did not respond within the time budget for the request. The call was abandoned, not refused – so unlike a 503, the downstream operation may or may not have completed.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • A downstream booking or content service was slow to respond
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The time budget for the request was already exhausted by earlier calls in the chain
                                                                                                                                                                                          • +
                                                                                                                                                                                          • A dependency was recovering from load and responding well below its usual speed
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/gateway-timeout",
                                                                                                                                                                                          +  "title": "Gateway Timeout",
                                                                                                                                                                                          +  "status": 504,
                                                                                                                                                                                          +  "detail": null,
                                                                                                                                                                                          +  "code": "gateway_timeout",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          detail is always null and errors always empty on a 5xx – server-side failures are described by code and trace_id, not by a message.

                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          For reads, retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts.

                                                                                                                                                                                          + +

                                                                                                                                                                                          For writes – creating a booking, or confirming an amendment or cancellation – a 504 does not tell you whether the operation completed. Retry the request with the same Idempotency-Key rather than a new one, so a request that did land is returned to you instead of being duplicated. If the error persists, look the booking up before creating it again, and contact support with the trace_id.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/gone.md b/docs/partner/v2/problems/gone.md new file mode 100644 index 00000000..eca0a249 --- /dev/null +++ b/docs/partner/v2/problems/gone.md @@ -0,0 +1,31 @@ +# Gone + +| Field | Value | +|-------|-------| +| **Status** | 410 | +| **Code** | `gone` | + +The resource was once available but has been permanently removed. Unlike a `404`, this is a statement that the resource will not come back, so there is nothing to poll for. + +## Common causes + +- The endpoint belongs to a retired API version +- The resource was permanently deleted rather than cancelled + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/gone", + "title": "Gone", + "status": 410, + "detail": "This resource is no longer available", + "code": "gone", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Do not retry. If the endpoint has been retired, move to the current version -- see [Versioning](/versioning/) for how versions are published and withdrawn. Otherwise stop requesting the resource and remove any stored reference to it. diff --git a/docs/partner/v2/problems/gone/index.html b/docs/partner/v2/problems/gone/index.html new file mode 100644 index 00000000..f6c1bd32 --- /dev/null +++ b/docs/partner/v2/problems/gone/index.html @@ -0,0 +1,94 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Gone

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status410
                                                                                                                                                                                          Codegone
                                                                                                                                                                                          + +

                                                                                                                                                                                          The resource was once available but has been permanently removed. Unlike a 404, this is a statement that the resource will not come back, so there is nothing to poll for.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • The endpoint belongs to a retired API version
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The resource was permanently deleted rather than cancelled
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/gone",
                                                                                                                                                                                          +  "title": "Gone",
                                                                                                                                                                                          +  "status": 410,
                                                                                                                                                                                          +  "detail": "This resource is no longer available",
                                                                                                                                                                                          +  "code": "gone",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          Do not retry. If the endpoint has been retired, move to the current version – see Versioning for how versions are published and withdrawn. Otherwise stop requesting the resource and remove any stored reference to it.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/index.html b/docs/partner/v2/problems/index.html new file mode 100644 index 00000000..5fe95cc8 --- /dev/null +++ b/docs/partner/v2/problems/index.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Error Responses

                                                                                                                                                                                          + +

                                                                                                                                                                                          This page is the reference for the problem type URIs the API returns. For guidance on how your integration should respond to each one – when to retry, what to show the customer – see the error handling guide in partner-api-documentation, which is the source of truth for Partner API documentation.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Every error returned by Partner API v2 uses the same problem details body, served as application/problem+json:

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/conflict",
                                                                                                                                                                                          +  "title": "Conflict",
                                                                                                                                                                                          +  "status": 409,
                                                                                                                                                                                          +  "detail": "The amendment token has expired",
                                                                                                                                                                                          +  "code": "token_expired",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldDescription
                                                                                                                                                                                          typeA stable URI identifying the class of problem. It resolves to the page for that problem, listed below.
                                                                                                                                                                                          titleA short, human-readable summary of the problem class.
                                                                                                                                                                                          statusThe HTTP status code, repeated in the body.
                                                                                                                                                                                          detailA human-readable explanation of this specific occurrence. Always null on a 5xx.
                                                                                                                                                                                          codeA machine-readable value for this specific occurrence. Branch on this, not on title or detail.
                                                                                                                                                                                          trace_idThe identifier to quote when contacting support. Present whenever a trace is available.
                                                                                                                                                                                          errorsField-level failures, each with field, message and an optional code. Always empty on a 5xx.
                                                                                                                                                                                          + +

                                                                                                                                                                                          type and code are not the same thing

                                                                                                                                                                                          + +

                                                                                                                                                                                          type names the class of problem and is drawn from the fixed list below. code names the specific occurrence and can be more precise than the type. In the example above, an expired amendment token is a conflict, so type is .../conflict, but code is the narrower token_expired.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Treat type as the stable link to documentation and code as the value your integration switches on. A new code can appear within an existing type without the type changing, so match code values you know and fall back on status for the rest rather than failing closed on an unrecognised value.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Problem types

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          StatusCanonical codeProblem
                                                                                                                                                                                          400bad_requestBad Request
                                                                                                                                                                                          401unauthorizedUnauthorized
                                                                                                                                                                                          403forbiddenForbidden
                                                                                                                                                                                          404resource_not_foundResource Not Found
                                                                                                                                                                                          405method_not_allowedMethod Not Allowed
                                                                                                                                                                                          406not_acceptableNot Acceptable
                                                                                                                                                                                          408request_timeoutRequest Timeout
                                                                                                                                                                                          409conflictConflict
                                                                                                                                                                                          410goneGone
                                                                                                                                                                                          415unsupported_media_typeUnsupported Media Type
                                                                                                                                                                                          422unprocessable_entityUnprocessable Entity
                                                                                                                                                                                          425too_earlyToo Early
                                                                                                                                                                                          429too_many_requestsToo Many Requests
                                                                                                                                                                                          500internal_errorInternal Server Error
                                                                                                                                                                                          502bad_gatewayBad Gateway
                                                                                                                                                                                          502upstream_errorUpstream Error
                                                                                                                                                                                          503service_unavailableService Unavailable
                                                                                                                                                                                          503dependency_unavailableDependency Unavailable
                                                                                                                                                                                          504gateway_timeoutGateway Timeout
                                                                                                                                                                                          + +

                                                                                                                                                                                          Retrying

                                                                                                                                                                                          + +

                                                                                                                                                                                          4xx problems describe something about the request and will fail again unchanged – fix the request rather than retrying it. The exceptions are Request Timeout, Too Early and Too Many Requests, where the request itself was never processed and a later attempt can succeed.

                                                                                                                                                                                          + +

                                                                                                                                                                                          5xx problems are server-side and usually transient. Retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts, then contact support with the trace_id.

                                                                                                                                                                                          + +

                                                                                                                                                                                          When retrying a write – creating a booking, or confirming an amendment or cancellation – always send the same Idempotency-Key as the original request. A retry with a fresh key can duplicate an operation that had already succeeded.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/index.md b/docs/partner/v2/problems/index.md new file mode 100644 index 00000000..694e952c --- /dev/null +++ b/docs/partner/v2/problems/index.md @@ -0,0 +1,65 @@ +# Error Responses + +This page is the reference for the problem `type` URIs the API returns. For guidance on how your integration should respond to each one -- when to retry, what to show the customer -- see the [error handling guide](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/errors.md) in [partner-api-documentation](https://github.com/holidayextras/partner-api-documentation), which is the source of truth for Partner API documentation. + +Every error returned by Partner API v2 uses the same problem details body, served as `application/problem+json`: + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/conflict", + "title": "Conflict", + "status": 409, + "detail": "The amendment token has expired", + "code": "token_expired", + "trace_id": "abc123def456", + "errors": [] +} +``` + +| Field | Description | +|-------|-------------| +| `type` | A stable URI identifying the class of problem. It resolves to the page for that problem, listed below. | +| `title` | A short, human-readable summary of the problem class. | +| `status` | The HTTP status code, repeated in the body. | +| `detail` | A human-readable explanation of this specific occurrence. Always `null` on a `5xx`. | +| `code` | A machine-readable value for this specific occurrence. Branch on this, not on `title` or `detail`. | +| `trace_id` | The identifier to quote when contacting support. Present whenever a trace is available. | +| `errors` | Field-level failures, each with `field`, `message` and an optional `code`. Always empty on a `5xx`. | + +## `type` and `code` are not the same thing + +`type` names the class of problem and is drawn from the fixed list below. `code` names the specific occurrence and can be more precise than the `type`. In the example above, an expired amendment token is a conflict, so `type` is `.../conflict`, but `code` is the narrower `token_expired`. + +Treat `type` as the stable link to documentation and `code` as the value your integration switches on. A new `code` can appear within an existing `type` without the `type` changing, so match `code` values you know and fall back on `status` for the rest rather than failing closed on an unrecognised value. + +## Problem types + +| Status | Canonical `code` | Problem | +|--------|------------------|---------| +| 400 | `bad_request` | [Bad Request](/partner/v2/problems/bad-request/) | +| 401 | `unauthorized` | [Unauthorized](/partner/v2/problems/unauthorized/) | +| 403 | `forbidden` | [Forbidden](/partner/v2/problems/forbidden/) | +| 404 | `resource_not_found` | [Resource Not Found](/partner/v2/problems/resource-not-found/) | +| 405 | `method_not_allowed` | [Method Not Allowed](/partner/v2/problems/method-not-allowed/) | +| 406 | `not_acceptable` | [Not Acceptable](/partner/v2/problems/not-acceptable/) | +| 408 | `request_timeout` | [Request Timeout](/partner/v2/problems/request-timeout/) | +| 409 | `conflict` | [Conflict](/partner/v2/problems/conflict/) | +| 410 | `gone` | [Gone](/partner/v2/problems/gone/) | +| 415 | `unsupported_media_type` | [Unsupported Media Type](/partner/v2/problems/unsupported-media-type/) | +| 422 | `unprocessable_entity` | [Unprocessable Entity](/partner/v2/problems/unprocessable-entity/) | +| 425 | `too_early` | [Too Early](/partner/v2/problems/too-early/) | +| 429 | `too_many_requests` | [Too Many Requests](/partner/v2/problems/too-many-requests/) | +| 500 | `internal_error` | [Internal Server Error](/partner/v2/problems/internal-error/) | +| 502 | `bad_gateway` | [Bad Gateway](/partner/v2/problems/bad-gateway/) | +| 502 | `upstream_error` | [Upstream Error](/partner/v2/problems/upstream-error/) | +| 503 | `service_unavailable` | [Service Unavailable](/partner/v2/problems/service-unavailable/) | +| 503 | `dependency_unavailable` | [Dependency Unavailable](/partner/v2/problems/dependency-unavailable/) | +| 504 | `gateway_timeout` | [Gateway Timeout](/partner/v2/problems/gateway-timeout/) | + +## Retrying + +`4xx` problems describe something about the request and will fail again unchanged -- fix the request rather than retrying it. The exceptions are [Request Timeout](/partner/v2/problems/request-timeout/), [Too Early](/partner/v2/problems/too-early/) and [Too Many Requests](/partner/v2/problems/too-many-requests/), where the request itself was never processed and a later attempt can succeed. + +`5xx` problems are server-side and usually transient. Retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts, then contact support with the `trace_id`. + +When retrying a write -- creating a booking, or confirming an amendment or cancellation -- always send the **same** `Idempotency-Key` as the original request. A retry with a fresh key can duplicate an operation that had already succeeded. diff --git a/docs/partner/v2/problems/request-timeout.md b/docs/partner/v2/problems/request-timeout.md new file mode 100644 index 00000000..e65c68a8 --- /dev/null +++ b/docs/partner/v2/problems/request-timeout.md @@ -0,0 +1,32 @@ +# Request Timeout + +| Field | Value | +|-------|-------| +| **Status** | 408 | +| **Code** | `request_timeout` | + +The request was not completed within the time the server was prepared to wait for it. Nothing was processed, so no booking or amendment will have been made. + +## Common causes + +- The request body was sent too slowly, or the connection stalled part-way through +- A connection was opened and held without a complete request being sent +- Network conditions between your client and the API delayed the request + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/request-timeout", + "title": "Request Timeout", + "status": 408, + "detail": "Request Timeout", + "code": "request_timeout", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Retry the request on a new connection. Because nothing was processed, a retry is safe. If timeouts recur, check for network issues or proxies between your client and the API, and confirm your client sends the full request body without long pauses. diff --git a/docs/partner/v2/problems/request-timeout/index.html b/docs/partner/v2/problems/request-timeout/index.html new file mode 100644 index 00000000..fcf4601f --- /dev/null +++ b/docs/partner/v2/problems/request-timeout/index.html @@ -0,0 +1,95 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Request Timeout

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status408
                                                                                                                                                                                          Coderequest_timeout
                                                                                                                                                                                          + +

                                                                                                                                                                                          The request was not completed within the time the server was prepared to wait for it. Nothing was processed, so no booking or amendment will have been made.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • The request body was sent too slowly, or the connection stalled part-way through
                                                                                                                                                                                          • +
                                                                                                                                                                                          • A connection was opened and held without a complete request being sent
                                                                                                                                                                                          • +
                                                                                                                                                                                          • Network conditions between your client and the API delayed the request
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/request-timeout",
                                                                                                                                                                                          +  "title": "Request Timeout",
                                                                                                                                                                                          +  "status": 408,
                                                                                                                                                                                          +  "detail": "Request Timeout",
                                                                                                                                                                                          +  "code": "request_timeout",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          Retry the request on a new connection. Because nothing was processed, a retry is safe. If timeouts recur, check for network issues or proxies between your client and the API, and confirm your client sends the full request body without long pauses.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/service-unavailable.md b/docs/partner/v2/problems/service-unavailable.md new file mode 100644 index 00000000..17b545e9 --- /dev/null +++ b/docs/partner/v2/problems/service-unavailable.md @@ -0,0 +1,34 @@ +# Service Unavailable + +| Field | Value | +|-------|-------| +| **Status** | 503 | +| **Code** | `service_unavailable` | + +The service is temporarily unable to handle the request. This is a transient, server-side condition and can be retried. + +## Common causes + +- A service is being deployed or restarted +- A service is shedding load while it recovers +- A downstream booking or content service reported itself unavailable + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/service-unavailable", + "title": "Service Unavailable", + "status": 503, + "detail": null, + "code": "service_unavailable", + "trace_id": "abc123def456", + "errors": [] +} +``` + +`detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message. + +## How to resolve + +Retry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. If the error persists, contact support with the `trace_id` from the response. See also [Dependency Unavailable](/partner/v2/problems/dependency-unavailable/), the other `503` this API can return. diff --git a/docs/partner/v2/problems/service-unavailable/index.html b/docs/partner/v2/problems/service-unavailable/index.html new file mode 100644 index 00000000..5ea9865f --- /dev/null +++ b/docs/partner/v2/problems/service-unavailable/index.html @@ -0,0 +1,97 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Service Unavailable

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status503
                                                                                                                                                                                          Codeservice_unavailable
                                                                                                                                                                                          + +

                                                                                                                                                                                          The service is temporarily unable to handle the request. This is a transient, server-side condition and can be retried.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • A service is being deployed or restarted
                                                                                                                                                                                          • +
                                                                                                                                                                                          • A service is shedding load while it recovers
                                                                                                                                                                                          • +
                                                                                                                                                                                          • A downstream booking or content service reported itself unavailable
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/service-unavailable",
                                                                                                                                                                                          +  "title": "Service Unavailable",
                                                                                                                                                                                          +  "status": 503,
                                                                                                                                                                                          +  "detail": null,
                                                                                                                                                                                          +  "code": "service_unavailable",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          detail is always null and errors always empty on a 5xx – server-side failures are described by code and trace_id, not by a message.

                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          Retry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. If the error persists, contact support with the trace_id from the response. See also Dependency Unavailable, the other 503 this API can return.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/too-many-requests.md b/docs/partner/v2/problems/too-many-requests.md new file mode 100644 index 00000000..01909895 --- /dev/null +++ b/docs/partner/v2/problems/too-many-requests.md @@ -0,0 +1,32 @@ +# Too Many Requests + +| Field | Value | +|-------|-------| +| **Status** | 429 | +| **Code** | `too_many_requests` | + +The request rate limit for your account has been exceeded. The request was rejected before it was processed, so nothing was created or changed. + +## Common causes + +- Sustained request volume above the rate agreed for your account +- A burst of parallel requests, such as a batch job started all at once +- A retry loop with no backoff, which multiplies the original request rate + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/too-many-requests", + "title": "Too Many Requests", + "status": 429, + "detail": "Rate limit exceeded", + "code": "too_many_requests", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Back off before retrying. If the response carries a `Retry-After` header, wait at least that long; otherwise retry with exponential backoff (e.g. 1s, 2s, 4s) and add jitter so parallel clients do not retry in lockstep. Cap the number of concurrent in-flight requests rather than relying on retries alone. If your integration needs a higher limit, contact your account manager. diff --git a/docs/partner/v2/problems/too-many-requests/index.html b/docs/partner/v2/problems/too-many-requests/index.html new file mode 100644 index 00000000..38c6ed5d --- /dev/null +++ b/docs/partner/v2/problems/too-many-requests/index.html @@ -0,0 +1,95 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Too Many Requests

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status429
                                                                                                                                                                                          Codetoo_many_requests
                                                                                                                                                                                          + +

                                                                                                                                                                                          The request rate limit for your account has been exceeded. The request was rejected before it was processed, so nothing was created or changed.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • Sustained request volume above the rate agreed for your account
                                                                                                                                                                                          • +
                                                                                                                                                                                          • A burst of parallel requests, such as a batch job started all at once
                                                                                                                                                                                          • +
                                                                                                                                                                                          • A retry loop with no backoff, which multiplies the original request rate
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/too-many-requests",
                                                                                                                                                                                          +  "title": "Too Many Requests",
                                                                                                                                                                                          +  "status": 429,
                                                                                                                                                                                          +  "detail": "Rate limit exceeded",
                                                                                                                                                                                          +  "code": "too_many_requests",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          Back off before retrying. If the response carries a Retry-After header, wait at least that long; otherwise retry with exponential backoff (e.g. 1s, 2s, 4s) and add jitter so parallel clients do not retry in lockstep. Cap the number of concurrent in-flight requests rather than relying on retries alone. If your integration needs a higher limit, contact your account manager.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/partner/v2/problems/unauthorized.md b/docs/partner/v2/problems/unauthorized.md new file mode 100644 index 00000000..ce73a43c --- /dev/null +++ b/docs/partner/v2/problems/unauthorized.md @@ -0,0 +1,33 @@ +# Unauthorized + +| Field | Value | +|-------|-------| +| **Status** | 401 | +| **Code** | `unauthorized` | + +The request did not carry credentials the API could verify. Responses to this problem also carry a `WWW-Authenticate: Bearer` header. + +## Common causes + +- No `Authorization` header was sent, or it was not in the form `Bearer {token}` +- The access token has expired +- The token was issued by a different environment to the one being called (a staging token against production, or the reverse) +- The token's signature could not be verified + +## Example response + +```json +{ + "type": "https://docs.holidayextras.co.uk/partner/v2/problems/unauthorized", + "title": "Unauthorized", + "status": 401, + "detail": "Invalid or expired token", + "code": "unauthorized", + "trace_id": "abc123def456", + "errors": [] +} +``` + +## How to resolve + +Request a fresh access token from the token endpoint and retry once with the new token. See the [Authentication integration guide](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/integration-guides/02-authentication.md) for the client credentials flow. Do not retry with the same token -- it will fail again. If a newly issued token is still rejected, check that the token and the API host belong to the same environment, then contact support with the `trace_id`. diff --git a/docs/partner/v2/problems/unauthorized/index.html b/docs/partner/v2/problems/unauthorized/index.html new file mode 100644 index 00000000..ab320717 --- /dev/null +++ b/docs/partner/v2/problems/unauthorized/index.html @@ -0,0 +1,96 @@ + + + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          +
                                                                                                                                                                                          +
                                                                                                                                                                                          +

                                                                                                                                                                                          Unauthorized

                                                                                                                                                                                          + + + + + + + + + + + + + + + + + + +
                                                                                                                                                                                          FieldValue
                                                                                                                                                                                          Status401
                                                                                                                                                                                          Codeunauthorized
                                                                                                                                                                                          + +

                                                                                                                                                                                          The request did not carry credentials the API could verify. Responses to this problem also carry a WWW-Authenticate: Bearer header.

                                                                                                                                                                                          + +

                                                                                                                                                                                          Common causes

                                                                                                                                                                                          + +
                                                                                                                                                                                            +
                                                                                                                                                                                          • No Authorization header was sent, or it was not in the form Bearer {token}
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The access token has expired
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The token was issued by a different environment to the one being called (a staging token against production, or the reverse)
                                                                                                                                                                                          • +
                                                                                                                                                                                          • The token’s signature could not be verified
                                                                                                                                                                                          • +
                                                                                                                                                                                          + +

                                                                                                                                                                                          Example response

                                                                                                                                                                                          + +
                                                                                                                                                                                          {
                                                                                                                                                                                          +  "type": "https://docs.holidayextras.co.uk/partner/v2/problems/unauthorized",
                                                                                                                                                                                          +  "title": "Unauthorized",
                                                                                                                                                                                          +  "status": 401,
                                                                                                                                                                                          +  "detail": "Invalid or expired token",
                                                                                                                                                                                          +  "code": "unauthorized",
                                                                                                                                                                                          +  "trace_id": "abc123def456",
                                                                                                                                                                                          +  "errors": []
                                                                                                                                                                                          +}
                                                                                                                                                                                          +
                                                                                                                                                                                          + +

                                                                                                                                                                                          How to resolve

                                                                                                                                                                                          + +

                                                                                                                                                                                          Request a fresh access token from the token endpoint and retry once with the new token. See the Authentication integration guide for the client credentials flow. Do not retry with the same token – it will fail again. If a newly issued token is still rejected, check that the token and the API host belong to the same environment, then contact support with the trace_id.

                                                                                                                                                                                          + +
                                                                                                                                                                                          + +
                                                                                                                                                                                          +
                                                                                                                                                                                          + + + + + + + diff --git a/docs/search/index.html b/docs/search/index.html index 59898989..66efd16e 100644 --- a/docs/search/index.html +++ b/docs/search/index.html @@ -43,6 +43,13 @@ } , + "hxapi-lounge-av-airport": { + "title": "Availability At Lounge", + "content": "Availability At LoungeLounge Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/AirportCodeFor example, for lounge availability at Gatwick the endpoint is:https://api.holidayextras.com/v1/lounge/LGWTo find the airport locations available for lounges, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up. Password String [A-Z0-9] 5 chars Y* Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. Initials String [A-Z] 3 chars N The initials of the Operator / Agent. key String [A-Z] Y This will be assigned to you by your Account Manager during set up. token String [0-9] 9 chars Y Please see user token endpoint for details of how to generate a token. ArrivalDate Date YYYY-MM-DD Y Date customer enters the lounge. ArrivalTime Time HHMM Y Time customer enters the lounge. Adults Integer [0-4] 1 char Y Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking. Children Integer [0-3] 1 char N Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking. Infants Integer 1 char N Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking. OutFlight String [A-Z0-9] 9 chars N This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal. Terminal String [A-Z1-9] 1 char N An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only). lang String [A-Z] 2 chars Y* Required for requests for European products. (Values available are en, de, it, es, pt and nl.) fields String [A-Z] a csv list of product info fields N A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint. Lounge Availability ResponseThe lounge availability response will return the specific product requested, so long as it has availability on the specific dates and times. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below: Field Additional Information Lounge/Name The name of the lounge. Lounge/Code The product code for the lounge, which must be used in the booking request. Lounge/BookingURL The URL to POST the booking request to for this particular product. Lounge/MoreInfoURL The link to more information about this product, sourced from the Product Library. Lounge/NonDiscPrice The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison. Lounge/Price The price of product without any surcharges/fees added. Lounge/terminal The terminal the lounge is in API_Header/Request The API returns every parameter and value you sent in the previous request. Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Requesthttps://api.holidayextras.com/v1/lounge/LHR?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0UK Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:24:54\"> <Lounge> <Name>Plaza Premium T5 lounge - 3 hours</Name> <Code>LHRPA5</Code> <BookingURL>/v1/lounge/HPLHRPA5</BookingURL> <MoreInfoURL>/v1/product/LHRPA5</MoreInfoURL> <NonDiscPrice>80.00</NonDiscPrice> <Price>80.00</Price> <terminal>5</terminal> <Filter> <landside>0</landside> </Filter> <option_count>14</option_count> </Lounge> <Lounge> <Name>No1 Lounge, Terminal 3, Heathrow</Name> <Code>LHRNN3</Code> <BookingURL>/v1/lounge/HPLHRNN3</BookingURL> <MoreInfoURL>/v1/product/LHRNN3</MoreInfoURL> <NonDiscPrice>64.00</NonDiscPrice> <Price>64.00</Price> <terminal>3</terminal> <Filter> <landside>0</landside> </Filter> <option_count>14</option_count> </Lounge> <Lounge> <Name>SkyTeam Lounge T4</Name> <Code>LHRSTE</Code> <BookingURL>/v1/lounge/HPLHRSTE</BookingURL> <MoreInfoURL>/v1/product/LHRSTE</MoreInfoURL> <NonDiscPrice>60.00</NonDiscPrice> <Price>60.00</Price> <terminal>4</terminal> <option_count>14</option_count> </Lounge> <Pricing> <CCardSurchargePercent>2.00</CCardSurchargePercent> <CCardSurchargeMin>0.00</CCardSurchargeMin> <CCardSurchargeMax>4.00</CCardSurchargeMax> <DCardSurchargePercent>0.00</DCardSurchargePercent> <DCardSurchargeMin>0.00</DCardSurchargeMin> <DCardSurchargeMax>0.00</DCardSurchargeMax> <CancellationWaiver> <Waiver>1.99</Waiver> </CancellationWaiver> <CancellationWaiver> <Waiver>1.99</Waiver> </CancellationWaiver> <Rates> <GBP>1</GBP> <EUR>1.1045</EUR> <USD>1.319</USD> </Rates> </Pricing> <SepaID/> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2018-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <Adults>2</Adults> <Children>0</Children> <v>1</v> </Request> </API_Header></API_Reply>European Products Availability Requesthttps://api.holidayextras.com/v1/lounge/HAM?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0&System=ABG&lang=deEuropean Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:30:25\"> <Lounge> <Name>Hamburg Airport Lounge</Name> <Code>HAMLHL</Code> <BookingURL>/v1/lounge/FRHAMLHL</BookingURL> <MoreInfoURL>/v1/product/HAMLHL</MoreInfoURL> <NonDiscPrice>74.00</NonDiscPrice> <Price>74.00</Price> <terminal>Z</terminal> <option_count>1</option_count> </Lounge> <Pricing> <CCardSurchargePercent>0.00</CCardSurchargePercent> <CCardSurchargeMin>0.00</CCardSurchargeMin> <CCardSurchargeMax>0.00</CCardSurchargeMax> <Rates> <GBP>1</GBP> <EUR>1.1045</EUR> <USD>1.319</USD> </Rates> </Pricing> <SepaID/> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2018-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <Adults>2</Adults> <Children>0</Children> <System>ABG</System> <lang>de</lang> <v>1</v> </Request> </API_Header></API_Reply>", + "url": "/hxapi/lounge/av/airport/" + } + , + "hxapi-parking-av-airport": { "title": "Availability At Airport", "content": "Availability At AirportAPI Docs > product:Parking > endpoint:carpark > request:Availability by AirportAirport Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/AirportCodeFor example, for London Gatwick the endpoint is:\tXML\tJSON\thttps://api.holidayextras.com/v1/carpark/LGW\thttps://api.holidayextras.com/v1/carpark/LGW.jsNote the .js extension.To find the airport locations available for car parking, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up. Password String [A-Z0-9] 5 chars Y* Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. Initials String [A-Z] 3 chars N The initials of the Operator / Agent. key String [A-Z] Y This will be assigned to you by your Account Manager during set up. token String [0-9] 9 chars Y Please see user token endpoint for details of how to generate a token. ArrivalDate Date YYYY-MM-DD Y Date customer drops vehicle at car park. ArrivalTime Time HHMM Y Time customer drops vehicle at car park. DepartDate Date YYYY-MM-DD Y Date customer picks up vehicle from car park. DepartTime Time HHMM Y Time customer picks up vehicle from car park. NumberOfPax Integer [0-9] 2 chars N Number of passengers. OutFlight String [A-Z0-9] 9 chars N This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal. Terminal String [A-Z1-9] 1 char N An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). filter String [A-Z] N Pass in values filter=on_airport, filter=recommended or filter=meet_and_greet to only show car parks meeting those criteria. You can filter by any field that comes back in the filter section of the API. Only a single filter can be used at once. fields String [A-Z] a csv list of product info fields N A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint. top3 Boolean [0,1] N ⚠ Deprecated: This feature limited the search results to only 3 products, one onsite, one park and ride and one meet and greet. It is no longer supported and will be removed in future releases. Your account manager will work with you to ensure the best products are always returned first instead. System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only). lang String [A-Z] 2 chars Y* Required for requests for European products. (Values available are en, de, it, es, pt and nl.) Airport Availability ResponseThe airport availability response will return all the products that have availability at the requested location on specific dates and durations. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below: Field Additional Information CarPark/Name The name of the product CarPark/Code The product code CarPark/BookingURL The URL to POST the booking request to for this particular product. Note: The product code includes prefix. CarPark/MoreInfoURL The link to more information about this product, sourced from the Product Library. Note: The product code doesn’t include prefix. CarPark/RequestFlags _NB. In Europe this will be replaced with <CarDetFlags>, see below for more info on these.These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request.Flags are only returned when required. The flags which can be returned are: Registration, CarMake, CarModel, CarColour, OutFlight, ReturnFlight, OutTerminal, ReturnTerminal, Destination, MobileNum. CarPark/NonDiscPrice The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison. CarPark/TotalPrice The price of product without any surcharges/fees added. CarPark/GatePrice If available, the price of product if you were to turn up on the day. CarPark/CanAmendCantCancel Whether the product can be amend but not cancelled. CarPark/CancellationFeeExceptions If the carpark has non-standard cancellation fees. CarPark/AmendmentFeeExceptions If the carpark has non-standard amendment fees. CarPark/Filter We have a filter mechanism on our site, to show particular types of product, such as Meet and Greet. The filters that apply to a product are returned here. Possible values are: meet_and_greet, recommended, terminal, on_airport, valet_included, car_parked_for_you, park_and_stroll and park_and_ride. Pricing/CreditCardSurcharge NB: This is only relevant for Intermediary Agents in Europe, where Holiday Extras is responsible for processing the payment, not the Agent. The first step in the calculation is to determine the credit card surcharge payable (x), based on the value of the booking, using this formula: x = (TotalPrice + the CanxWaiver) / 100 x CCardSurchargePercent Second, to prevent the surcharge from exceeding certain boundaries we have min and max thresholds, which can be calculated as follows: if x < CCardSurchargeMin; x = CCardSurchargeMin else if x > CCardSurchargeMax; x = CCardSurchargeMax Pricing/CancellationWaiver/Waiver We provide an optional cancellation waiver. If this is not added then cancellation will incur a fee. This returns the cancellation fee cost. API_Header/Request The API returns every parameter and value you sent in the previous request. CarDetFlags (Europe Only)For European products only, the availability response will return a field called <CarDetFlags>, which identifies the fields required when making a booking. (This is instead of the <RequestFlags> field which is returned for UK products only).For example: <CarDetFlags> NNNNNNNNNNNNNNNNNN </CarDetFlags>The order of the flags is always the same, and refers to these parameters respectively: Position Parameter Data Type Format Additional Information 1 Registration String See Expanded Formats Vehicle registration number NB: This field is not validated through the API. 2 CarMake String [A-Z0-9] 25 chars Make of vehicle, e.g. Audi. 3 CarModel String [A-Z0-9] 25 chars Model of vehicle, e.g. A6. 4 CarColour String [A-Z0-9] 25 chars Colour of vehicle, e.g. White. 5 NumberOfPax Integer [0-9] Number of passengers in the vehicle. 6 CarDropoffTime Time HHMM Arrival time when you drop the vehicle off at the car park e.g 1000. 7 CarPickupTime Time HHMM Return time, when you pick the vehicle up from the car park, e.g. 1600. 8 OutTerminal String [A-Z0-9] 2 chars Single letter or number representation of the terminal e.g N or S or 4 9 OutFltNo String [A-Z0-9] 10 chars Outbound flight number e.g. EZY123. 10 InFltNo String [A-Z0-9] 10 chars Return flight number e.g. EZY124. 11 OutFltTime Time HHMM Departure time of the outbound flight e.g. 1200. 12 InFltTime Time HHMM Arrival time of the inbound flight e.g. 1500. 13 MobileNum String [A-Z0-9] 15 chars Customer’s mobile number. 14 ShipName String [A-Z0-9] 20 chars Name of the ship, e.g. AIDA 15 PierName String [A-Z0-9] 20 chars Name of the pier or port where the ship is departing from 16 ChildSeat String Y/N Is a child car seat needed? 17 AddlServices String [A-Z0-9] 50 chars In this parameter you may add additional remarks regarding the booking. 18 RetTerminal String [A-Z0-9] 2 chars Single letter or number representation of the terminal e.g N or S or 4 NB: Where length restrictions have been noted in the above formats, any additional characters present in a field will be ignored.Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Request\tXML\tJSON\thttps://api.holidayextras.com/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1\thttps://api.holidayextras.com/carpark/LGW.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1Note the .js extension.UK Products Availability ResponseNB: This is a shortened example compiled from a full availability response.\tXML\tJSON\t<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2019-12-06 17:31:56\"> <CarPark> <Name>Purple Parking - all terminals</Name> <Code>LGV9</Code> <BookingURL>/carpark/HPLGV9</BookingURL> <MoreInfoURL>/product/LGV9</MoreInfoURL> <RequestFlags> <CarColour>1</CarColour> <CarMake>1</CarMake> <CarModel>1</CarModel> <Registration>1</Registration> <ReturnFlight>1</ReturnFlight> </RequestFlags> <NonDiscPrice>20.99</NonDiscPrice> <TotalPrice>19.94</TotalPrice> <GatePrice>0.00</GatePrice> <CanAmendCantCancel>0</CanAmendCantCancel> <Filter> <meet_and_greet>0</meet_and_greet> <park_and_ride>1</park_and_ride> <car_parked_for_you>1</car_parked_for_you> </Filter> <advance_purchase>1</advance_purchase> </CarPark> <CarPark> <Name>Purple Parking Flexible - all terminals</Name> <Code>LGV4</Code> <BookingURL>/carpark/HPLGV4</BookingURL> <MoreInfoURL>/product/LGV4</MoreInfoURL> <RequestFlags> <CarColour>1</CarColour> <CarMake>1</CarMake> <CarModel>1</CarModel> <Registration>1</Registration> <ReturnFlight>1</ReturnFlight> </RequestFlags> <NonDiscPrice>23.99</NonDiscPrice> <TotalPrice>22.79</TotalPrice> <GatePrice>0.00</GatePrice> <CanAmendCantCancel>0</CanAmendCantCancel> <Filter> <meet_and_greet>0</meet_and_greet> <park_and_ride>1</park_and_ride> <car_parked_for_you>1</car_parked_for_you> </Filter> </CarPark> <CarPark> <Name>Purple Parking Winter Special</Name> <Code>LGB3</Code> <BookingURL>/carpark/HPLGB3</BookingURL> <MoreInfoURL>/product/LGB3</MoreInfoURL> <RequestFlags> <CarColour>1</CarColour> <CarMake>1</CarMake> <CarModel>1</CarModel> <Registration>1</Registration> <ReturnFlight>1</ReturnFlight> </RequestFlags> <NonDiscPrice>21.59</NonDiscPrice> <TotalPrice>20.94</TotalPrice> <GatePrice>0.00</GatePrice> <CanAmendCantCancel>0</CanAmendCantCancel> <Filter> <meet_and_greet>0</meet_and_greet> <park_and_ride>1</park_and_ride> <car_parked_for_you>1</car_parked_for_you> </Filter> </CarPark> <Pricing> <CCardSurchargePercent>0.00</CCardSurchargePercent> <CCardSurchargeMin>0.00</CCardSurchargeMin> <CCardSurchargeMax>0.00</CCardSurchargeMax> <DCardSurchargePercent>0.00</DCardSurchargePercent> <DCardSurchargeMin>0.00</DCardSurchargeMin> <DCardSurchargeMax>0.00</DCardSurchargeMax> <CancellationWaiver> <Waiver>1.69</Waiver> </CancellationWaiver> </Pricing> <SepaID/> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-01-07</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2020-01-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> </Request> </API_Header></API_Reply>\t{ \"API_Reply\": { \"ATTRIBUTES\": { \"Product\": \"CarPark\", \"RequestCode\": 1, \"Result\": \"OK\", \"cached\": true, \"expires\": \"2019-12-06 17:33:10\" }, \"CarPark\": [ { \"ATTRIBUTES\": [], \"Name\": \"Purple Parking - all terminals\", \"Code\": \"LGV9\", \"BookingURL\": \"/carpark/HPLGV9.js\", \"MoreInfoURL\": \"/product/LGV9.js\", \"_latitude\": 51.142779, \"_longitude\": -0.211795, \"RequestFlags\": { \"CarColour\": 1, \"CarMake\": 1, \"CarModel\": 1, \"Registration\": 1, \"ReturnFlight\": 1 }, \"NonDiscPrice\": 20.99, \"TotalPrice\": 19.94, \"GatePrice\": \"0.00\", \"CanAmendCantCancel\": \"\", \"Filter\": { \"meet_and_greet\": \"0\", \"park_and_ride\": 1, \"car_parked_for_you\": 1 }, \"advance_purchase\": true }, { \"ATTRIBUTES\": [], \"Name\": \"Purple Parking Flexible - all terminals\", \"Code\": \"LGV4\", \"BookingURL\": \"/carpark/HPLGV4.js\", \"MoreInfoURL\": \"/product/LGV4.js\", \"_latitude\": 51.142957, \"_longitude\": -0.211055, \"RequestFlags\": { \"CarColour\": 1, \"CarMake\": 1, \"CarModel\": 1, \"Registration\": 1, \"ReturnFlight\": 1 }, \"NonDiscPrice\": 23.99, \"TotalPrice\": 22.79, \"GatePrice\": \"0.00\", \"CanAmendCantCancel\": \"\", \"Filter\": { \"meet_and_greet\": \"0\", \"park_and_ride\": 1, \"car_parked_for_you\": 1 } }, { \"ATTRIBUTES\": [], \"Name\": \"Purple Parking Winter Special\", \"Code\": \"LGB3\", \"BookingURL\": \"/carpark/HPLGB3.js\", \"MoreInfoURL\": \"/product/LGB3.js\", \"_latitude\": 51.142557, \"_longitude\": -0.210561, \"RequestFlags\": { \"CarColour\": 1, \"CarMake\": 1, \"CarModel\": 1, \"Registration\": 1, \"ReturnFlight\": 1 }, \"NonDiscPrice\": 21.59, \"TotalPrice\": 20.94, \"GatePrice\": \"0.00\", \"CanAmendCantCancel\": \"\", \"Filter\": { \"meet_and_greet\": \"0\", \"park_and_ride\": 1, \"car_parked_for_you\": 1 } } ], \"Pricing\": { \"CCardSurchargePercent\": \"0.00\", \"CCardSurchargeMin\": \"0.00\", \"CCardSurchargeMax\": \"0.00\", \"DCardSurchargePercent\": \"0.00\", \"DCardSurchargeMin\": \"0.00\", \"DCardSurchargeMax\": \"0.00\", \"CancellationWaiver\": [ { \"Waiver\": 1.69 } ] }, \"SepaID\": \"\", \"API_Header\": { \"Request\": { \"ABTANumber\": \"YourABTANumber\", \"Password\": \"YourPassword\", \"Initials\": \"YourInitials\", \"key\": \"YourKey\", \"token\": \"YourToken\", \"ArrivalDate\": \"2020-01-07\", \"ArrivalTime\": 1200, \"DepartDate\": \"2020-01-08\", \"DepartTime\": 1200, \"NumberOfPax\": 1, \"format\": \"js\" } } }}European Products Availability Request\tXML\tJSON\thttps://api.holidayextras.com/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en\thttps://api.holidayextras.com/carpark/MUC.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=enNote the .js extension.European Products Availability ResponseNB: This is a shortened example compiled from a full availability response.\tXML\tJSON\t<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2019-12-06 18:07:40\"> <CarPark> <Name>Airparks Parkplatz München Frühbucher</Name> <Code>MUCC</Code> <BookingURL>/carpark/FRMUCC</BookingURL> <MoreInfoURL>/product/MUCC</MoreInfoURL> <RequestFlags/> <NonDiscPrice>46.00</NonDiscPrice> <TotalPrice>46.00</TotalPrice> <GatePrice>0.00</GatePrice> <CancellationRule>0</CancellationRule> <CarDetFlags>NNNNNNNNNNNNNNNNNN</CarDetFlags> <CarDetails>Y</CarDetails> <DiscDates/> <Filter> <car_parked_for_you>1</car_parked_for_you> <meet_and_greet>0</meet_and_greet> <park_and_stroll/> <on_airport/> <recommended/> <special_offer_text>1</special_offer_text> <valet_included>0</valet_included> <park_and_ride>1</park_and_ride> </Filter> </CarPark> <CarPark> <Name>Parkservice Sky München</Name> <Code>MU01</Code> <BookingURL>/carpark/FRMU01</BookingURL> <MoreInfoURL>/product/MU01</MoreInfoURL> <RequestFlags/> <NonDiscPrice>28.00</NonDiscPrice> <TotalPrice>28.00</TotalPrice> <GatePrice>0.00</GatePrice> <CancellationRule>0</CancellationRule> <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags> <CarDetails>Y</CarDetails> <DiscDates/> <Filter> <car_parked_for_you>0</car_parked_for_you> <meet_and_greet>0</meet_and_greet> <park_and_stroll/> <on_airport/> <recommended/> <special_offer_text>0</special_offer_text> <valet_included>0</valet_included> <park_and_ride>1</park_and_ride> </Filter> </CarPark> <CarPark> <Name>Parkservice Sky München Winteraktion</Name> <Code>MU03</Code> <BookingURL>/carpark/FRMU03</BookingURL> <MoreInfoURL>/product/MU03</MoreInfoURL> <RequestFlags/> <NonDiscPrice>39.99</NonDiscPrice> <TotalPrice>39.99</TotalPrice> <GatePrice>0.00</GatePrice> <CancellationRule>0</CancellationRule> <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags> <CarDetails>Y</CarDetails> <DiscDates/> <Filter> <car_parked_for_you>0</car_parked_for_you> <meet_and_greet>0</meet_and_greet> <park_and_stroll/> <on_airport/> <recommended/> <special_offer_text>1</special_offer_text> <valet_included>0</valet_included> <park_and_ride>1</park_and_ride> </Filter> </CarPark> <Pricing> <CCardSurchargePercent>0.00</CCardSurchargePercent> <CCardSurchargeMin>0.00</CCardSurchargeMin> <CCardSurchargeMax>0.00</CCardSurchargeMax> </Pricing> <SepaID>DE11ZZZ00000633860</SepaID> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-01-07</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2020-01-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <System>ABG</System> <lang>en</lang> </Request> </API_Header></API_Reply>\t{ \"API_Reply\": { \"ATTRIBUTES\": { \"Product\": \"CarPark\", \"RequestCode\": 1, \"Result\": \"OK\", \"cached\": true, \"expires\": \"2019-12-06 18:26:33\" }, \"CarPark\": [ { \"ATTRIBUTES\": [], \"Name\": \"Airparks Parkplatz München Frühbucher\", \"Code\": \"MUCC\", \"BookingURL\": \"/carpark/FRMUCC.js\", \"MoreInfoURL\": \"/product/MUCC.js\", \"_latitude\": 48.35101, \"_longitude\": 11.8348, \"RequestFlags\": {}, \"NonDiscPrice\": 46, \"TotalPrice\": 46, \"GatePrice\": \"0.00\", \"CancellationRule\": \"0\", \"CarDetFlags\": \"NNNNNNNNNNNNNNNNNN\", \"CarDetails\": \"Y\", \"DiscDates\": \"\", \"Filter\": { \"car_parked_for_you\": 1, \"meet_and_greet\": \"0\", \"park_and_stroll\": \"\", \"on_airport\": null, \"recommended\": null, \"special_offer_text\": 1, \"valet_included\": \"0\", \"park_and_ride\": 1 } }, { \"ATTRIBUTES\": [], \"Name\": \"Parkservice Sky München\", \"Code\": \"MU01\", \"BookingURL\": \"/carpark/FRMU01.js\", \"MoreInfoURL\": \"/product/MU01.js\", \"_latitude\": 48.384242, \"_longitude\": 11.778148, \"RequestFlags\": {}, \"NonDiscPrice\": 28, \"TotalPrice\": 28, \"GatePrice\": \"0.00\", \"CancellationRule\": \"0\", \"CarDetFlags\": \"NNNNNNNNYYNYNNNNNN\", \"CarDetails\": \"Y\", \"DiscDates\": \"\", \"Filter\": { \"car_parked_for_you\": \"0\", \"meet_and_greet\": \"0\", \"park_and_stroll\": \"\", \"on_airport\": null, \"recommended\": null, \"special_offer_text\": \"0\", \"valet_included\": \"0\", \"park_and_ride\": 1 } }, { \"ATTRIBUTES\": [], \"Name\": \"Parkservice Sky München Winteraktion\", \"Code\": \"MU03\", \"BookingURL\": \"/carpark/FRMU03.js\", \"MoreInfoURL\": \"/product/MU03.js\", \"_latitude\": 48.384242, \"_longitude\": 11.778148, \"RequestFlags\": {}, \"NonDiscPrice\": 39.99, \"TotalPrice\": 39.99, \"GatePrice\": \"0.00\", \"CancellationRule\": \"0\", \"CarDetFlags\": \"NNNNNNNNYYNYNNNNNN\", \"CarDetails\": \"Y\", \"DiscDates\": \"\", \"Filter\": { \"car_parked_for_you\": \"0\", \"meet_and_greet\": \"0\", \"park_and_stroll\": \"\", \"on_airport\": null, \"recommended\": null, \"special_offer_text\": 1, \"valet_included\": \"0\", \"park_and_ride\": 1 } } ], \"Pricing\": { \"CCardSurchargePercent\": \"0.00\", \"CCardSurchargeMin\": \"0.00\", \"CCardSurchargeMax\": \"0.00\" }, \"SepaID\": \"DE11ZZZ00000633860\", \"API_Header\": { \"Request\": { \"ABTANumber\": \"YourABTANumber\", \"Password\": \"YourPassword\", \"Initials\": \"YourInitials\", \"key\": \"YourKey\", \"token\": \"YourToken\", \"ArrivalDate\": \"2020-01-07\", \"ArrivalTime\": 1200, \"DepartDate\": \"2020-01-08\", \"DepartTime\": 1200, \"NumberOfPax\": 1, \"System\": \"ABG\", \"lang\": \"en\", \"format\": \"js\" } } }}", @@ -57,13 +64,6 @@ } , - "hxapi-lounge-av-airport": { - "title": "Availability At Lounge", - "content": "Availability At LoungeLounge Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/AirportCodeFor example, for lounge availability at Gatwick the endpoint is:https://api.holidayextras.com/v1/lounge/LGWTo find the airport locations available for lounges, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up. Password String [A-Z0-9] 5 chars Y* Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. Initials String [A-Z] 3 chars N The initials of the Operator / Agent. key String [A-Z] Y This will be assigned to you by your Account Manager during set up. token String [0-9] 9 chars Y Please see user token endpoint for details of how to generate a token. ArrivalDate Date YYYY-MM-DD Y Date customer enters the lounge. ArrivalTime Time HHMM Y Time customer enters the lounge. Adults Integer [0-4] 1 char Y Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking. Children Integer [0-3] 1 char N Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking. Infants Integer 1 char N Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking. OutFlight String [A-Z0-9] 9 chars N This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal. Terminal String [A-Z1-9] 1 char N An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only). lang String [A-Z] 2 chars Y* Required for requests for European products. (Values available are en, de, it, es, pt and nl.) fields String [A-Z] a csv list of product info fields N A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint. Lounge Availability ResponseThe lounge availability response will return the specific product requested, so long as it has availability on the specific dates and times. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below: Field Additional Information Lounge/Name The name of the lounge. Lounge/Code The product code for the lounge, which must be used in the booking request. Lounge/BookingURL The URL to POST the booking request to for this particular product. Lounge/MoreInfoURL The link to more information about this product, sourced from the Product Library. Lounge/NonDiscPrice The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison. Lounge/Price The price of product without any surcharges/fees added. Lounge/terminal The terminal the lounge is in API_Header/Request The API returns every parameter and value you sent in the previous request. Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Requesthttps://api.holidayextras.com/v1/lounge/LHR?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0UK Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:24:54\"> <Lounge> <Name>Plaza Premium T5 lounge - 3 hours</Name> <Code>LHRPA5</Code> <BookingURL>/v1/lounge/HPLHRPA5</BookingURL> <MoreInfoURL>/v1/product/LHRPA5</MoreInfoURL> <NonDiscPrice>80.00</NonDiscPrice> <Price>80.00</Price> <terminal>5</terminal> <Filter> <landside>0</landside> </Filter> <option_count>14</option_count> </Lounge> <Lounge> <Name>No1 Lounge, Terminal 3, Heathrow</Name> <Code>LHRNN3</Code> <BookingURL>/v1/lounge/HPLHRNN3</BookingURL> <MoreInfoURL>/v1/product/LHRNN3</MoreInfoURL> <NonDiscPrice>64.00</NonDiscPrice> <Price>64.00</Price> <terminal>3</terminal> <Filter> <landside>0</landside> </Filter> <option_count>14</option_count> </Lounge> <Lounge> <Name>SkyTeam Lounge T4</Name> <Code>LHRSTE</Code> <BookingURL>/v1/lounge/HPLHRSTE</BookingURL> <MoreInfoURL>/v1/product/LHRSTE</MoreInfoURL> <NonDiscPrice>60.00</NonDiscPrice> <Price>60.00</Price> <terminal>4</terminal> <option_count>14</option_count> </Lounge> <Pricing> <CCardSurchargePercent>2.00</CCardSurchargePercent> <CCardSurchargeMin>0.00</CCardSurchargeMin> <CCardSurchargeMax>4.00</CCardSurchargeMax> <DCardSurchargePercent>0.00</DCardSurchargePercent> <DCardSurchargeMin>0.00</DCardSurchargeMin> <DCardSurchargeMax>0.00</DCardSurchargeMax> <CancellationWaiver> <Waiver>1.99</Waiver> </CancellationWaiver> <CancellationWaiver> <Waiver>1.99</Waiver> </CancellationWaiver> <Rates> <GBP>1</GBP> <EUR>1.1045</EUR> <USD>1.319</USD> </Rates> </Pricing> <SepaID/> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2018-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <Adults>2</Adults> <Children>0</Children> <v>1</v> </Request> </API_Header></API_Reply>European Products Availability Requesthttps://api.holidayextras.com/v1/lounge/HAM?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0&System=ABG&lang=deEuropean Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:30:25\"> <Lounge> <Name>Hamburg Airport Lounge</Name> <Code>HAMLHL</Code> <BookingURL>/v1/lounge/FRHAMLHL</BookingURL> <MoreInfoURL>/v1/product/HAMLHL</MoreInfoURL> <NonDiscPrice>74.00</NonDiscPrice> <Price>74.00</Price> <terminal>Z</terminal> <option_count>1</option_count> </Lounge> <Pricing> <CCardSurchargePercent>0.00</CCardSurchargePercent> <CCardSurchargeMin>0.00</CCardSurchargeMin> <CCardSurchargeMax>0.00</CCardSurchargeMax> <Rates> <GBP>1</GBP> <EUR>1.1045</EUR> <USD>1.319</USD> </Rates> </Pricing> <SepaID/> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2018-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <Adults>2</Adults> <Children>0</Children> <System>ABG</System> <lang>de</lang> <v>1</v> </Request> </API_Header></API_Reply>", - "url": "/hxapi/lounge/av/airport/" - } - , - "hxapi-viewamendcancel-amend-complex": { "title": "Amend Booking - complex (with reprice)", "content": "Amend Booking - complex (with reprice)API Docs > product:amendThe booking details that can be changed for a complex amend are as follows: Arrival date or time; Depart date or time.Amend Booking RequestWe recommend using the view booking method first, to ensure that you have all the details required from the most up to date record of the booking.You can then run a GET booking request using the amend endpoint and methodology detailed here to check the new amount (increase / decrease in price from original booking).The recommended process for amending a booking is as follows. Call the view booking method to ensure that you have all the details required from the most up to date record of the booking. Compose the amendment request as per the details below i.e. include the date change details. Then send this request as a GET rather than a POST. This will return the details of the pricing change. If the client is happy with the pricing change then resend the request as a POST this will confirm and commit the changes.MethodPOSTEndpointThe endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):https://api.holidayextras.com/v1/booking/YourBookingRefRequest ParametersNB: All parameter names are case sensitive.For all amend booking requests, you will need to send these parameters: Name Data Type Format Mandatory? Additional Information ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up. Password String [A-Z0-9] 5 chars N* Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. Initials String [A-Z] 3 chars N The initials of the Operator / Agent. key String [A-Z] Y This will be assigned to you by your Account Manager during set up. Email String [A-Z0-9] 50 chars Y Email address used to make the booking (i.e. the email address of the lead passenger) System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only). In order to amend the booking with the new details, you only need to pass in the specific parameters you want to amend. For a complex amend these are as follows: Name Data Type Format Mandatory? Additional Information ArrivalDate Date YYYY-MM-DD Y Date customer drops vehicle at car park. ArrivalTime Time HHMM Y Time customer drops vehicle at car park. DepartDate Date YYYY-MM-DD Y Date customer picks up vehicle from car park. DepartTime Time HHMM Y Time customer picks up vehicle from car park. Supplements[] - - N Amend supplement details by sending the parameters to amend. See below for more details Upgrade AmendmentsAs with booking upgrades it is possible to supply an array of Supplements to the amendment request to change the details of booked upgrades.To make amendments you need to specify the code of the upgrade to be changed and the fields you wish to change. The available fields are as below. Name Data Type Format Mandatory? Additional Information Adults Integer [0-9] N When specified the Children parameter must also be specified otherwise it will be assumed to be 0 Children Integer [0-9] N When specified the Adults parameter must also be specified otherwise it will be assumed to be 0 Quantity Integer [0-9] N Change the required quantity of per booking or per room upgrades Remove - - N The presence of this field will cause the upgrade to be removed from the booking To add new upgrades you just need to include the upgrade details in the same fashion as when booking an upgrade.Get Amendment Price ResponseThis response will be given when a GET version of this request is sent. This should be used to retrieve the new price before committing to amendments. Name Additional Information Pricing/OriginalPrice The price paid for the booking before any amendments Pricing/NewPrice The price to be paid if the amendments are confirmed Pricing/CanxWaiver The cost of any cancellation waiver that may be on the booking Pricing/Duration The new duration of the stay Pricing/MinPricingDuration The smallest duration of stay that the price can be increased by. For example if only increasing by 1 day but the MinPricingDuration is 3 days you will be charged for 3 days. Pricing/PriceDifference The difference between the originally paid price and the new price Carpark/Code Code of the booked product Carpark/Name Name of the booked product Carpark/MoreInfoURL   Carpark/BookingURL   BarCode   QRCode   API_Header/Request Copy of the original request params *NOTE* If the Pricing/PriceDifference is negative the minus sign will be a suffix e.g. <PriceDifference>7.00-</PriceDifference>Amend Booking ResponseThe amend booking response will return the booking record with all of the updated details.For a detailed explanation of the fields returned, please see the respective booking requests for hotels, parking and lounges.Worked ExamplesBelow are worked examples of both the request and response for amending (complex) a booking.Amend Booking (complex for a hotel)RequestThe original booking was made for a hotel staying on 1st December 2018 with 8 days parking.https://api.holidayextras.com/booking/YourBookingRef<Request> <ABTANumber>YourABTA</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <ArrivalDate>2018-12-02</ArrivalDate> <ParkingDays>15</ParkingDays></Request>Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"Hotel\" Customer=\"A\" Session=\"999999999\" RequestCode=\"14\" Result=\"OK\"> <CarDetails> <Registration>TEST123</Registration> <CarMake/> <CarModel/> <CarColour/> <OutFlight>TBC</OutFlight> </CarDetails> <ClientDetails> <Title>MRS</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address/> <DataProtection>Y</DataProtection> <Email>test@test.com</Email> </ClientDetails> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>931</AgentComm> <VATonComm/> </Booking> <Pricing> <OriginalPrice>93.10</OriginalPrice> <NewPrice>93.10</NewPrice> <CCardSurchargeAmount>0.00</CCardSurchargeAmount> <CanxWaiver>0.00</CanxWaiver> <AmendmentFee>N/A</AmendmentFee> <PriceDifference>N/A</PriceDifference> </Pricing> <Itinerary> <ArrivalDate>2018-12-02</ArrivalDate> <Nights>1</Nights> <BoardBasis>RO</BoardBasis> <Code>LHRMEP</Code> <CarDropoffTime>0000</CarDropoffTime> <CarPickupTime>0000</CarPickupTime> <CarPickupDate>2018-12-17</CarPickupDate> <ReturnFlight/> <TerminalCode/> <ParkingDays>15</ParkingDays> <ParkingSpaces>1</ParkingSpaces> <NonSmoking>Y</NonSmoking> </Itinerary> <Room> <Rooms>1</Rooms> <Adults>2</Adults> <Children>0</Children> <Infants>0</Infants> <Price>93.10</Price> <Code>DBL</Code> </Room> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <ArrivalDate>2018-12-02</ArrivalDate> <Nights>1</Nights> <RoomCode>DBL</RoomCode> <ParkingDays>15</ParkingDays> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>93.10</PriceCheckPrice> <v>1</v> </Request> </API_Header></API_Reply>Amend Parking Booking With UpgradesOriginal booking made for 11th November 2020 with Fast track upgrade for 2 adults and 1 childRequesthttps://api.holidayextras.com/booking/YourBookingRef<Request> <ABTANumber>YourABTA</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <Supplements> <Code>STNSFS</Code> <Adults>2</Adults> <Children>2</Children> </Supplements></Request>Get Amendment Price Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"CarPark\" Customer=\"A\" Session=\"999999999\" RequestCode=\"13\" Result=\"OK\"> <Pricing> <OriginalPrice>72.98</OriginalPrice> <NewPrice>79.98</NewPrice> <CCardSurchargeAmount>0.00</CCardSurchargeAmount> <CanxWaiver>0.00</CanxWaiver> <Duration>8</Duration> <MinPricingDuration>1</MinPricingDuration> <PriceDifference>7.00</PriceDifference> </Pricing> <CarPark> <Code>STN5</Code> <Name>Long Stay</Name> <MoreInfoURL>/v1/product/STN5</MoreInfoURL> <BookingURL>/v1/carpark/STN5</BookingURL> <Filter> <meet_and_greet>0</meet_and_greet> </Filter> </CarPark> <BarCode>/v1/barcode/YourBookingRef.png?key=YourKey</BarCode> <QRCode>/v1/qrcode/YourBookingRef.png?key=YourKey</QRCode> <API_Header> <Request> <v>1</v> </Request> </API_Header></API_Reply>Confirm Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"CarPark\" Customer=\"A\" Session=\"999999999\" RequestCode=\"14\" Result=\"OK\"> <CarDetails> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Registration>TE17 STS</Registration> <OutFlight/> </CarDetails> <ClientDetails> <Title>MRS</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address/> <DataProtection>Y</DataProtection> <Email>test@test.com</Email> </ClientDetails> <Booking> <BookingRef>YourBookingRef</BookingRef> </Booking> <Pricing> <OriginalPrice>72.98</OriginalPrice> <NewPrice>79.98</NewPrice> <PriceDiff>7.00</PriceDiff> <CCardSurchargeAmount>0.00</CCardSurchargeAmount> <CanxWaiver>0.00</CanxWaiver> </Pricing> <CarPark> <ArrivalDate>2020-11-11</ArrivalDate> <DepartDate>2020-11-19</DepartDate> <ArrivalTime>1230</ArrivalTime> <DepartTime>1345</DepartTime> <NumberOfPax>1</NumberOfPax> <ReturnFlight>VIR19</ReturnFlight> <Duration>8</Duration> <Remarks/> <Code>STN5</Code> <Name>Long Stay</Name> <MoreInfoURL>/v1/product/STN5</MoreInfoURL> <distance_to_airport>On airport</distance_to_airport> <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction> <logo>/imageLibrary/Images/85730-official-stansted-airport-parking-long-stay.png</logo> <BookingURL>/v1/carpark/STN5</BookingURL> <Filter> <meet_and_greet>0</meet_and_greet> </Filter> </CarPark> <BarCode>/v1/barcode/YourBookingRef.png?key=YourKey</BarCode> <QRCode>/v1/qrcode/YourBookingRef.png?key=YourKey</QRCode> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <token>YourToken</token> <Email>test@test.com</Email> <Supplements> <Code>STNSFS</Code> <Adults>2</Adults> <Children>2</Children> </Supplements> <v>1</v> </Request> </API_Header></API_Reply>", @@ -106,20 +106,6 @@ } , - "hxapi-parking-bkg": { - "title": "Book Car Park", - "content": "Book Car ParkAPI Docs > product:Parking > endpoint:carpark > Make BookingCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/CarParkCodeFor example, for Maple Manor Meet and Greet at London Gatwick North terminal the endpoint is:https://api.holidayextras.com/v1/carpark/LGW4Request ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up. Address[] String [A-Z0-9] 25 chars Y First line of address (house name / number and road) of lead passenger If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.NB: This field can be set to NA ArrivalDate Date YYYY-MM-DD Y Date customer drops vehicle at car park. ArrivalTime Time HHMM Y Time customer drops vehicle at car park. County String [A-Z] 20 chars Y County of address NB: This field can be set to NA CustomerRef String [A-Z0-9] 20 chars N A unique reference code associated with the customer’s booking for tracking and reference purposes. DepartDate Date YYYY-MM-DD Y Date customer picks up vehicle from car park. DepartTime Time HHMM Y Time customer picks up vehicle from car park. Email String [A-Z0-9] 50 chars Y Email of lead passenger Initial String [A-Z] 1 chars Y Initial of lead passenger Initials String [A-Z] 3 chars N The initials of the Operator / Agent. key String [A-Z] Y This will be assigned to you by your Account Manager during set up. NumberOfPax Integer [0-9] 2 chars Y Number of passengers. Password String [A-Z0-9] 5 chars N* Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. PostCode String [A-Z0-9] 10 chars Y Post code of address NB: This field can be set to NA PriceCheckFlag String Y Y Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving. If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount. You should then resubmit the request changing the PriceCheckPrice with the new price. PriceCheckPrice Float [0-9] Y Price of the product, received from the availability request or price check. Surname String [A-Z] 20 chars Y Surname of lead passenger System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only). Title String [A-Z] 4 chars Y Title of lead passenger, an option from the list of valid titles token String [0-9] 9 chars Y This is the same token used in the availability request. Town String [A-Z] 20 chars Y Town of address NB: This field can be set to NA lang String [A-Z] 2 chars Y* For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.) Supplements/Code String [A-Z0-9] 5 chars N Product code of the upgrade to book. See below for more info on booking upgrades Supplements/Date String YYYY-MM-DD Y The date to book the upgrade for. This should be brought forward from the upgrade availability request. Supplements/Quantity Integer [0-9]1 char Y* For per room/booking upgrades, specify the required quantity Supplements/Adults Integer [0-9]1 char Y* For per person upgrades, specify the number of adult passes Supplements/Children Integer [0-9]1 char Y* For per person upgrades, specify the number of child passes Supplements/TotalPrice Float [0-9] Y Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity Supplements/LoungeArrival String YYYY-MM-DD HH:mm Y* Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/carpark/STN5 HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows; Per Room or per Booking - Quantity x Price Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.UK ProductsThe <RequestFlags> field dictates which fields need to be sent as part of the booking request.European ProductsThe availability response will return a list of 18 flags in the <CarDetFlags> field with a yes/no response to indicate if required. The order of the flags is always the same.PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below: Field Additional Information Booking/BookingRef This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). Booking/AgentComm Commission you have earned from this booking. CarDetails Confirmation of the vehicle details that were sent in the booking request. CarDetails/Registration   CarDetails/CarMake   CarDetails/CarModel   CarDetails/CarColour   CarDetails/OutFlight   CarDetails/Destination   CarDetails/MobileNum   ClientDetails Confirmation of the lead passenger’s details that were sent in the booking request. ClientDetails/Title   ClientDetails/Initials   ClientDetails/Surname   ClientDetails/Email   HandlingFee Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero. MoreInfoURL The URL for viewing the booking. See view booking for more details. CarPark Details of the car park that were sent in the booking request. CarPark/ArrivalDate   CarPark/DepartDate   CarPark/ArrivalTime   CarPark/DepartTime   CarPark/Duration   CarPark/NumberOfPax   CarPark/ReturnFlight   CarPark/Code   CarPark/TotalPrice   CarPark/Name   CarPark/introduction Production description text CarPark/logo Product logo. Prepend with https: CarPark/RequiresQRCode Whether the QR Code needs to be used for this carpark, instead of the barcode CarPark/BookingUrl Prepend with https://api.holidayextras.com/ CarPark/MoreInfoUrl Prepend with https://api.holidayextras.com/ BarCode URL to the barcode for the booking. Prepend with https://api.holidayextras.com/ QRCode URL to the QR code for the booking. Prepend with https://api.holidayextras.com/ QRCodeValue (EU only) Value of the QR code that comes with email confirmation. More details about QR Code QRCodeValueStr (EU only) Value of the QR code that comes with email confirmation, when returning as part of a JSON resposne this value will be a string. More details about QR Code FastTrackVouchers/Name Only present if Fast track products have been purchased - Name used to separate multiple voucher products FastTrackVouchers/Source Link to the voucher document to be embeded in the client email FastTrackVouchers/type Content type qualifier for the Source Booking/Status (Future) Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error). Booking/SuggestedPollingInterval (Future) Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.) CurrentSupplements/Code Upgrade Code CurrentSupplements/Name Name of the upgrade CurrentSupplements/Price Price Paid for the upgrade CurrentSupplements/NonDiscPrice The original price of the upgrade before any discounts CurrentSupplements/Per The pricing basis for the product (booking/room/person) CurrentSupplements/Adults The number of adult passes purchased CurrentSupplements/Children The number of child passes purchased CurrentSupplements/Date The date the upgrade has been purchased for CurrentSupplements/Remarks Internal notes CurrentSupplements/Canx Whether the upgrade can be cancelled API_Header/Request A list of parameters that were sent in the booking request. Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking car parking.UK Products BookingRequesthttps://api.holidayextras.com/carpark/LGW4<Request> <ABTANumber>YourABTA</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>57.99</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Destination>Munich</Destination> <OutFlight>EZY8985</OutFlight> <OutTerminal>N</OutTerminal> <Registration>TE17 STS</Registration> <ReturnFlight>EZY8982</ReturnFlight> <ReturnTerminal>N</ReturnTerminal> <MobileNum>01234567890</MobileNum></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>7.25</AgentComm> <VATonComm>0.00</VATonComm> </Booking> <CarDetails> <Registration>TE17 STS</Registration> <CarMake>RANGE ROVER</CarMake> <CarModel>EVOQUE</CarModel> <CarColour>WHITE</CarColour> <OutFlight>EZY8985</OutFlight> <Destination>MUNICH</Destination> <MobileNum/> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Email>test@test.com</Email> </ClientDetails> <HandlingFee>0.00</HandlingFee> <MoreInfoURL>/booking/YourBookingRef</MoreInfoURL> <CarPark> <ArrivalDate>2017-12-01</ArrivalDate> <DepartDate>2017-12-08</DepartDate> <ArrivalTime>1200</ArrivalTime> <DepartTime>1200</DepartTime> <Duration>7</Duration> <NumberOfPax>1</NumberOfPax> <ReturnFlight>EZY8982</ReturnFlight> <Code>LGW4</Code> <TotalPrice>57.99</TotalPrice> <Name>Maple Manor Meet and Greet North</Name> <introduction>With 20 years' experience in providing a great service, Maple Manor Meet and Greet parking is a firm favourite with our customers and it's easy to see why. One of their professional, insured chauffeurs will meet you at the North terminal and park your car for you in a secured car park while you catch your flight. It couldn't be simpler and all for this low price. We only sell airport-approved Meet and Greet services and Maple Manor is no exception.</introduction> <advance_purchase>1</advance_purchase> <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/LGW4_LGV0_LGT9_LGY8_thumbnail_logo.png</logo> <BookingURL>/carpark/LGW4</BookingURL> <MoreInfoURL>/product/LGW4</MoreInfoURL> </CarPark> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>57.99</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Registration>TE17 STS</Registration> <Destination>Munich</Destination> <OutFlight>EZY8985</OutFlight> <OutTerminal>N</OutTerminal> <ReturnFlight>EZY8982</ReturnFlight> <ReturnTerminal>N</ReturnTerminal> <MobileNum>01234567890</MobileNum> </Request> </API_Header></API_Reply>European Products BookingRequesthttps://api.holidayextras.com/carpark/MU01<Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>HERR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>35.00</PriceCheckPrice> <System>ABG</System> <OutFltNo>EZY8982</OutFltNo> <InFltNo>EZY8985</InFltNo> <InFltTime>1130</InFltTime></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"4\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>3.75</AgentComm> <VATonComm>0.00</VATonComm> </Booking> <MoreInfoURL>/carpark/YourBookingRef.de</MoreInfoURL> <CarPark> <ArrivalDate>2017-12-01</ArrivalDate> <DepartDate>2017-12-08</DepartDate> <ArrivalTime>1200</ArrivalTime> <DepartTime>1200</DepartTime> <Duration>7</Duration> <NumberOfPax>1</NumberOfPax> <ReturnFlight/> <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags> <Code>MU01</Code> <Name>Parkservice Sky München</Name> <BookingURL>/carpark/MU01.de</BookingURL> <MoreInfoURL>/product/MU01.de</MoreInfoURL> <TotalPrice>35.00</TotalPrice> <GatePrice>0.00</GatePrice> </CarPark> <BarCode>/barcode/YourBookingRef.png?key=YourKey</BarCode> <ClientDetails> <Title>HERR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Email>TEST@TEST.COM</Email> <Town>TESTVILLE</Town> <Postcode>TE12 3ST</Postcode> <DayPhone>TBC</DayPhone> <Remarks/> <Address0>123 TEST STREET</Address0> <DataProtection>Y</DataProtection> <County>TESTSHIRE</County> <Confirmation>Y</Confirmation> </ClientDetails> <Pricing> <TotalPrice>35.00</TotalPrice> </Pricing> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>HERR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>35.00</PriceCheckPrice> <System>ABG</System> <OutFltNo>EZY8982</OutFltNo> <InFltNo>EZY8985</InFltNo> <InFltTime>1130</InFltTime> </Request> </API_Header></API_Reply>UK Product booking With UpgradesRequesthttps://api.holidayextras.com/carpark/STN5<Request> <ABTANumber>YourABTA</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-11-08</ArrivalDate> <ArrivalTime>1230</ArrivalTime> <ArrivalDate>2020-11-06</ArrivalDate> <DepartTime>1345</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>57.99</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Destination>Munich</Destination> <OutFlight>EZY8985</OutFlight> <OutTerminal>N</OutTerminal> <Registration>TE17 STS</Registration> <ReturnFlight>EZY8982</ReturnFlight> <ReturnTerminal>N</ReturnTerminal> <MobileNum>01234567890</MobileNum> <Supplements> <Code>HXOST1</Code> <Date>2020-11-08</Date> <Quantity>1</Quantity> </Adults> </Children> <TotalPrice>1.99</TotalPrice> </Supplements> <Supplements> <Code>STNSFS</Code> <Date>2020-11-08</Date> </Quantity> <Adults>2</Adults> <Children>1</Children> <TotalPrice>15.00</TotalPrice> </Supplements></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>3.75</AgentComm> <VATonComm>0.00</VATonComm> </Booking> <CarDetails> <Registration>TE17 STS</Registration> <CarMake>RANGE ROVER</CarMake> <CarModel>EVOQUE</CarModel> <CarColour>WHITE</CarColour> <OutFlight/> <Destination>-</Destination> <MobileNum>01234567890</MobileNum> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>Test</Surname> <Email>test@test.com</Email> </ClientDetails> <HandlingFee>0.00</HandlingFee> <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL> <CarPark> <ArrivalDate>2020-11-08</ArrivalDate> <DepartDate>2020-11-16</DepartDate> <ArrivalTime>1230</ArrivalTime> <DepartTime>1345</DepartTime> <Duration>8</Duration> <NumberOfPax>1</NumberOfPax> <ReturnFlight>VIR19</ReturnFlight> <Code>STN5</Code> <TotalPrice>49.99</TotalPrice> <Name>Long Stay</Name> <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction> <advance_purchase>1</advance_purchase> <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/85730-official-stansted-airport-parking-long-stay.png</logo> <RequiresQRCode>0</RequiresQRCode> <BookingURL>/v1/carpark/STN5</BookingURL> <MoreInfoURL>/v1/product/STN5</MoreInfoURL> </CarPark> <BarCode>/v1/barcode/YourBookingRef.png?key=ONLIN</BarCode> <QRCode>/v1/qrcode/YourBookingRef.png?key=ONLIN</QRCode> <FastTrackVouchers> <name>Fast Track Voucher</name> <source>https://voucher.holidayextras.co.uk/voucher/fastTrack?email=YourEmail&amp;booking_ref=YourBookingRef&amp;agent=YourABTANumber&amp;productType=carparks&amp;productCode=STNSFS</source> <type>text/html</type> </FastTrackVouchers> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-11-08</ArrivalDate> <ArrivalTime>12:30</ArrivalTime> <DepartDate>2020-11-16</DepartDate> <DepartTime>13:45</DepartTime> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>50.05</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Registration>TE17 STS</Registration> <ReturnFlight>VIR19</ReturnFlight> <Supplement> <Code>HXOST1</Code> <Date>2017-12-01</Date> <Quantity>1</Quantity> </Supplement> <Supplement> <Code>STNSFS</Code> <Date>2017-12-01</Date> <Adults>2</Adults> <Children>1</Children> </Supplement> <v>1</v> </Request> </API_Header></API_Reply>", - "url": "/hxapi/parking/bkg/" - } - , - - "hxapi-de-start-bkg": { - "title": "Book Car Park - DE-Start method", - "content": "Book Car Park - DE-Start methodCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://payment.holidayextras.com/legacy/carpark/CarParkCodeRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information StartCustomer String [0-9] 6 chars Y This will be assigned to you by your Account Manager during set up. BusinessUnit String [0-9] 3 chars Y This will be assigned to you by your Account Manager during set up. Operator String [A-Z] 3 chars Y This always defaults to BJT. key String [A-Z] 10 chars Y This will be assigned to you by your Account Manager during set up. token String [0-9] 9 chars Y This is the same token used in the availability request. ArrivalDate Date YYYY-MM-DD Y Date customer drops vehicle at car park. ArrivalTime Time HHMM Y Time customer drops vehicle at car park. DepartDate Date YYYY-MM-DD Y Date customer picks up vehicle from car park. DepartTime Time HHMM Y Time customer picks up vehicle from car park. Registration String [A-Z0-9] 15 chars N § Vehicle registration number. CarMake String [A-Z0-9] 25 chars N § The make of the car, e.g Audi. CarModel String [A-Z0-9] 25 chars N § The model of the car, e.g. A6. CarColour String [A-Z] 25 chars N § The colour of the car, e.g. black. Title String [0-9] 4 chars Y Title of lead passenger. Initial String [A-Z] 1 chars Y Initial of lead passenger. Surname String [A-Z] 20 chars Y Surname of lead passenger. NumberOfPax Integer [0-9] 2 chars Y Number of passengers. Remarks String [A-Z0-9] 60 chars N Any remarks the agent wishes to add to the booking. Please note, these are not passed through to the supplier. NB: The fields required by the carpark are returned in the availability request, in the <RequestFlags> element.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.PaymentThis existing integration does support direct encashment from retail customers. For more information please see the section on Payment.Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below: Booking/BookingRef This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). Booking/AgentComm Commission you have earned from this booking. CarDetails Confirmation of the vehicle details that were sent in the booking request. ClientDetails Confirmation of the lead passenger’s details that were sent in the booking request. HandlingFee Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero. MoreInfoURL The URL for viewing the booking. CarPark Details of the car park that were sent in the booking request. API_Header/Request A list of parameters that were sent in the booking request. Worked ExamplesBelow are worked examples of both the request and response for booking car parking using the DE-Start method.Car Park Booking Request - DE-Start methodhttps://payment.holidayextras.com/legacy/carpark/FRA8 <Request> <StartCustomer>YourStartCustomer</StartCustomer> <BusinessUnit>YourBusinessUnit</BusinessUnit> <Operator>BJT</Operator> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Registration>TE17 STS</Registration> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <CarColour>White</CarColour> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Remarks>Car Park Test</Remarks> </Request>Car Park Booking Response - DE-Start method<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>5.47-</AgentComm> <VATonComm>0.87-</VATonComm> <StartRef>YourStartRef</StartRef> </Booking> <CarDetails> <Registration>TE17 STS</Registration> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <CustomerRef>N/A</CustomerRef> <Remarks>Car Park Test</Remarks> </ClientDetails> <API_Header> <Request> <StartCustomer>YourStartCustomer</StartCustomer> <BusinessUnit>YourBusinessUnit</BusinessUnit> <Operator>BJT</Operator> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Registration>TE17 STS</Registration> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <CarColour>White</CarColour> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Remarks>Car Park Test</Remarks> <debug>1</debug> <system>de</system> <System>ABG</System> </Request> </API_Header> <CarPark> <ArrivalDate>01DEC18</ArrivalDate> <DepartDate>08DEC18</DepartDate> <ArrivalTime>1200</ArrivalTime> <DepartTime>1200</DepartTime> <Duration>8</Duration> <NumberOfPax>1</NumberOfPax> <Code>FRA8</Code> <BookingURL>/api/carpark/FRA8/debug</BookingURL> <MoreInfoURL>/api/product/FRA8/debug</MoreInfoURL> </CarPark></API_Reply>", - "url": "/hxapi/de-start/bkg/" - } - , - "hxapi-hotel-bkg": { "title": "Hotel Booking Request", "content": "Hotel Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/hotel/LocationCodeFor example, for Mercure at London Heathrow the endpoint is:https://api.holidayextras.com/v1/hotel/LHRMEARequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up. Password String [A-Z0-9] 5 chars N* Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. Initials String [A-Z] 3 chars N The initials of the Operator / Agent. key String [A-Z] Y This will be assigned to you by your Account Manager during set up. token String [0-9] 9 chars Y This is the same token used in the availability request. ArrivalDate Date YYYY-MM-DD Y Date customer arrives at hotel. Nights Integer 1, 2, 3, etc Y Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays. RoomCode String [A-Z0-9] 3 chars Y See RoomCodes for a list of valid codes. Adults Integer [1-5] 1 char Y The number of adults occupying the room. Children Integer [0-4] 1 char Y The number of children occupying the room. ParkingDays Integer [0-9] 2 chars Y NB: The maximum duration accepted for ParkingDays is 30. Title String [A-Z] 4 chars Y Title of lead passenger, an option from the list of valid titles Initial String [A-Z] 1 chars Y Initial of lead passenger Surname String [A-Z] 20 chars Y Surname of lead passenger Address[] String [A-Z0-9] 25 chars Y First line of address (house name / number and road) of lead passenger. If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on. NB: This field can be set to NA Town String [A-Z] 20 chars Y Town of address. NB: This field can be set to NA County String [A-Z] 20 chars Y County of address. NB: This field can be set to NA PostCode String [A-Z0-9] 10 chars Y Post code of address. NB: This field can be set to NA DayPhone Integer [0-9] 20 chars max N The customer’s telephone number. Email String [A-Z0-9] 50 chars Y The email address of customer. CustomerRef String [A-Z0-9] 20 chars N Enter your Customer Reference to help match bookings for accounting purposes. Remarks String [A-Z0-9] 60 chars N Pass in Remarks for notification such as COT REQUESTED in ROOM Waiver Boolean [0,1] Y Defaults to 0 if not supplied. DataProtection String [Y,N] N Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied. PriceCheckFlag String [Y] Y Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving. If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount. You should then resubmit the request changing the PriceCheckPrice with the new price. PriceCheckPrice Float [0-9] Y Price of the product, received from the availability request or price check. System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only). lang String [A-Z] 2 chars Y* For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.) Supplements/Code String [A-Z0-9] 5 chars N Product code of the upgrade to book. See below for more info on booking upgrades Supplements/Date String YYYY-MM-DD Y The date to book the upgrade for. This should be brought forward from the upgrade availability request. Supplements/Quantity Integer [0-9]1 char Y* For per room/booking upgrades, specify the required quantity Supplements/Adults Integer [0-9]1 char Y* For per person upgrades, specify the number of adult passes Supplements/Children Integer [0-9]1 char Y* For per person upgrades, specify the number of child passes Supplements/TotalPrice Float [0-9] Y Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity Supplements/LoungeArrival String YYYY-MM-DD HH:mm Y* Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/hotel/LGWSOF HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows; Per Room or per Booking - Quantity x Price Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Multiple rooms on same bookingCurrently, we can only accept a maximum of 2 rooms per booking. If the customer needs more, you will need to make multiple requests. If an intermediary account, you should note that this would lead to multiple transactions on the credit card, and multiple charges, and therefore we advise against it.The additional parameters for including a second room are: Name Data Type Format Mandatory? Additional Information SecondRoomType String [A-Z0-9] 2 chars N* This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per Room Codes. SecondRoomCode String Room Codes N NB: Please note that the room codes differ between availability and booking requests. SecondRoomAdults Integer [1-5] 1 char N The number of adults occupying the second room. SecondRoomChildren Integer [0-4] 1 char N The number of children occupying the second room. UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are: Name Data Type Format Mandatory? CarDropoffDate Date YYYY-MM-DD Y CarDropoffTime Time HHMM Y CarPickupDate Date YYYY-MM-DD Y CarPickupTime Time HHMM Y ReturnFlight String [A-Z0-9] 10 chars N TerminalCode String [A-Z0-9] 2 chars N Registration String [A-Z0-9] 20 chars N CarMake String [A-Z0-9] 20 chars N CarModel String [A-Z0-9] 20 chars N CarColour String [A-Z0-9] 20 chars N PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Hotel Booking ResponseThe hotel booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below: Field Additional Information Booking/BookingRef This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). Booking/AgentComm Commission you have earned from this booking. Itinerary This section confirms details of the hotel on the booking. Room This section confirms details of the room booked at the hotel. ClientDetails Confirmation of the customer’s details that were sent in the booking request. Pricing Confirmation of the price paid by the customer for the hotel room. Booking/Status (Future) Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error). Booking/SuggestedPollingInterval (Future) Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.) CurrentSupplements/Code Upgrade Code CurrentSupplements/Name Name of the upgrade CurrentSupplements/Price Price Paid for the upgrade CurrentSupplements/NonDiscPrice The original price of the upgrade before any discounts CurrentSupplements/Per The pricing basis for the product (booking/room/person) CurrentSupplements/Adults The number of adult passes purchased CurrentSupplements/Children The number of child passes purchased CurrentSupplements/Date The date the upgrade has been purchased for CurrentSupplements/Remarks Internal notes CurrentSupplements/Canx Whether the upgrade can be cancelled API_Header/Request A list of parameters that were sent in the booking request. Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking hotels.UK Hotel Booking - Room OnlyRequesthttps://api.holidayextras.com/v1/hotel/LHRMEA<Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <Nights>1</Nights> <RoomCode>DBL</RoomCode> <ParkingDays>0</ParkingDays> <Adults>2</Adults> <Children>0</Children> <Title>Mr</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address >1 Test Street</Address > <Town>Testville</Town> <County>Testshire</County> <Postcode>TE1 STS</Postcode> <DayPhone>01234567890</DayPhone> <Email>test@test.com</Email> <DataProtection>N</DataProtection> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>55.00</PriceCheckPrice> <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>6.53</AgentComm> <VATonComm>0.00</VATonComm> <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL> </Booking> <Hotel/> <Itinerary> <TotalPrice>55.00</TotalPrice> <ArrivalDate>2017-12-01</ArrivalDate> <Nights>1</Nights> <BoardBasis>RO</BoardBasis> <NonSmoking>N</NonSmoking> <ReturnFlight/> <TerminalCode/> <Code>LHRMEA</Code> <Name>Mercure</Name> <ParkingDays>0</ParkingDays> <ParkingSpaces>0</ParkingSpaces> </Itinerary> <Room> <Adults>2</Adults> <Children>0</Children> <Infants>0</Infants> <Code>DBL</Code> </Room> <CarDetails> <Registration/> <CarMake/> <CarModel/> <CarColour/> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Email>test@test.com</Email> <Address/> <Town/> <County/> <Postcode/> <EvePhone/> </ClientDetails> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <Nights>1</Nights> <RoomCode>DBL</RoomCode> <ParkingDays>0</ParkingDays> <Adults>2</Adults> <Children>0</Children> <Title>Mr</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address >1 Test Street</Address > <Town>Testville</Town> <County>Testshire</County> <Postcode>TE1 STS</Postcode> <DayPhone>01234567890</DayPhone> <Email>test@test.com</Email> <DataProtection>N</DataProtection> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>55.00</PriceCheckPrice> <v>1</v> </Request> </API_Header></API_Reply>European Hotel BookingRequesthttps://api.holidayextras.com/v1/hotel/MUCLAN<Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <Nights>1</Nights> <RoomCode>DZ</RoomCode> <ParkingDays>0</ParkingDays> <Adults>2</Adults> <Children>0</Children> <Title>Mr</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address >1 Test Street</Address > <Town>Testville</Town> <County>Testshire</County> <Postcode>TE1 STS</Postcode> <DayPhone>01234567890</DayPhone> <Email>test@test.com</Email> <DataProtection>N</DataProtection> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>120.00</PriceCheckPrice> <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"4\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <MoreInfoURL>/v1/booking/YourBookingRef.de</MoreInfoURL> </Booking> <Hotel/> <Itinerary> <ArrivalDate>2017-12-01</ArrivalDate> <Nights>1</Nights> <BoardBasis>F</BoardBasis> <NonSmoking>N</NonSmoking> <ParkingDays>0</ParkingDays> <ParkingSpaces>0</ParkingSpaces> <Code>MUCLAN</Code> <Name>Schweigers Landgasthof</Name> </Itinerary> <Room> <Adults>2</Adults> <Children>0</Children> <Infants>0</Infants> <Code>DZ</Code> </Room> <ClientDetails> <Title>Herr</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Email>TEST@TEST.COM</Email> <Town>TESTVILLE</Town> <Postcode>TE1 STS</Postcode> <DayPhone>01234567890</DayPhone> <Remarks/> <Address0>1 Test Street</Address0> <Address1>TBC</Address1> <DataProtection>N</DataProtection> <County>TESTSHIRE</County> </ClientDetails> <Pricing> <Price>120.00</Price> </Pricing> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <Nights>1</Nights> <RoomCode>DBL</RoomCode> <ParkingDays>0</ParkingDays> <Adults>2</Adults> <Children>0</Children> <Title>Mr</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address0>1 Test Street</Address0> <Town>Testville</Town> <County>Testshire</County> <Postcode>TE1 STS</Postcode> <DayPhone>01234567890</DayPhone> <Email>test@test.com</Email> <DataProtection>N</DataProtection> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>120.00</PriceCheckPrice> <System>ABG</System> <lang>de</lang> <v>1</v> </Request> </API_Header></API_Reply>UK Hotel booking with UpgradesRequesthttps://api.holidayextras.com/v1/hotel/LGWSOF<Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-11-10</ArrivalDate> <Nights>1</Nights> <RoomCode>DBL</RoomCode> <ParkingDays>0</ParkingDays> <Adults>2</Adults> <Children>0</Children> <Title>Mr</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address >1 Test Street</Address > <Town>Testville</Town> <County>Testshire</County> <Postcode>TE1 STS</Postcode> <DayPhone>01234567890</DayPhone> <Email>test@test.com</Email> <DataProtection>N</DataProtection> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>135.00</PriceCheckPrice> <Supplements> <Code>LGWSOE</Code> <Date>2020-11-10</Date> <Quantity>1</Quantity> </Adults> </Children> <TotalPrice>40.00</TotalPrice> </Supplements> <Supplements> <Code>LGWASC</Code> <Date>2020-11-11</Date> <LoungeArrival>2020-11-11 12:30</LoungeArrival> </Quantity> <Adults>2</Adults> <Children>0</Children> <TotalPrice>56.00</TotalPrice> </Supplements> <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>13.45</AgentComm> <VATonComm>0.00</VATonComm> <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL> </Booking> <Hotel/> <Itinerary> <TotalPrice>255.55</TotalPrice> <ArrivalDate>2020-11-10</ArrivalDate> <Nights>1</Nights> <BoardBasis>RO</BoardBasis> <NonSmoking>N</NonSmoking> <ReturnFlight/> <TerminalCode/> <Code>LGWSOF</Code> <Name>Sofitel</Name> <ParkingDays>0</ParkingDays> <ParkingSpaces>0</ParkingSpaces> </Itinerary> <Room> <Adults>2</Adults> <Children>0</Children> <Infants>0</Infants> <Code>DBL</Code> </Room> <CarDetails> <Registration/> <CarMake/> <CarModel/> <CarColour/> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Email>test@test.com</Email> <Address/> <Town/> <County/> <Postcode/> <EvePhone>01234567890</EvePhone> </ClientDetails> <CurrentSupplements> <Code>LGWSOE</Code> <Name>Luxury room upgrade</Name> <Price>66.50</Price> <NonDiscPrice>66.50</NonDiscPrice> <Per>room</Per> <Adults>0</Adults> <Children>0</Children> <Date>2020-11-10</Date> <Remarks/> <Canx>Y</Canx> </CurrentSupplements> <CurrentSupplements> <Code>LGWASC</Code> <Name>Club Aspire North Lounge</Name> <Price>47.50</Price> <NonDiscPrice>47.50</NonDiscPrice> <Per>person</Per> <Adults>2</Adults> <Children>0</Children> <Date>2020-11-11</Date> <Remarks/> <Canx>Y</Canx> </CurrentSupplements> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-11-10</ArrivalDate> <ArrivalTime>12:30</ArrivalTime> <Title>Mr</Title> <Initial>T</Initial> <Surname>Test</Surname> <Address>Holiday Extras Ltd</Address> <Address>Ashford Road</Address> <Town>Hythe</Town> <County>Kent</County> <PostCode>CT214JF</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>135.00</PriceCheckPrice> <Adults>2</Adults> <Children>0</Children> <Nights>1</Nights> <RoomCode>DBL</RoomCode> <ParkingDays>0</ParkingDays> <Supplements> <Code>LGWSOE</Code> <Date>2020-11-10</Date> <Quantity>1</Quantity> <TotalPrice>70.00</TotalPrice> </Supplements> <Supplements> <Code>LGWASC</Code> <Date>2020-11-11</Date> <Adults>2</Adults> <Children>0</Children> <TotalPrice>56.00</TotalPrice> </Supplements> <v>1</v> </Request> </API_Header></API_Reply>", @@ -134,6 +120,20 @@ } , + "hxapi-parking-bkg": { + "title": "Book Car Park", + "content": "Book Car ParkAPI Docs > product:Parking > endpoint:carpark > Make BookingCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/CarParkCodeFor example, for Maple Manor Meet and Greet at London Gatwick North terminal the endpoint is:https://api.holidayextras.com/v1/carpark/LGW4Request ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up. Address[] String [A-Z0-9] 25 chars Y First line of address (house name / number and road) of lead passenger If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.NB: This field can be set to NA ArrivalDate Date YYYY-MM-DD Y Date customer drops vehicle at car park. ArrivalTime Time HHMM Y Time customer drops vehicle at car park. County String [A-Z] 20 chars Y County of address NB: This field can be set to NA CustomerRef String [A-Z0-9] 20 chars N A unique reference code associated with the customer’s booking for tracking and reference purposes. DepartDate Date YYYY-MM-DD Y Date customer picks up vehicle from car park. DepartTime Time HHMM Y Time customer picks up vehicle from car park. Email String [A-Z0-9] 50 chars Y Email of lead passenger Initial String [A-Z] 1 chars Y Initial of lead passenger Initials String [A-Z] 3 chars N The initials of the Operator / Agent. key String [A-Z] Y This will be assigned to you by your Account Manager during set up. NumberOfPax Integer [0-9] 2 chars Y Number of passengers. Password String [A-Z0-9] 5 chars N* Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. PostCode String [A-Z0-9] 10 chars Y Post code of address NB: This field can be set to NA PriceCheckFlag String Y Y Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving. If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount. You should then resubmit the request changing the PriceCheckPrice with the new price. PriceCheckPrice Float [0-9] Y Price of the product, received from the availability request or price check. Surname String [A-Z] 20 chars Y Surname of lead passenger System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only). Title String [A-Z] 4 chars Y Title of lead passenger, an option from the list of valid titles token String [0-9] 9 chars Y This is the same token used in the availability request. Town String [A-Z] 20 chars Y Town of address NB: This field can be set to NA lang String [A-Z] 2 chars Y* For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.) Supplements/Code String [A-Z0-9] 5 chars N Product code of the upgrade to book. See below for more info on booking upgrades Supplements/Date String YYYY-MM-DD Y The date to book the upgrade for. This should be brought forward from the upgrade availability request. Supplements/Quantity Integer [0-9]1 char Y* For per room/booking upgrades, specify the required quantity Supplements/Adults Integer [0-9]1 char Y* For per person upgrades, specify the number of adult passes Supplements/Children Integer [0-9]1 char Y* For per person upgrades, specify the number of child passes Supplements/TotalPrice Float [0-9] Y Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity Supplements/LoungeArrival String YYYY-MM-DD HH:mm Y* Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/carpark/STN5 HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows; Per Room or per Booking - Quantity x Price Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.UK ProductsThe <RequestFlags> field dictates which fields need to be sent as part of the booking request.European ProductsThe availability response will return a list of 18 flags in the <CarDetFlags> field with a yes/no response to indicate if required. The order of the flags is always the same.PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below: Field Additional Information Booking/BookingRef This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). Booking/AgentComm Commission you have earned from this booking. CarDetails Confirmation of the vehicle details that were sent in the booking request. CarDetails/Registration   CarDetails/CarMake   CarDetails/CarModel   CarDetails/CarColour   CarDetails/OutFlight   CarDetails/Destination   CarDetails/MobileNum   ClientDetails Confirmation of the lead passenger’s details that were sent in the booking request. ClientDetails/Title   ClientDetails/Initials   ClientDetails/Surname   ClientDetails/Email   HandlingFee Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero. MoreInfoURL The URL for viewing the booking. See view booking for more details. CarPark Details of the car park that were sent in the booking request. CarPark/ArrivalDate   CarPark/DepartDate   CarPark/ArrivalTime   CarPark/DepartTime   CarPark/Duration   CarPark/NumberOfPax   CarPark/ReturnFlight   CarPark/Code   CarPark/TotalPrice   CarPark/Name   CarPark/introduction Production description text CarPark/logo Product logo. Prepend with https: CarPark/RequiresQRCode Whether the QR Code needs to be used for this carpark, instead of the barcode CarPark/BookingUrl Prepend with https://api.holidayextras.com/ CarPark/MoreInfoUrl Prepend with https://api.holidayextras.com/ BarCode URL to the barcode for the booking. Prepend with https://api.holidayextras.com/ QRCode URL to the QR code for the booking. Prepend with https://api.holidayextras.com/ QRCodeValue (EU only) Value of the QR code that comes with email confirmation. More details about QR Code QRCodeValueStr (EU only) Value of the QR code that comes with email confirmation, when returning as part of a JSON resposne this value will be a string. More details about QR Code FastTrackVouchers/Name Only present if Fast track products have been purchased - Name used to separate multiple voucher products FastTrackVouchers/Source Link to the voucher document to be embeded in the client email FastTrackVouchers/type Content type qualifier for the Source Booking/Status (Future) Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error). Booking/SuggestedPollingInterval (Future) Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.) CurrentSupplements/Code Upgrade Code CurrentSupplements/Name Name of the upgrade CurrentSupplements/Price Price Paid for the upgrade CurrentSupplements/NonDiscPrice The original price of the upgrade before any discounts CurrentSupplements/Per The pricing basis for the product (booking/room/person) CurrentSupplements/Adults The number of adult passes purchased CurrentSupplements/Children The number of child passes purchased CurrentSupplements/Date The date the upgrade has been purchased for CurrentSupplements/Remarks Internal notes CurrentSupplements/Canx Whether the upgrade can be cancelled API_Header/Request A list of parameters that were sent in the booking request. Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking car parking.UK Products BookingRequesthttps://api.holidayextras.com/carpark/LGW4<Request> <ABTANumber>YourABTA</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>57.99</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Destination>Munich</Destination> <OutFlight>EZY8985</OutFlight> <OutTerminal>N</OutTerminal> <Registration>TE17 STS</Registration> <ReturnFlight>EZY8982</ReturnFlight> <ReturnTerminal>N</ReturnTerminal> <MobileNum>01234567890</MobileNum></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>7.25</AgentComm> <VATonComm>0.00</VATonComm> </Booking> <CarDetails> <Registration>TE17 STS</Registration> <CarMake>RANGE ROVER</CarMake> <CarModel>EVOQUE</CarModel> <CarColour>WHITE</CarColour> <OutFlight>EZY8985</OutFlight> <Destination>MUNICH</Destination> <MobileNum/> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Email>test@test.com</Email> </ClientDetails> <HandlingFee>0.00</HandlingFee> <MoreInfoURL>/booking/YourBookingRef</MoreInfoURL> <CarPark> <ArrivalDate>2017-12-01</ArrivalDate> <DepartDate>2017-12-08</DepartDate> <ArrivalTime>1200</ArrivalTime> <DepartTime>1200</DepartTime> <Duration>7</Duration> <NumberOfPax>1</NumberOfPax> <ReturnFlight>EZY8982</ReturnFlight> <Code>LGW4</Code> <TotalPrice>57.99</TotalPrice> <Name>Maple Manor Meet and Greet North</Name> <introduction>With 20 years' experience in providing a great service, Maple Manor Meet and Greet parking is a firm favourite with our customers and it's easy to see why. One of their professional, insured chauffeurs will meet you at the North terminal and park your car for you in a secured car park while you catch your flight. It couldn't be simpler and all for this low price. We only sell airport-approved Meet and Greet services and Maple Manor is no exception.</introduction> <advance_purchase>1</advance_purchase> <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/LGW4_LGV0_LGT9_LGY8_thumbnail_logo.png</logo> <BookingURL>/carpark/LGW4</BookingURL> <MoreInfoURL>/product/LGW4</MoreInfoURL> </CarPark> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>57.99</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Registration>TE17 STS</Registration> <Destination>Munich</Destination> <OutFlight>EZY8985</OutFlight> <OutTerminal>N</OutTerminal> <ReturnFlight>EZY8982</ReturnFlight> <ReturnTerminal>N</ReturnTerminal> <MobileNum>01234567890</MobileNum> </Request> </API_Header></API_Reply>European Products BookingRequesthttps://api.holidayextras.com/carpark/MU01<Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>HERR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>35.00</PriceCheckPrice> <System>ABG</System> <OutFltNo>EZY8982</OutFltNo> <InFltNo>EZY8985</InFltNo> <InFltTime>1130</InFltTime></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"4\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>3.75</AgentComm> <VATonComm>0.00</VATonComm> </Booking> <MoreInfoURL>/carpark/YourBookingRef.de</MoreInfoURL> <CarPark> <ArrivalDate>2017-12-01</ArrivalDate> <DepartDate>2017-12-08</DepartDate> <ArrivalTime>1200</ArrivalTime> <DepartTime>1200</DepartTime> <Duration>7</Duration> <NumberOfPax>1</NumberOfPax> <ReturnFlight/> <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags> <Code>MU01</Code> <Name>Parkservice Sky München</Name> <BookingURL>/carpark/MU01.de</BookingURL> <MoreInfoURL>/product/MU01.de</MoreInfoURL> <TotalPrice>35.00</TotalPrice> <GatePrice>0.00</GatePrice> </CarPark> <BarCode>/barcode/YourBookingRef.png?key=YourKey</BarCode> <ClientDetails> <Title>HERR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Email>TEST@TEST.COM</Email> <Town>TESTVILLE</Town> <Postcode>TE12 3ST</Postcode> <DayPhone>TBC</DayPhone> <Remarks/> <Address0>123 TEST STREET</Address0> <DataProtection>Y</DataProtection> <County>TESTSHIRE</County> <Confirmation>Y</Confirmation> </ClientDetails> <Pricing> <TotalPrice>35.00</TotalPrice> </Pricing> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>HERR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>35.00</PriceCheckPrice> <System>ABG</System> <OutFltNo>EZY8982</OutFltNo> <InFltNo>EZY8985</InFltNo> <InFltTime>1130</InFltTime> </Request> </API_Header></API_Reply>UK Product booking With UpgradesRequesthttps://api.holidayextras.com/carpark/STN5<Request> <ABTANumber>YourABTA</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-11-08</ArrivalDate> <ArrivalTime>1230</ArrivalTime> <ArrivalDate>2020-11-06</ArrivalDate> <DepartTime>1345</DepartTime> <NumberOfPax>1</NumberOfPax> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>57.99</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Destination>Munich</Destination> <OutFlight>EZY8985</OutFlight> <OutTerminal>N</OutTerminal> <Registration>TE17 STS</Registration> <ReturnFlight>EZY8982</ReturnFlight> <ReturnTerminal>N</ReturnTerminal> <MobileNum>01234567890</MobileNum> <Supplements> <Code>HXOST1</Code> <Date>2020-11-08</Date> <Quantity>1</Quantity> </Adults> </Children> <TotalPrice>1.99</TotalPrice> </Supplements> <Supplements> <Code>STNSFS</Code> <Date>2020-11-08</Date> </Quantity> <Adults>2</Adults> <Children>1</Children> <TotalPrice>15.00</TotalPrice> </Supplements></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>3.75</AgentComm> <VATonComm>0.00</VATonComm> </Booking> <CarDetails> <Registration>TE17 STS</Registration> <CarMake>RANGE ROVER</CarMake> <CarModel>EVOQUE</CarModel> <CarColour>WHITE</CarColour> <OutFlight/> <Destination>-</Destination> <MobileNum>01234567890</MobileNum> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>Test</Surname> <Email>test@test.com</Email> </ClientDetails> <HandlingFee>0.00</HandlingFee> <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL> <CarPark> <ArrivalDate>2020-11-08</ArrivalDate> <DepartDate>2020-11-16</DepartDate> <ArrivalTime>1230</ArrivalTime> <DepartTime>1345</DepartTime> <Duration>8</Duration> <NumberOfPax>1</NumberOfPax> <ReturnFlight>VIR19</ReturnFlight> <Code>STN5</Code> <TotalPrice>49.99</TotalPrice> <Name>Long Stay</Name> <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction> <advance_purchase>1</advance_purchase> <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/85730-official-stansted-airport-parking-long-stay.png</logo> <RequiresQRCode>0</RequiresQRCode> <BookingURL>/v1/carpark/STN5</BookingURL> <MoreInfoURL>/v1/product/STN5</MoreInfoURL> </CarPark> <BarCode>/v1/barcode/YourBookingRef.png?key=ONLIN</BarCode> <QRCode>/v1/qrcode/YourBookingRef.png?key=ONLIN</QRCode> <FastTrackVouchers> <name>Fast Track Voucher</name> <source>https://voucher.holidayextras.co.uk/voucher/fastTrack?email=YourEmail&amp;booking_ref=YourBookingRef&amp;agent=YourABTANumber&amp;productType=carparks&amp;productCode=STNSFS</source> <type>text/html</type> </FastTrackVouchers> <API_Header> <Request> <ABTANumber>YourABTANumber</ABTANumber> <Password>YourPassword</Password> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2020-11-08</ArrivalDate> <ArrivalTime>12:30</ArrivalTime> <DepartDate>2020-11-16</DepartDate> <DepartTime>13:45</DepartTime> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Address>123 Test Street</Address> <Town>Testville</Town> <County>Testshire</County> <PostCode>TE12 3ST</PostCode> <Email>test@test.com</Email> <PriceCheckFlag>Y</PriceCheckFlag> <PriceCheckPrice>50.05</PriceCheckPrice> <CarColour>White</CarColour> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <Registration>TE17 STS</Registration> <ReturnFlight>VIR19</ReturnFlight> <Supplement> <Code>HXOST1</Code> <Date>2017-12-01</Date> <Quantity>1</Quantity> </Supplement> <Supplement> <Code>STNSFS</Code> <Date>2017-12-01</Date> <Adults>2</Adults> <Children>1</Children> </Supplement> <v>1</v> </Request> </API_Header></API_Reply>", + "url": "/hxapi/parking/bkg/" + } + , + + "hxapi-de-start-bkg": { + "title": "Book Car Park - DE-Start method", + "content": "Book Car Park - DE-Start methodCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://payment.holidayextras.com/legacy/carpark/CarParkCodeRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive. Name Data Type Format Mandatory? Additional Information StartCustomer String [0-9] 6 chars Y This will be assigned to you by your Account Manager during set up. BusinessUnit String [0-9] 3 chars Y This will be assigned to you by your Account Manager during set up. Operator String [A-Z] 3 chars Y This always defaults to BJT. key String [A-Z] 10 chars Y This will be assigned to you by your Account Manager during set up. token String [0-9] 9 chars Y This is the same token used in the availability request. ArrivalDate Date YYYY-MM-DD Y Date customer drops vehicle at car park. ArrivalTime Time HHMM Y Time customer drops vehicle at car park. DepartDate Date YYYY-MM-DD Y Date customer picks up vehicle from car park. DepartTime Time HHMM Y Time customer picks up vehicle from car park. Registration String [A-Z0-9] 15 chars N § Vehicle registration number. CarMake String [A-Z0-9] 25 chars N § The make of the car, e.g Audi. CarModel String [A-Z0-9] 25 chars N § The model of the car, e.g. A6. CarColour String [A-Z] 25 chars N § The colour of the car, e.g. black. Title String [0-9] 4 chars Y Title of lead passenger. Initial String [A-Z] 1 chars Y Initial of lead passenger. Surname String [A-Z] 20 chars Y Surname of lead passenger. NumberOfPax Integer [0-9] 2 chars Y Number of passengers. Remarks String [A-Z0-9] 60 chars N Any remarks the agent wishes to add to the booking. Please note, these are not passed through to the supplier. NB: The fields required by the carpark are returned in the availability request, in the <RequestFlags> element.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.PaymentThis existing integration does support direct encashment from retail customers. For more information please see the section on Payment.Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below: Booking/BookingRef This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). Booking/AgentComm Commission you have earned from this booking. CarDetails Confirmation of the vehicle details that were sent in the booking request. ClientDetails Confirmation of the lead passenger’s details that were sent in the booking request. HandlingFee Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero. MoreInfoURL The URL for viewing the booking. CarPark Details of the car park that were sent in the booking request. API_Header/Request A list of parameters that were sent in the booking request. Worked ExamplesBelow are worked examples of both the request and response for booking car parking using the DE-Start method.Car Park Booking Request - DE-Start methodhttps://payment.holidayextras.com/legacy/carpark/FRA8 <Request> <StartCustomer>YourStartCustomer</StartCustomer> <BusinessUnit>YourBusinessUnit</BusinessUnit> <Operator>BJT</Operator> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Registration>TE17 STS</Registration> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <CarColour>White</CarColour> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Remarks>Car Park Test</Remarks> </Request>Car Park Booking Response - DE-Start method<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\"> <Booking> <BookingRef>YourBookingRef</BookingRef> <AgentComm>5.47-</AgentComm> <VATonComm>0.87-</VATonComm> <StartRef>YourStartRef</StartRef> </Booking> <CarDetails> <Registration>TE17 STS</Registration> </CarDetails> <ClientDetails> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <CustomerRef>N/A</CustomerRef> <Remarks>Car Park Test</Remarks> </ClientDetails> <API_Header> <Request> <StartCustomer>YourStartCustomer</StartCustomer> <BusinessUnit>YourBusinessUnit</BusinessUnit> <Operator>BJT</Operator> <Initials>YourInitials</Initials> <key>YourKey</key> <token>YourToken</token> <ArrivalDate>2017-12-01</ArrivalDate> <ArrivalTime>1200</ArrivalTime> <DepartDate>2017-12-08</DepartDate> <DepartTime>1200</DepartTime> <NumberOfPax>1</NumberOfPax> <Registration>TE17 STS</Registration> <CarMake>Range Rover</CarMake> <CarModel>Evoque</CarModel> <CarColour>White</CarColour> <Title>MR</Title> <Initial>T</Initial> <Surname>TEST</Surname> <Remarks>Car Park Test</Remarks> <debug>1</debug> <system>de</system> <System>ABG</System> </Request> </API_Header> <CarPark> <ArrivalDate>01DEC18</ArrivalDate> <DepartDate>08DEC18</DepartDate> <ArrivalTime>1200</ArrivalTime> <DepartTime>1200</DepartTime> <Duration>8</Duration> <NumberOfPax>1</NumberOfPax> <Code>FRA8</Code> <BookingURL>/api/carpark/FRA8/debug</BookingURL> <MoreInfoURL>/api/product/FRA8/debug</MoreInfoURL> </CarPark></API_Reply>", + "url": "/hxapi/de-start/bkg/" + } + , + "hxapi-bundles": { "title": "Bundles", "content": "BundlesSome results that are returned from availability on the API will be what we call bundles, these consist of a main product, such as a hotel, bundled together with an additional supplement, like a dinner.Bundles are currently only available on hotel searches.AvailabilityBundles can be identified by their product code, which has an additional element preceding the main product code joined by a +.E.g...<Name>Cresta Court with 2-course dinner</Name><Code>MANCCT+B519</Code><BookingURL>/v1/hotel/HPMANCCT+B519</BookingURL><Price>110.65</Price>...The price given will be for the entire bundle including the supplement with the current passenger quantity ( determined by the given room code ).A product library request can be made with the complete bundle product code to get content related to the package as a whole instead of simply the main product. E.g /v1/product/MANCCT+B519BookingThe BookingURL element will contain the full product code, including prefix, that must be supplied when a bundle is to be booked, this will ensure that system books the main product as well as the appropriate supplement. When booking a bundle on a hotel search the quantity of the supplement will be determined by the given room occupancy in the Adults and Children fields.The booking response for a bundle booking will show the main product and the booked supplement as seperate elements. The TotalPrice field will contain the full price of the booking, but the supplement price will also be shown separately under the CurrentSupplements block.E.g...<Booking><BookingRef>XXXXX</BookingRef><AgentComm>12.41</AgentComm><VATonComm>2.07</VATonComm><MoreInfoURL>/v1/booking/XXXXX</MoreInfoURL></Booking><Hotel/><Itinerary><TotalPrice>110.65</TotalPrice><ArrivalDate>2019-03-10</ArrivalDate><Nights>1</Nights><BoardBasis>RO</BoardBasis><NonSmoking>N</NonSmoking><ReturnFlight/><TerminalCode/><Code>MANCCT</Code><Name/><ParkingDays>0</ParkingDays><ParkingSpaces>0</ParkingSpaces></Itinerary><Room><Adults>2</Adults><Children>1</Children><Infants>0</Infants><Code>TRL</Code></Room><CurrentSupplements><Code>MANCDI</Code><Name>2-course dinner</Name><Price>29.90</Price><NonDiscPrice>29.90</NonDiscPrice><Per>person</Per><Adults>2</Adults><Children>1</Children><Date>2019-03-10</Date><Canx>Y</Canx><Remarks/></CurrentSupplements>...The product code of the supplement will also be returned in the booking response which can be used to retrieve product specific content in the product library request that can be displayed on booking confirmations. When creating confirmation emails be sure to highlight that the supplement has been added as a part of this booking.Post BookingA bundle booking can be amended or cancelled following the same rules as a general product. The supplement has a Canx field in the booking response that will define if that particular add-on can be cancelled as part of the booking. It is not currently possible to amend the quantity of the supplement or remove it from the booking using the API.", @@ -211,13 +211,6 @@ } , - "hxapi-viewamendcancel": { - "title": "Manage A Booking", - "content": "# Manage A Booking[API Docs](/hxapi/) > product:[viewamendcancel](index)## Manage A Booking EndpointsHere are the endpoints for managing a booking:| View booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](view) | GET || Amend booking - Simple | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_simple) | POST || Amend booking - Complex | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_complex) | POST || Cancel booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](cancel) | POST |## Manage A Booking Top TipsThe three methods provided will enable your customers via your integration to manage their own booking online.### Amending a bookingWe allow both simple and complex amends:- A ***simple amend*** is where the booking details are updated, without affecting the price. This is also known as an \"amend no re-price\". For example, adding a car registration number to a parking booking.- A ***complex amend*** is where the booking details are updated and this does affect the price. This is also known as an \"amend re-price\". For example, changing the date of a booking.", - "url": "/hxapi/viewamendcancel/" - } - , - "hxapi-fasttrack-av": { "title": "Availability At FastTrack", "content": "# Availability At FastTrack## FastTrack Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/fasttrack/AirportCode```For example, for fasttrack availability at Manchester the endpoint is:```https://api.holidayextras.com/v1/fasttrack/MAN```To find the airport locations available for fasttrack, please refer to the [locations endpoint.](/hxapi/locations)### Request ParametersNB: All parameter names are case sensitive.| Name | Data Type | Format | Mandatory? | Additional Information ||-------------|-----------|------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | Y* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token. || ArrivalDate | Date | YYYY-MM-DD | Y | Date customer enters the fasttrack. || ArrivalTime | Time | HHMM | Y | Time customer enters the fasttrack. || Adults | Integer | [0-4] 1 char | Y | Number of adults requiring entry to the fasttrack. || Children | Integer | [0-3] 1 char | N | Number of children requiring entry to the fasttrack. || OutFlight | String | [A-Z0-9] 9 chars | N | This is also known as an 'flight number'. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal. |## FastTrack Availability ResponseThe fasttrack availability response will return the specific product requested, so long as it has availability on the specific dates and times. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field | Additional Information ||----------------------------|-------------------------------------------------------------------------------------------------------------|| FastTrack/Name | The name of the fasttrack. || FastTrack/Code | The product code for the fasttrack, which must be used in the booking request. || FastTrack/BookingURL | The URL to POST the booking request to for this particular product. || FastTrack/MoreInfoURL | The link to more information about this product, sourced from the Product Library. || FastTrack/Price | The price of product _without_ any surcharges/fees added. || FastTrack/NonDiscPrice | The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison. || FastTrack/SalesCurrency | Three character identifier for the sale currency to qualify the price || FastTrack/Images/Src | Link to a image for the product. Prepend with `https:` || FastTrack/Description | Product description || FastTrack/Logo | Link to a logo for the product. Prepend with `https:` || FastTrack/ExtraInformation | Extended description of the product || IsRefundable | Whether the product can be refunded || AirportLocation | The location name for the product airport || Location | Extended location information for the airport including a list of all terminals on site || Terminal | The airport terminal of the product |## Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.### UK Products Availability Request```https://api.holidayextras.com/v1/fasttrack/MAN/?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2019-10-22&ArrivalTime=1200&Adults=2&Children=0```### UK Products Availability Response ```xml FastTrack Terminal 1 APMANSF1 /v1/fastTrack/APMANSF1 /v1/product/MANSF1 10.00 GBP //d1xcii4rs5n6co.cloudfront.net/libraryimages/85558-manchester-airport-security-fasttrack-T1.png Short on time? Take the fast track through security and you’ll fly through. //d1xcii4rs5n6co.cloudfront.net/libraryimages/81386-MAN-fasttrack-core.png What is it? The Security FastTrack pass gives you access to the priority lane at the airport’s security checks. You’ll whizz past the standard queue, giving you more time to relax in departures before your flight. Once you book we’ll email you the passes, so make sure you print them and take them with you, or have them ready on your mobile phone. There’ll be a voucher each with a barcode, which you’ll need to scan at the entrance before you go through. When can I use it? Available 2.30am - 11pm. Is it the same price for children? Yes, the pass is £5 per person. The small print: You won't need this service if you have mobility issues or small children with pushchairs as there's already a dedicated lane. Jet 2 passengers who have purchased FastTrack tickets must use the security lanes located on Departure level 5, in Terminal 1. Security FastTrack tickets can only be used once for the date you have booked. If you have booked more than one ticket the vouchers will all be in the lead passenger’s name. All FastTrack's terms and conditions will apply to you, so please read them here. 0 0 0 0 1000 0 0 0 0 1000 MAN Manchester airport 1 1 2 2 3 3 1 //d1xcii4rs5n6co.cloudfront.net/libraryimages/fasttrack.jpg With this special, VIP pass through security, you could be the first through the gate. We'll give you one voucher for all passengers, so make sure you hold the square, patterned barcode on your own voucher under the special camera at the entrance before you go through. You’ll then need to do the same with your boarding pass. You can only use the Fast Track once, on the day you’ve booked. Even though Fast Track customers get their own lane through security, all the normal airport security rules will still apply. Since the airport already has its own special lanes for customers with mobility issues or those with small children, they won't need to use this service. Jet 2 customers who have purchased Fast Track tickets must use the security lanes located on Departure level 5 in Terminal 1. Please ensure you have read the Airport's Terms and Conditions. Manchester 1 10.00 1 FastTrack Terminal 2 APMANSF2 /v1/fastTrack/APMANSF2 /v1/product/MANSF2 10.00 GBP //d1xcii4rs5n6co.cloudfront.net/libraryimages/85558-manchester-airport-security-fasttrack-T2.png Short on time? Take the fast track through security and you’ll fly through. //d1xcii4rs5n6co.cloudfront.net/libraryimages/81386-MAN-fasttrack-core.png <h2> What is it?</h2> <p>The Security FastTrack pass gives you access to the priority lane at the airport’s security checks. You’ll whizz past the standard queue, giving you more time to relax in departures before your flight. </p> <p> Once you book we’ll email you the passes, so make sure you print them and take them with you. There’ll be a voucher each with a barcode, which you’ll need to scan at the entrance before you go through. </p> <h2>When can I use it?</h2> <p>Available 2.30am - 11pm.</p> <h2> Is it the same price for children?</h2> <p>Yes, the pass is £5 per person.</p> <h2>The small print:</h2> <p>You won't need this service if you have mobility issues or small children with pushchairs as there's already a dedicated lane.</p><p>Security FastTrack tickets can only be used once for the date you have booked.</p> <p> If you have booked more than one ticket the vouchers will all be in the lead passenger’s name.</p> <p>All FastTrack's terms and conditions will apply to you, so please read them <a href=\"http://www.manchesterairport.co.uk/terms-and-conditions/fasttrack/\" target=\"_blank\">here.</a></p> 0 0 0 0 1000 0 0 0 0 1000 MAN Manchester airport 1 1 2 2 3 3 1 //d1xcii4rs5n6co.cloudfront.net/libraryimages/fasttrack.jpg With this special, VIP pass through security, you could be the first through the gate. We'll give you one voucher for all passengers, so make sure you hold the square, patterned barcode on your own voucher under the special camera at the entrance before you go through. You’ll then need to do the same with your boarding pass. You can only use the Fast Track once, on the day you’ve booked. Even though Fast Track customers get their own lane through security, all the normal airport security rules will still apply. Since the airport already has its own special lanes for customers with mobility issues or those with small children, they won't need to use this service. Jet 2 customers who have purchased Fast Track tickets must use the security lanes located on Departure level 5 in Terminal 1. Please ensure you have read the Airport's Terms and Conditions. Manchester 2 10.00 1 FastTrack Terminal 3 APMANSF3 /v1/fastTrack/APMANSF3 /v1/product/MANSF3 10.00 GBP //d1xcii4rs5n6co.cloudfront.net/libraryimages/85558-manchester-airport-security-fasttrack-T3.png Short on time? Take the fast track through security and you’ll fly through. //d1xcii4rs5n6co.cloudfront.net/libraryimages/81386-MAN-fasttrack-core.png <h2> What is it?</h2> <p>The Security FastTrack pass gives you access to the priority lane at the airport’s security checks. You’ll whizz past the standard queue, giving you more time to relax in departures before your flight. </p> <p> Once you book we’ll email you the passes, so make sure you print them and take them with you. There’ll be a voucher each with a barcode, which you’ll need to scan at the entrance before you go through. </p> <h2>When can I use it?</h2> <p>Available 2.30am - 11pm.</p> <h2> Is it the same price for children?</h2> <p>Yes, the pass is £5 per person.</p> <h2>The small print:</h2> <p>You won't need this service if you have mobility issues or small children with pushchairs as there's already a dedicated lane.</p> <p>Security FastTrack tickets can only be used once for the date you have booked.</p> <p> If you have booked more than one ticket the vouchers will all be in the lead passenger’s name.</p> <p>All FastTrack's terms and conditions will apply to you, so please read them <a href=\"http://www.manchesterairport.co.uk/terms-and-conditions/fasttrack/\" target=\"_blank\">here.</a></p> 0 0 0 0 1000 0 0 0 0 1000 MAN Manchester airport 1 1 2 2 3 3 1 //d1xcii4rs5n6co.cloudfront.net/libraryimages/fasttrack.jpg With this special, VIP pass through security, you could be the first through the gate. We'll give you one voucher for all passengers, so make sure you hold the square, patterned barcode on your own voucher under the special camera at the entrance before you go through. You’ll then need to do the same with your boarding pass. You can only use the Fast Track once, on the day you’ve booked. Even though Fast Track customers get their own lane through security, all the normal airport security rules will still apply. Since the airport already has its own special lanes for customers with mobility issues or those with small children, they won't need to use this service. Jet 2 customers who have purchased Fast Track tickets must use the security lanes located on Departure level 5 in Terminal 1. Please ensure you have read the Airport's Terms and Conditions. Manchester 3 10.00 1 0.00 0.00 0.00 0.00 0.00 0.00 TESTX Redacted partnerapitest generate 2019-10-22 1200 0 2 1 ```", @@ -232,6 +225,41 @@ } , + "hxapi-viewamendcancel": { + "title": "Manage A Booking", + "content": "# Manage A Booking[API Docs](/hxapi/) > product:[viewamendcancel](index)## Manage A Booking EndpointsHere are the endpoints for managing a booking:| View booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](view) | GET || Amend booking - Simple | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_simple) | POST || Amend booking - Complex | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_complex) | POST || Cancel booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](cancel) | POST |## Manage A Booking Top TipsThe three methods provided will enable your customers via your integration to manage their own booking online.### Amending a bookingWe allow both simple and complex amends:- A ***simple amend*** is where the booking details are updated, without affecting the price. This is also known as an \"amend no re-price\". For example, adding a car registration number to a parking booking.- A ***complex amend*** is where the booking details are updated and this does affect the price. This is also known as an \"amend re-price\". For example, changing the date of a booking.", + "url": "/hxapi/viewamendcancel/" + } + , + + "hxapi-hotel-av": { + "title": "Hotel Availability Request", + "content": "## Hotel Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/LocationCode```For example, for London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHR```If you know the specific hotel code, then you can request availability by entering that into the endpoint. For example, for the Hilton at London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRHIL```To find the airport locations available for hotels, please refer to the [locations endpoint.](/hxapi/locations)### Request ParametersNB: All parameter names are case sensitive.| Name | Data Type | Format | Mandatory? | Additional Information ||----------------|-----------|-----------------------------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | Y* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token. || ArrivalDate | Date | YYYY-MM-DD | Y | Date customer arrives at hotel. || Nights | Integer | 1 | Y | Number of nights the customer wants to stay in the hotel. NB: It is only possible to book one night stays. || RoomType | String | [A-Z0-9] 3 chars | Y | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes. || SecondRoomType | String | [A-Z0-9] 3 chars | N* | NB: This feature is only available in the UK. This parameter is mandatory if the customer wishes to book two rooms at the same time. (Max 2 rooms) The room codes are as per RoomType. || ParkingDays | Integer | [0-9] 2 chars | Y | NB: The maximum duration accepted for ParkingDays is 30. || System | String | [A-Z] 3 chars | Y* | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only). || lang | String | [A-Z] 2 chars | Y* | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.) || Terminal | String | [A-Z1-9] 1 char | N | An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the [Terminal](/hxapi/terminal) request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). || fields | String | [A-Z] a csv list of product info fields | N | A list of product info fields can be passed in to return configurable product information e.g. `fields=name,address,latitude,sellingpoint`. |## Hotel Availability ResponseFor a detailed explanation of the fields returned, please see below:| Field | Additional Information ||------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Hotel/Name | The name of the product || Hotel/Code | The product code || Hotel/BookingURL | The URL to POST the booking request to for this particular product. || Hotel/MoreInfoURL | The link to more information about this product, sourced from the Product Library. || Hotel/RequestFlags | These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request. Flags are only returned when required. The flags which can be returned are: `Registration`, `CarMake`, `CarModel`, `CarColour`, `OutFlight`, `ReturnFlight`, `OutTerminal`, `ReturnTerminal`, `Destination`, `MobileNum` || Hotel/Price | The price of product without any surcharges/fees added. || Hotel/PriceWithSurcharge | *NB: Please ignore this field - we no longer accept new agents sending payment details via our API.* || Hotel/Adults* | The maximum number of adults included in the room occupancy. || Hotel/Children* | The maximum number of children included in the room occupancy. || Hotel/RoomCode | *NB: Please ignore this field as it relates to internal systems.* || Hotel/BoardBasis | *NB: Please ignore this field as it is no longer used and will be deprecated in future versions of the API.* || Hotel/ParkingDays | This returns the number of days parking available. NB: This may differ from the value requested, due to parking packages usually being set up in the system as either 4, 8 or 15 days. || Hotel/NonDiscPrice | The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison. || Hotel/CancellationFeeExceptions | If the hotel has non-standard cancellation fees. || Hotel/AmendmentFeeExceptions | If the hotel has non-standard amendment fees. || Hotel/noncancellable_nonrefundable | Is this hotel noncancellable or non-refundable? || Hotel/parking_includes_arrival | If parking during the customer's hotel stay included in their parking package || Hotel/CarPark | If your request included car parking, this is the car park code. || Hotel/Filter | *NB: Please ignore this field as it is for internal use only.* || Hotel/lead_time_cancellation | This is the number of days before the booking starts that the product will switch from flexible to non-flexible. || API_Header/Request | The API returns every parameter and value you sent in the previous request. | \\* Where two rooms have been requested, these fields represent the total of adults and children across all rooms. Additional fields will show the individual room occupancy: `FirstRoomAdults`, `FirstRoomChildren`, `SecondRoomAdults` and `SecondRoomChildren`.## Key Information on HotelsPlease read this section through carefully, as it contains useful information about restrictions on how hotels must be sold.### Advance purchaseAdvance purchase products are non-refundable and non-cancellable. As a result, Cancellation Waiver must *not* be sold to customers purchasing a product with `advance_purchase` set to 1.### Day Use OnlyThere is a field in the product library for hotels, named `day_use_only`. Day use products must not be sold to customers wishing to have an overnight stay where `day_use_only` is set to 1.### Parking Includes ArrivalIn order to establish whether the package includes parking for the night of the hotel stay the `parking_includes_arrival` field needs to be taken into account.Where this field is set to 0, this means the night of the hotel stay is not included as there is free overnight parking. Parking stay will start from the following day. Where it is set to 1, this means that parking starts from the date the customer checks into the hotel.### Mystery / Un-named ProductsThere are some hotels in which the name field will not provide the name of the hotel e.g `Mystery 4-star hotel`. The name of these hotels should not be provided to the customer until the booking is made, along with other identifying details such as address, hotel images, restaurant names etc.### Lead time cancellationFlexible bookings become non flexible within a certain timeframe before the stay date ie booking turns non flexible within 30 days of stay.Scenario 1* Flexible booking made outside 60 days of stay.* Cancellation policy - only able to canx up to 30 days before stay date.* Booking is non flex within 30 days of stay date.Scenario 2* Flexible booking made inside 60 days of stay date.* Cancellation policy - only able to canx up to 3 days before stay date.* Booking is non flex within 3 days of stay date.## Worked ExamplesBelow are worked examples of both the requests and responses for hotel availability.### UK Hotel Availability Request - Room Only (zero days parking)```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=0```### UK Hotel Availability Response - Room Only (zero days parking)NB: This is a shortened example compiled from a full availability response.```xml Mercure LHRMEA /v1/hotel/HPLHRMEA /v1/product/LHRMEA 1 45.00 45.90 2 1 TRL RO 0 45.00 30 1 1 1 Thistle T5 LHRPAA /v1/hotel/HPLHRPAA /v1/product/LHRPAA 85.50 87.21 2 1 TRL RO 0 85.50 30 1 0 1 Hilton T5 LHRHLT /v1/hotel/HPLHRHLT /v1/product/LHRHLT 1 1 1 99.00 100.98 2 1 TRL RO 0 99.00 2.00 0.00 4.00 0.00 0.00 0.00 2.99 YourABTANumber YourPassword YourKey YourToken 2017-12-01 1 T21 0 1 ```### UK Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=8```### UK Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml Mercure with Purple Parking Meet and Greet LHRMPU /v1/hotel/HPLHRMPU /v1/product/LHRMPU 1 1 1 1 1 1 1 129.00 131.58 2 1 TRL RO 8 129.00 LHR5 LHR5 1 Thistle T5 with parking at the hotel and breakfast LHRPAT /v1/hotel/HPLHRPAT /v1/product/LHRPAT 130.00 132.60 2 1 TRL RO 8 130.00 1 1 0 Sheraton Skyline with parking at the hotel LHRSKA /v1/hotel/HPLHRSKA /v1/product/LHRSKA 134.00 136.68 2 1 TRL RO 8 134.00 0 2.00 0.00 4.00 0.00 0.00 0.00 2.99 YourABTANumber YourPassword YourKey YourToken 2017-12-01 1 T21 8 1 ```### European Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/MUC?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=D20&ParkingDays=8&System=ABG&lang=de```### European Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml Schweigers Landgasthof MUCLAN /v1/hotel/FRMUCLAN /v1/product/MUCLAN 120.00 NaN 2 0 DZ F 15 120.00 Airporthotel Regent MUCREG /v1/hotel/FRMUCREG /v1/product/MUCREG 97.00 NaN 2 0 DZ F 15 97.00 NH München Airport MUCAST /v1/hotel/FRMUCAST /v1/product/MUCAST 113.00 NaN 2 0 DZ U 8 113.00 0.00 0.00 0.00 TESTG Redacted mytestkey generate 2017-12-01 1 D20 8 ABG de 1 ```", + "url": "/hxapi/hotel/av/" + } + , + + "hxapi-hotel": { + "title": "Hotels", + "content": "# Hotels[API Docs](/hxapi/) > product:[Hotels](index)## Hotel EndpointsHere are the hotel specific endpoints: | Action | Endpoint | Method | | ------ | -------- | ------ | | Availability at hotel | [https://api.holidayextras.com/v1/hotel/LocationCode](av) | GET | | Make booking at hotel | [https://api.holidayextras.com/v1/hotel/LocationCode](bkg) | POST | | Pre-booking price check | [https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck](priceCheck) | GET |Please note: All hotel requests include parking options of zero, 8 and 15 days parking. To make a request for a hotel only product, please select zero days parking.## Hotel User JourneyTo follow -", + "url": "/hxapi/hotel/" + } + , + + "hxapi-lounge": { + "title": "Lounge", + "content": "# LoungeHere are the lounge specific endpoints:| Request | Endpoint | Method || --- | --- | --- || Availability of lounges at airport | [https://api.holidayextras.com/v1/lounge/AirportCode](av/airport) | GET || Make booking for lounge | [https://api.holidayextras.com/v1/lounge/LoungeCode](bkg) | POST |", + "url": "/hxapi/lounge/" + } + , + + "hxapi-carhire": { + "title": "Car Hire", + "content": "# Car Hire[API Docs](/hxapi/) > product:[Car Hire](index)These are the car hire requests.| Action | Endpoint | Method || --- | --- | --- || Lookup Locations | [https://api.holidayextras.com/v1/carHire/locations](locations) | GET || Availability | [https://api.holidayextras.com/v1/carHire/products](availability) | GET || Make Booking | [https://api.holidayextras.com/v1/carHire/](booking/make) | POST || Lookup Booking | [https://api.holidayextras.com/v1/carHire-booking/](booking/lookup) | GET |", + "url": "/hxapi/carhire/" + } + , + "hxapi-parking-av": { "title": "Carpark Endpoint", "content": "# Carpark Endpoint[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av)## /carpark/LocationOrCarParkCodeWhere `LocationOrCarParkCode` can be the location (Airport, Port etc) or a specific car park product code.", @@ -246,10 +274,10 @@ } , - "hxapi-carhire": { - "title": "Car Hire", - "content": "# Car Hire[API Docs](/hxapi/) > product:[Car Hire](index)These are the car hire requests.| Action | Endpoint | Method || --- | --- | --- || Lookup Locations | [https://api.holidayextras.com/v1/carHire/locations](locations) | GET || Availability | [https://api.holidayextras.com/v1/carHire/products](availability) | GET || Make Booking | [https://api.holidayextras.com/v1/carHire/](booking/make) | POST || Lookup Booking | [https://api.holidayextras.com/v1/carHire-booking/](booking/lookup) | GET |", - "url": "/hxapi/carhire/" + "hxapi-upgrade": { + "title": "Product Upgrades", + "content": "# Product Upgrades[API Docs](/hxapi/) > [Product Upgrades](/hxapi/upgrade)## Upgrades Availability RequestUpgrades are currently only supported for parking, hotel and lounge bookings. Upgrades can be requested on a per product basis.#### MethodGET#### Endpoint/upgrade/{productCode}NB: Where `productCode` is the code of the base product i.e. the parking/hotel/lounge etc. product.```https://api.holidayextras.com/v1/upgrade/LGV4```## Request Parameters| Name | Data Type | Format | Mandatory? | Additional Information ||-------------|-----------|------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | Y* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token. || ArrivalDate | String | YYYY-MM-DD | Y | This should be the same as the `ArrivalDate` from the base product request. || ArrivalTime | Time | HHMM | Y | This should be the same as the `ArrivalTime` from the base product request. || DepartDate | Date | YYYY-MM-DD | N | This should be the same as the `DepartDate` from the base product request. || DepartTime | Time | HHMM | N | This should be the same as the `DepartTime` from the base product request. || Adults | Integer | [0-9] | Y* | Mandatory for Lounge upgrade requests. Number of adults in the party || Children | Integer | [0-9] | Y* | Mandatory for Lounge upgrade requests. Number of children in the party |## Upgrade Availability ResponseThe response will return a list of available upgrades.Upgrades are sold on a per booking, per person, or per room basis.Upgrades can be for the day before travel, day of departure or day of return.| Field | Additional Information ||--------------------|---------------------------------------------------------------------------------------------|| Code | Product code for the upgrade || Name | Name of the upgrade || Per | Pricing basis, either per *P*erson, per *B*ooking, per *R*oom || Canx | Whether the upgrade is cancellable (Y/N) || description | || supplement_type | Type classification for the upgrade || Date | Date the upgrade is to be booked for. Format YYYY-MM-DD || only_for_adults | Upgrades restricted to adult only parties e.g. Adult only lounges || Price | The price of the upgrade minus any discounts. Only present for per booking upgrades || NonDiscPrice | The total price of the upgrade before discounts. Only present for per booking upgrades || DiscAmt | The amount of any discount applied. Only present for per booking upgrades || AdPrice | The per adult price minus any discounts. Only present for per person upgrades || NonDiscAdPrice | The per adult price before any discounts. Only present for per person upgrades || AdDiscAmt | The amount of discount applied to the per adult price. Only present for per person upgrades || ChPrice | The per child price minus any discounts. Only present for per person upgrades || NonDiscChPrice | The per child price before any discounts. Only present for per person upgrades || ChDiscAmt | The amount of discount applied to the child price. Only present for per person upgrades || API_Header/Request | The API returns every parameter and value you sent in the request. |## Examples### Example 1 - Carpark Upgrades#### Request{% codetabs %} {% codetab XML %} ```https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45 ``` {% endcodetab %} {% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/STN5.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45``` {% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_1_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_1_response.json %}```{% endcodetab %}{% endcodetabs %}### Example 1 - Hotel Upgrades#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/LGWSOF.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_2_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_2_response.json %}```{% endcodetab %}{% endcodetabs %}", + "url": "/hxapi/upgrade/" } , @@ -260,6 +288,13 @@ } , + "hxapi-productlibrary": { + "title": "Product Library", + "content": "# Product LibraryThe data returned from a Product Library request depends on the type of product you ask for. A request for a car park returns different fields than a request for a hotel.By default, only fields that contain a value are returned.You can specify the fields you want returned. Simply add the parameter fields and specify the field names. An error/warning element will be returned for any fields which do not exist, but the request will still return those elements for which there is a value. If you request a valid field, but there is no value, it will not be returned.The purpose of most of the fields should be self-explanatory. If there is anything you do not understand, please email . There are no guarantees about the types of data returned, you should make no assumptions about a specific field being an integer etc.Data returned should not be cached locally for periods of time greater than one day (24 hours).### URL/product/{productCode}### MethodGET### Parameters| Name | Format | Required ||--------|--------|----------|| token | String | N || key | String | Y || fields | String | N |## Available FieldsThe available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.{% codetabs %}{% codetab Parking %}{% include_relative _parkingFields.md %}{% endcodetab %}{% codetab Hotel room only %}{% include_relative _hotelOnlyFields.md %}{% endcodetab %}{% codetab Hotel with parking %}{% include_relative _hotelParkingFields.md %}{% endcodetab %}{% codetab Lounge %}{% include_relative _loungeFields.md %}{% endcodetab %}{% codetab Fast track %}{% include_relative _fastTrackFields.md %}{% endcodetab %}{% endcodetabs %}---## Examples### Example 1 - Default Response#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_1.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_1.json %}```{% endcodetab %}{% endcodetabs %}---### Example 2 - Restricted field list#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_2.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_2.json %}```{% endcodetab %}{% endcodetabs %}---### Example 3 - German Parking Request#### RequestRequests for German products return a different set of fields. Explanation of fields not currently available.{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_3.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_3.json %}```{% endcodetab %}{% endcodetabs %}", + "url": "/hxapi/productlibrary/" + } + , + "hxapi-transfers-av": { "title": "Transfers Availability", "content": "# Transfers Availability## Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/search```Here is an example:```https://api.holidayextras.com/v1/transfers/search?token=[TOKEN]&key=[KEY]&ABTANumber=[ABTA]&FromDate=2020-08-01&FromTime=1000&ReturnDate=2020-08-07&ReturnTime=1730&PickUp=AGP&PickUpType=IATA&DropOff=85101062&DropOffType=TTI&OutFlight=U28605&ReturnFlight=U28602&Adults=2```### Request ParametersNB: All parameter names are case sensitive.| Name | Data Type | Format | Mandatory? | Additional Information ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | Y* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator/Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token. || PickUpType | String | [A-Z0-9] | Y | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`). || PickUp | String | [A-Z0-9] | Y* | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address` || PickUpName | String | [A-Z0-9] | Y [^1] | The pick up location name. || PickUpAddress[] | String | [A-Z0-9] | Y [^1] | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines. || PickUpTown | String | [A-Z0-9] | Y [^1] | The pick up town name. || PickUpCounty | String | [A-Z0-9] | Y [^1] | The pick up county name. || PickUpPostcode | String | [A-Z0-9] | Y [^1] | The pick up postcode. || PickUpCountryCode | String | [A-Z] 2 chars | Y [^1] | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format. || PickUpLongitude | Float | [0-9] | Y [^1] | The pick up location longitude. || PickUpLatitude | Float | [0-9] | Y [^1] | The pick up location latitude. || DropOffType | String | [A-Z0-9] | Y | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`). || DropOff | String | [A-Z0-9] | Y* | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address` || DropOffName | String | [A-Z0-9] | Y [^1] | The drop off location name. || DropOffAddress[] | String | [A-Z0-9] | Y [^1] | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines. || DropOffTown | String | [A-Z0-9] | Y [^1] | The drop off town name. || DropOffCounty | String | [A-Z0-9] | Y [^1] | The drop off county name. || DropOffPostcode | String | [A-Z0-9] | Y [^1] | The drop off postcode. || DropOffCountryCode | String | [A-Z] 2 chars | Y [^1] | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format. || DropOffLongitude | Float | [0-9] | Y [^1] | The drop off location longitude. || DropOffLatitude | Float | [0-9] | Y [^1] | The drop off location latitude. || FromDate | Date | YYYY-MM-DD | Y | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date. || FromTime | Time | HHMM | Y | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time. || ReturnDate | Date | YYYY-MM-DD | N | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data; || ReturnTime | Time | HHMM | N | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data; || Adults | Integer | [0-9] | Y | Number of Adults requiring a transfer. || Children | Integer | [0-9] | N | Number of Children requiring a transfer. || Infants | Integer | [0-9] | N | Number of Infants requiring a transfer. || OutFlight | String | [A-Z0-9] | Y* | A flight number is required if the journey involves being picked up or dropped off at an Airport. || ReturnFlight | String | [A-Z0-9] | N* | A flight number is required if the return journey involves being picked up or dropped off at an Airport. |#### Dates and TimesIt's important to note that availability should be requested with accurate dates and times. A good scenario would be if an Airport Transfer is required, where the `PickUp` would be an Airport and the `DropOff` would be a Hotel. The `FromDate` and `FromTime` should be the flight arrival date and time. If a return transfer is requested, then the `ReturnDate` and `ReturnTime` should be the flight departure date and time, our system will calculate an estimated pickup time from the Hotel.## Availability ResponseIf availability has been found for the requested parameters, the response will contain a `Transfers` field with all the nested Transfers available. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field | Additional Information ||----------------------------|-------------------------------------------------------------------------------------------------------------|| Transfers/Name | The name of the Transfer. || Transfers/Code | The product code for the transfer, which must be used in the booking request. || Transfers/BookingURL | The URL to POST the booking request to for this particular product. || Transfers/TotalPrice | The total price of the Transfer/s. || Transfers/NonDiscPrice | If a discount has been applied, this is the total price before discount. || Transfers/SalesCurrency | Three character identifier for the sale currency to qualify the price. || Transfers/Images/Src | Link to a image for the product. Prefix with `https:`. || Transfers/Images/Alt | The alt tag for the image. || Transfers/Category | The category assigned to the Transfer/s, for the full list of categories [please see below](/hxapi/transfers/av/#transfer-categories). || Transfers/Disclaimer | Depending on supplier and transfer type, the Disclaimer will contain pickup details. || Transfers/ProviderDetails | Shows the providers name and rating (if applicable). || Transfers/Cancellation | Shows the cancellation period before pickup date/time. || Transfers/VehicleDetails | Details about the vehicle being used for the Transfer/s. || Transfers/OutboundTransfer | Details about the outbound transfer. || Transfers/ReturnTransfer | Details about the return transfer (This field will be `null` if no return was requested). || Transfers/PartnerOwnSupply | Product originates from partner’s own supply. Your account manager will confirm whether you should use this. || Transfers/SupplierCost | Supplier cost for this transfer. Only available for selected products and requests. |#### [Transfer Categories](#transfer-categories)Here are the available categories which may be returned, there will only be one category assigned to each Transfer:- private_adapted_vehicle- private_car- private_coach- private_electric_car- private_excutive_car- private_executive_electric_car- private_helicopter- private_limousine- private_luxury_car- private_minibus- private_minivan- private_sea_plane- private_speed_boat- private_suv- private_water_taxi- shared_express_shuttle- shared_shuttle- shared_water_taxi### Example```json{ \"API_Reply\": { \"ATTRIBUTES\": { \"Product\": \"Transfers\", \"RequestCode\": 1, \"Result\": \"OK\", \"cached\": true, \"expires\": \"2020-07-21 15:20:14\" }, \"Transfers\": [ { \"ATTRIBUTES\": [], \"Name\": \"Shuttle\", \"Code\": \"TBHT39\", \"BookingURL\": \"/v1/transfers/TBHT39.js\", \"MoreInfoURL\": null, \"TotalPrice\": 103.52, \"NonDiscPrice\": 103.52, \"SalesCurrency\": \"GBP\", \"Images\": [ { \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\", \"Alt\": \"shuttlebus\" } ], \"Category\": \"shared_shuttle\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": \"\", \"MaxCapacity\": \"\", \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 1, \"NumberOfVehicles\": 1, \"IsPrivate\": false, \"Supplier\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Málaga Airport\", \"OriginAddress\": \"Málaga Airport, Málaga\", \"OriginIata\": \"AGP\", \"Destination\": \"BlueBay Banús\", \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\", \"DestinationIata\": \"\", \"JourneyTime\": 90, \"ArrivalDate\": \"2020-08-01\", \"ArrivalTime\": \"09:00\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2020-08-01\", \"PickupTime\": \"09:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"BlueBay Banús\", \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\", \"OriginIata\": \"\", \"Destination\": \"Málaga Airport\", \"DestinationAddress\": \"Málaga Airport, Málaga\", \"DestinationIata\": \"AGP\", \"JourneyTime\": 90, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2020-08-07\", \"ReturnTime\": \"16:30\", \"PickupDate\": \"2020-08-07\", \"PickupTime\": \"12:30\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false }, { \"ATTRIBUTES\": [], \"Name\": \"Speedy Shuttle\", \"Code\": \"TBHT519\", \"BookingURL\": \"/v1/transfers/TBHT519.js\", \"MoreInfoURL\": null, \"TotalPrice\": 134.8, \"NonDiscPrice\": 134.8, \"SalesCurrency\": \"GBP\", \"Images\": [ { \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\", \"Alt\": \"shuttlebus\" } ], \"Category\": \"speedy_shuttle\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": \"\", \"MaxCapacity\": \"\", \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 1, \"NumberOfVehicles\": 1, \"IsPrivate\": false, \"Supplier\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Málaga Airport\", \"OriginAddress\": \"Málaga Airport, Málaga\", \"OriginIata\": \"AGP\", \"Destination\": \"BlueBay Banús\", \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\", \"DestinationIata\": \"\", \"JourneyTime\": 75, \"ArrivalDate\": \"2020-08-01\", \"ArrivalTime\": \"09:00\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2020-08-01\", \"PickupTime\": \"09:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"BlueBay Banús\", \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\", \"OriginIata\": \"\", \"Destination\": \"Málaga Airport\", \"DestinationAddress\": \"Málaga Airport, Málaga\", \"DestinationIata\": \"AGP\", \"JourneyTime\": 75, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2020-08-07\", \"ReturnTime\": \"16:30\", \"PickupDate\": \"2020-08-07\", \"PickupTime\": \"12:45\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false }, { \"ATTRIBUTES\": [], \"Name\": \"Private Car\", \"Code\": \"TBHT43\", \"BookingURL\": \"/v1/transfers/TBHT43.js\", \"MoreInfoURL\": null, \"TotalPrice\": 201.72, \"NonDiscPrice\": 201.72, \"SalesCurrency\": \"GBP\", \"Images\": [ { \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\", \"Alt\": \"private standard\" } ], \"Category\": \"private_transfer\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": 1, \"MaxCapacity\": 4, \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 4, \"NumberOfVehicles\": 1, \"IsPrivate\": true, \"Supplier\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Málaga Airport\", \"OriginAddress\": \"Málaga Airport, Málaga\", \"OriginIata\": \"AGP\", \"Destination\": \"BlueBay Banús\", \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\", \"DestinationIata\": \"\", \"JourneyTime\": 60, \"ArrivalDate\": \"2020-08-01\", \"ArrivalTime\": \"09:00\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2020-08-01\", \"PickupTime\": \"09:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"BlueBay Banús\", \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\", \"OriginIata\": \"\", \"Destination\": \"Málaga Airport\", \"DestinationAddress\": \"Málaga Airport, Málaga\", \"DestinationIata\": \"AGP\", \"JourneyTime\": 60, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2020-08-07\", \"ReturnTime\": \"16:30\", \"PickupDate\": \"2020-08-07\", \"PickupTime\": \"13:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false }, { \"ATTRIBUTES\": [], \"Name\": \"Private Executive Car\", \"Code\": \"TBHT18\", \"BookingURL\": \"/v1/transfers/TBHT18.js\", \"MoreInfoURL\": null, \"TotalPrice\": 291.86, \"NonDiscPrice\": 291.86, \"SalesCurrency\": \"GBP\", \"Images\": [ { \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_luxury.jpeg\", \"Alt\": \"private luxury\" } ], \"Category\": \"private_executive\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": 1, \"MaxCapacity\": 4, \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 4, \"NumberOfVehicles\": 1, \"IsPrivate\": true, \"Supplier\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Málaga Airport\", \"OriginAddress\": \"Málaga Airport, Málaga\", \"OriginIata\": \"AGP\", \"Destination\": \"BlueBay Banús\", \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\", \"DestinationIata\": \"\", \"JourneyTime\": 60, \"ArrivalDate\": \"2020-08-01\", \"ArrivalTime\": \"09:00\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2020-08-01\", \"PickupTime\": \"09:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"BlueBay Banús\", \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\", \"OriginIata\": \"\", \"Destination\": \"Málaga Airport\", \"DestinationAddress\": \"Málaga Airport, Málaga\", \"DestinationIata\": \"AGP\", \"JourneyTime\": 60, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2020-08-07\", \"ReturnTime\": \"16:30\", \"PickupDate\": \"2020-08-07\", \"PickupTime\": \"13:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false }, { \"ATTRIBUTES\": [], \"Name\": \"Private Minibus\", \"Code\": \"TBHT2\", \"BookingURL\": \"/v1/transfers/TBHT2.js\", \"MoreInfoURL\": null, \"TotalPrice\": 295.32, \"NonDiscPrice\": 295.32, \"SalesCurrency\": \"GBP\", \"Images\": [ { \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\", \"Alt\": \"private standard\" } ], \"Category\": \"private_minibus\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": 5, \"MaxCapacity\": 8, \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 8, \"NumberOfVehicles\": 1, \"IsPrivate\": true, \"Supplier\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Málaga Airport\", \"OriginAddress\": \"Málaga Airport, Málaga\", \"OriginIata\": \"AGP\", \"Destination\": \"BlueBay Banús\", \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\", \"DestinationIata\": \"\", \"JourneyTime\": 60, \"ArrivalDate\": \"2020-08-01\", \"ArrivalTime\": \"09:00\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2020-08-01\", \"PickupTime\": \"09:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"BlueBay Banús\", \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\", \"OriginIata\": \"\", \"Destination\": \"Málaga Airport\", \"DestinationAddress\": \"Málaga Airport, Málaga\", \"DestinationIata\": \"AGP\", \"JourneyTime\": 60, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2020-08-07\", \"ReturnTime\": \"16:30\", \"PickupDate\": \"2020-08-07\", \"PickupTime\": \"13:00\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false } ], \"Pricing\": {}, \"SepaID\": \"\", \"API_Header\": { \"Request\": { \"ABTANumber\": \"YourABTANumber\", \"Password\": \"YourPassword\", \"Initials\": \"YourInitials\", \"key\": \"YourKey\", \"token\": \"YourToken\", \"FromDate\": \"2020-08-01\", \"FromTime\": 1000, \"ReturnDate\": \"2020-08-07\", \"ReturnTime\": 1730, \"PickUp\": \"AGP\", \"PickUpType\": \"IATA\", \"DropOff\": 85101062, \"DropOffType\": \"TTI\", \"OutFlight\": \"U28605\", \"ReturnFlight\": \"U28602\", \"Adults\": 2, \"v\": 1, \"format\": \"js\" } } }}```### Worked ExamplesBelow are some worked examples of both the request and response when requesting transfers availability.#### Airport to GIATA##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml Private Standard Car TBHT1169922 /transfers/TBHT1169922 87.96 87.96 GBP //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg private standard private_transfer 72 100 0 1 4 4 1 true Alicante International Airport (Benidorm) Alicante International Airport (Benidorm), Alicante ALC Hotel Rural Castillo De Biar s/n, Carretera de Banyeres, 03410, Biar 60 16/03/2022 11:15 16/03/2022 11:15 Hotel Rural Castillo De Biar s/n, Carretera de Banyeres, 03410, Biar Alicante International Airport (Benidorm) Alicante International Airport (Benidorm), Alicante ALC 60 23/03/2022 11:15 23/03/2022 07:45 1 false YourABTANumber YourPassword YourInitials YourKey YourToken ALC IATA GIATA 439771 2022-03-16 1115 2022-03-23 1115 2 U28605 U28602 ```{% endcodetab %}{% codetab JSON %}```json{ \"API_Reply\": { \"ATTRIBUTES\": { \"Product\": \"Transfers\", \"RequestCode\": 1, \"Result\": \"OK\", \"cached\": true, \"expires\": \"2021-12-07 14:50:30\" }, \"Transfers\": [ { \"ATTRIBUTES\": [], \"Name\": \"Private Standard Car\", \"Code\": \"TBHT1169922\", \"BookingURL\": \"/transfers/TBHT1169922.js\", \"MoreInfoURL\": null, \"TotalPrice\": 87.96, \"NonDiscPrice\": 87.96, \"SalesCurrency\": \"GBP\", \"Images\": [ { \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\", \"Alt\": \"private standard\" } ], \"Category\": \"private_transfer\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": 1, \"MaxCapacity\": 4, \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 4, \"NumberOfVehicles\": 1, \"IsPrivate\": true, \"Supplier\": \"\", \"Make\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Alicante International Airport (Benidorm)\", \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\", \"OriginIata\": \"ALC\", \"Destination\": \"Hotel Rural Castillo De Biar\", \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\", \"DestinationIata\": \"\", \"JourneyTime\": 60, \"DepartureDate\": null, \"DepartureTime\": null, \"ArrivalDate\": \"2022-03-16\", \"ArrivalTime\": \"11:15\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2022-03-16\", \"PickupTime\": \"11:15\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Hotel Rural Castillo De Biar\", \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\", \"OriginIata\": \"\", \"Destination\": \"Alicante International Airport (Benidorm)\", \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\", \"DestinationIata\": \"ALC\", \"JourneyTime\": 60, \"DepartureDate\": null, \"DepartureTime\": null, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2022-03-23\", \"ReturnTime\": \"11:15\", \"PickupDate\": \"2022-03-23\", \"PickupTime\": \"07:45\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false }, ], \"Pricing\": {}, \"SepaID\": \"\", \"API_Header\": { \"Request\": { \"ABTANumber\": \"YourABTANumber\", \"Password\": \"YourPassword\", \"Initials\": \"YourInitials\", \"key\": \"YourKey\", \"token\": \"YourToken\", \"PickUp\": \"ALC\", \"PickUpType\": \"IATA\", \"DropOffType\": \"GIATA\", \"DropOff\": 439771, \"FromDate\": \"2022-03-16\", \"FromTime\": 1115, \"ReturnDate\": \"2022-03-23\", \"ReturnTime\": 1115, \"Adults\": 2, \"OutFlight\": \"U28605\", \"ReturnFlight\": \"U28602\", \"format\": \"js\" } } }}```{% endcodetab %}{% endcodetabs %}#### Airport to TTI##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml Private Standard Car TBHT1169922 /transfers/TBHT1169922 87.96 87.96 GBP //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg private standard private_transfer 72 100 0 1 4 4 1 true Alicante International Airport (Benidorm) Alicante International Airport (Benidorm), Alicante ALC Hotel Rural Castillo De Biar s/n, Carretera de Banyeres, 03410, Biar 60 16/03/2022 11:15 16/03/2022 11:15 Hotel Rural Castillo De Biar s/n, Carretera de Banyeres, 03410, Biar Alicante International Airport (Benidorm) Alicante International Airport (Benidorm), Alicante ALC 60 23/03/2022 11:15 23/03/2022 07:45 1 false YourABTANumber YourPassword YourInitials YourKey YourToken ALC IATA TTI 10147575 2022-03-16 1115 2022-03-23 1115 2 U28605 U28602 ```{% endcodetab %}{% codetab JSON %}```json{ \"API_Reply\": { \"ATTRIBUTES\": { \"Product\": \"Transfers\", \"RequestCode\": 1, \"Result\": \"OK\", \"cached\": true, \"expires\": \"2021-12-07 14:50:30\" }, \"Transfers\": [ { \"ATTRIBUTES\": [], \"Name\": \"Private Standard Car\", \"Code\": \"TBHT1169922\", \"BookingURL\": \"/transfers/TBHT1169922.js\", \"MoreInfoURL\": null, \"TotalPrice\": 87.96, \"NonDiscPrice\": 87.96, \"SalesCurrency\": \"GBP\", \"Images\": [ { \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\", \"Alt\": \"private standard\" } ], \"Category\": \"private_transfer\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": 1, \"MaxCapacity\": 4, \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 4, \"NumberOfVehicles\": 1, \"IsPrivate\": true, \"Supplier\": \"\", \"Make\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Alicante International Airport (Benidorm)\", \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\", \"OriginIata\": \"ALC\", \"Destination\": \"Hotel Rural Castillo De Biar\", \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\", \"DestinationIata\": \"\", \"JourneyTime\": 60, \"DepartureDate\": null, \"DepartureTime\": null, \"ArrivalDate\": \"2022-03-16\", \"ArrivalTime\": \"11:15\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2022-03-16\", \"PickupTime\": \"11:15\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Hotel Rural Castillo De Biar\", \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\", \"OriginIata\": \"\", \"Destination\": \"Alicante International Airport (Benidorm)\", \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\", \"DestinationIata\": \"ALC\", \"JourneyTime\": 60, \"DepartureDate\": null, \"DepartureTime\": null, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2022-03-23\", \"ReturnTime\": \"11:15\", \"PickupDate\": \"2022-03-23\", \"PickupTime\": \"07:45\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false }, ], \"Pricing\": {}, \"SepaID\": \"\", \"API_Header\": { \"Request\": { \"ABTANumber\": \"YourABTANumber\", \"Password\": \"YourPassword\", \"Initials\": \"YourInitials\", \"key\": \"YourKey\", \"token\": \"YourToken\", \"PickUp\": \"ALC\", \"PickUpType\": \"IATA\", \"DropOffType\": \"TTI\", \"DropOff\": 10147575, \"FromDate\": \"2022-03-16\", \"FromTime\": 1115, \"ReturnDate\": \"2022-03-23\", \"ReturnTime\": 1115, \"Adults\": 2, \"OutFlight\": \"U28605\", \"ReturnFlight\": \"U28602\", \"format\": \"js\" } } }}```{% endcodetab %}{% endcodetabs %}#### Airport to Postal Address##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml Private Standard Car TBHT1169922 /transfers/TBHT1169922 87.96 87.96 GBP //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg private standard private_transfer 72 100 0 1 4 4 1 true Alicante International Airport (Benidorm) Alicante International Airport (Benidorm), Alicante ALC Hotel Rural Castillo De Biar Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES 60 16/03/2022 11:15 16/03/2022 11:15 Hotel Rural Castillo De Biar Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES Alicante International Airport (Benidorm) Alicante International Airport (Benidorm), Alicante ALC 60 23/03/2022 11:15 23/03/2022 07:45 1 false YourABTANumber YourPassword YourInitials YourKey YourToken ALC IATA postal-address Hotel Rural Castillo De Biar Carretera de Banyeres s/n Biar Alicante 03410 ES -0.76832006 38.63852215 2022-03-16 1115 2022-03-23 1115 2 U28605 U28602 ```{% endcodetab %}{% codetab JSON %}```json{ \"API_Reply\": { \"ATTRIBUTES\": { \"Product\": \"Transfers\", \"RequestCode\": 1, \"Result\": \"OK\", \"cached\": true, \"expires\": \"2021-12-07 16:26:43\" }, \"Transfers\": [ { \"ATTRIBUTES\": [], \"Name\": \"Private Standard Car\", \"Code\": \"TBHT1169922\", \"BookingURL\": \"/transfers/TBHT1169922.js\", \"MoreInfoURL\": null, \"TotalPrice\": 87.96, \"NonDiscPrice\": 87.96, \"SalesCurrency\": \"GBP\", \"Images\": [{ \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\", \"Alt\": \"private standard\" }], \"Category\": \"private_transfer\", \"Disclaimer\": { \"Title\": null, \"Message\": null }, \"ProviderDetails\": { \"ProviderName\": \"\", \"ProviderRating\": \"\" }, \"Cancellation\": { \"Period\": 72, \"Percentage\": 100, \"Fee\": 0 }, \"VehicleDetails\": { \"MinCapacity\": 1, \"MaxCapacity\": 4, \"MinStops\": \"\", \"MaxStops\": \"\", \"Bags\": 4, \"NumberOfVehicles\": 1, \"IsPrivate\": true, \"Supplier\": \"\", \"Make\": \"\" }, \"OutboundTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Alicante International Airport (Benidorm)\", \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\", \"OriginIata\": \"ALC\", \"Destination\": \"Hotel Rural Castillo De Biar\", \"DestinationAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES\", \"DestinationIata\": \"\", \"JourneyTime\": 60, \"DepartureDate\": null, \"DepartureTime\": null, \"ArrivalDate\": \"2022-03-16\", \"ArrivalTime\": \"11:15\", \"ReturnDate\": null, \"ReturnTime\": null, \"PickupDate\": \"2022-03-16\", \"PickupTime\": \"11:15\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"ReturnTransfer\": { \"SupplierRef\": \"\", \"Origin\": \"Hotel Rural Castillo De Biar\", \"OriginAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES\", \"OriginIata\": \"\", \"Destination\": \"Alicante International Airport (Benidorm)\", \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\", \"DestinationIata\": \"ALC\", \"JourneyTime\": 60, \"DepartureDate\": null, \"DepartureTime\": null, \"ArrivalDate\": null, \"ArrivalTime\": null, \"ReturnDate\": \"2022-03-23\", \"ReturnTime\": \"11:15\", \"PickupDate\": \"2022-03-23\", \"PickupTime\": \"07:45\", \"JoiningInstructions\": null, \"ContactNumbers\": null }, \"advance_purchase\": true, \"PartnerOwnSupply\": false } ], \"Pricing\": {}, \"SepaID\": \"\", \"API_Header\": { \"Request\": { \"ABTANumber\": \"YourABTANumber\", \"Password\": \"YourPassword\", \"Initials\": \"YourInitials\", \"key\": \"YourKey\", \"token\": \"YourToken\", \"PickUp\": \"ALC\", \"PickUpType\": \"IATA\", \"DropOffType\": \"postal-address\", \"DropOffName\": \"Hotel Rural Castillo De Biar\", \"DropOffAddress\": [ \"Carretera de Banyeres\", \"s/n\" ], \"DropOffTown\": \" Biar\", \"DropOffCounty\": \"Alicante\", \"DropOffPostcode\": \"03410\", \"DropOffCountryCode\": \"ES\", \"DropOffLongitude\": -0.76832006, \"DropOffLatitude\": 38.63852215, \"FromDate\": \"2022-03-16\", \"FromTime\": 1115, \"ReturnDate\": \"2022-03-23\", \"ReturnTime\": 1115, \"Adults\": 2, \"OutFlight\": \"U28605\", \"ReturnFlight\": \"U28602\", \"format\": \"js\" } } }}```{% endcodetab %}{% endcodetabs %}[^1]: Only required when the location type is `postal-address`.", @@ -281,41 +316,6 @@ } , - "hxapi-upgrade": { - "title": "Product Upgrades", - "content": "# Product Upgrades[API Docs](/hxapi/) > [Product Upgrades](/hxapi/upgrade)## Upgrades Availability RequestUpgrades are currently only supported for parking, hotel and lounge bookings. Upgrades can be requested on a per product basis.#### MethodGET#### Endpoint/upgrade/{productCode}NB: Where `productCode` is the code of the base product i.e. the parking/hotel/lounge etc. product.```https://api.holidayextras.com/v1/upgrade/LGV4```## Request Parameters| Name | Data Type | Format | Mandatory? | Additional Information ||-------------|-----------|------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | Y* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token. || ArrivalDate | String | YYYY-MM-DD | Y | This should be the same as the `ArrivalDate` from the base product request. || ArrivalTime | Time | HHMM | Y | This should be the same as the `ArrivalTime` from the base product request. || DepartDate | Date | YYYY-MM-DD | N | This should be the same as the `DepartDate` from the base product request. || DepartTime | Time | HHMM | N | This should be the same as the `DepartTime` from the base product request. || Adults | Integer | [0-9] | Y* | Mandatory for Lounge upgrade requests. Number of adults in the party || Children | Integer | [0-9] | Y* | Mandatory for Lounge upgrade requests. Number of children in the party |## Upgrade Availability ResponseThe response will return a list of available upgrades.Upgrades are sold on a per booking, per person, or per room basis.Upgrades can be for the day before travel, day of departure or day of return.| Field | Additional Information ||--------------------|---------------------------------------------------------------------------------------------|| Code | Product code for the upgrade || Name | Name of the upgrade || Per | Pricing basis, either per *P*erson, per *B*ooking, per *R*oom || Canx | Whether the upgrade is cancellable (Y/N) || description | || supplement_type | Type classification for the upgrade || Date | Date the upgrade is to be booked for. Format YYYY-MM-DD || only_for_adults | Upgrades restricted to adult only parties e.g. Adult only lounges || Price | The price of the upgrade minus any discounts. Only present for per booking upgrades || NonDiscPrice | The total price of the upgrade before discounts. Only present for per booking upgrades || DiscAmt | The amount of any discount applied. Only present for per booking upgrades || AdPrice | The per adult price minus any discounts. Only present for per person upgrades || NonDiscAdPrice | The per adult price before any discounts. Only present for per person upgrades || AdDiscAmt | The amount of discount applied to the per adult price. Only present for per person upgrades || ChPrice | The per child price minus any discounts. Only present for per person upgrades || NonDiscChPrice | The per child price before any discounts. Only present for per person upgrades || ChDiscAmt | The amount of discount applied to the child price. Only present for per person upgrades || API_Header/Request | The API returns every parameter and value you sent in the request. |## Examples### Example 1 - Carpark Upgrades#### Request{% codetabs %} {% codetab XML %} ```https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45 ``` {% endcodetab %} {% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/STN5.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45``` {% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_1_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_1_response.json %}```{% endcodetab %}{% endcodetabs %}### Example 1 - Hotel Upgrades#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/LGWSOF.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_2_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_2_response.json %}```{% endcodetab %}{% endcodetabs %}", - "url": "/hxapi/upgrade/" - } - , - - "hxapi-hotel-av": { - "title": "Hotel Availability Request", - "content": "## Hotel Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/LocationCode```For example, for London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHR```If you know the specific hotel code, then you can request availability by entering that into the endpoint. For example, for the Hilton at London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRHIL```To find the airport locations available for hotels, please refer to the [locations endpoint.](/hxapi/locations)### Request ParametersNB: All parameter names are case sensitive.| Name | Data Type | Format | Mandatory? | Additional Information ||----------------|-----------|-----------------------------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | Y* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token. || ArrivalDate | Date | YYYY-MM-DD | Y | Date customer arrives at hotel. || Nights | Integer | 1 | Y | Number of nights the customer wants to stay in the hotel. NB: It is only possible to book one night stays. || RoomType | String | [A-Z0-9] 3 chars | Y | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes. || SecondRoomType | String | [A-Z0-9] 3 chars | N* | NB: This feature is only available in the UK. This parameter is mandatory if the customer wishes to book two rooms at the same time. (Max 2 rooms) The room codes are as per RoomType. || ParkingDays | Integer | [0-9] 2 chars | Y | NB: The maximum duration accepted for ParkingDays is 30. || System | String | [A-Z] 3 chars | Y* | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only). || lang | String | [A-Z] 2 chars | Y* | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.) || Terminal | String | [A-Z1-9] 1 char | N | An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the [Terminal](/hxapi/terminal) request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). || fields | String | [A-Z] a csv list of product info fields | N | A list of product info fields can be passed in to return configurable product information e.g. `fields=name,address,latitude,sellingpoint`. |## Hotel Availability ResponseFor a detailed explanation of the fields returned, please see below:| Field | Additional Information ||------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Hotel/Name | The name of the product || Hotel/Code | The product code || Hotel/BookingURL | The URL to POST the booking request to for this particular product. || Hotel/MoreInfoURL | The link to more information about this product, sourced from the Product Library. || Hotel/RequestFlags | These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request. Flags are only returned when required. The flags which can be returned are: `Registration`, `CarMake`, `CarModel`, `CarColour`, `OutFlight`, `ReturnFlight`, `OutTerminal`, `ReturnTerminal`, `Destination`, `MobileNum` || Hotel/Price | The price of product without any surcharges/fees added. || Hotel/PriceWithSurcharge | *NB: Please ignore this field - we no longer accept new agents sending payment details via our API.* || Hotel/Adults* | The maximum number of adults included in the room occupancy. || Hotel/Children* | The maximum number of children included in the room occupancy. || Hotel/RoomCode | *NB: Please ignore this field as it relates to internal systems.* || Hotel/BoardBasis | *NB: Please ignore this field as it is no longer used and will be deprecated in future versions of the API.* || Hotel/ParkingDays | This returns the number of days parking available. NB: This may differ from the value requested, due to parking packages usually being set up in the system as either 4, 8 or 15 days. || Hotel/NonDiscPrice | The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison. || Hotel/CancellationFeeExceptions | If the hotel has non-standard cancellation fees. || Hotel/AmendmentFeeExceptions | If the hotel has non-standard amendment fees. || Hotel/noncancellable_nonrefundable | Is this hotel noncancellable or non-refundable? || Hotel/parking_includes_arrival | If parking during the customer's hotel stay included in their parking package || Hotel/CarPark | If your request included car parking, this is the car park code. || Hotel/Filter | *NB: Please ignore this field as it is for internal use only.* || Hotel/lead_time_cancellation | This is the number of days before the booking starts that the product will switch from flexible to non-flexible. || API_Header/Request | The API returns every parameter and value you sent in the previous request. | \\* Where two rooms have been requested, these fields represent the total of adults and children across all rooms. Additional fields will show the individual room occupancy: `FirstRoomAdults`, `FirstRoomChildren`, `SecondRoomAdults` and `SecondRoomChildren`.## Key Information on HotelsPlease read this section through carefully, as it contains useful information about restrictions on how hotels must be sold.### Advance purchaseAdvance purchase products are non-refundable and non-cancellable. As a result, Cancellation Waiver must *not* be sold to customers purchasing a product with `advance_purchase` set to 1.### Day Use OnlyThere is a field in the product library for hotels, named `day_use_only`. Day use products must not be sold to customers wishing to have an overnight stay where `day_use_only` is set to 1.### Parking Includes ArrivalIn order to establish whether the package includes parking for the night of the hotel stay the `parking_includes_arrival` field needs to be taken into account.Where this field is set to 0, this means the night of the hotel stay is not included as there is free overnight parking. Parking stay will start from the following day. Where it is set to 1, this means that parking starts from the date the customer checks into the hotel.### Mystery / Un-named ProductsThere are some hotels in which the name field will not provide the name of the hotel e.g `Mystery 4-star hotel`. The name of these hotels should not be provided to the customer until the booking is made, along with other identifying details such as address, hotel images, restaurant names etc.### Lead time cancellationFlexible bookings become non flexible within a certain timeframe before the stay date ie booking turns non flexible within 30 days of stay.Scenario 1* Flexible booking made outside 60 days of stay.* Cancellation policy - only able to canx up to 30 days before stay date.* Booking is non flex within 30 days of stay date.Scenario 2* Flexible booking made inside 60 days of stay date.* Cancellation policy - only able to canx up to 3 days before stay date.* Booking is non flex within 3 days of stay date.## Worked ExamplesBelow are worked examples of both the requests and responses for hotel availability.### UK Hotel Availability Request - Room Only (zero days parking)```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=0```### UK Hotel Availability Response - Room Only (zero days parking)NB: This is a shortened example compiled from a full availability response.```xml Mercure LHRMEA /v1/hotel/HPLHRMEA /v1/product/LHRMEA 1 45.00 45.90 2 1 TRL RO 0 45.00 30 1 1 1 Thistle T5 LHRPAA /v1/hotel/HPLHRPAA /v1/product/LHRPAA 85.50 87.21 2 1 TRL RO 0 85.50 30 1 0 1 Hilton T5 LHRHLT /v1/hotel/HPLHRHLT /v1/product/LHRHLT 1 1 1 99.00 100.98 2 1 TRL RO 0 99.00 2.00 0.00 4.00 0.00 0.00 0.00 2.99 YourABTANumber YourPassword YourKey YourToken 2017-12-01 1 T21 0 1 ```### UK Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=8```### UK Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml Mercure with Purple Parking Meet and Greet LHRMPU /v1/hotel/HPLHRMPU /v1/product/LHRMPU 1 1 1 1 1 1 1 129.00 131.58 2 1 TRL RO 8 129.00 LHR5 LHR5 1 Thistle T5 with parking at the hotel and breakfast LHRPAT /v1/hotel/HPLHRPAT /v1/product/LHRPAT 130.00 132.60 2 1 TRL RO 8 130.00 1 1 0 Sheraton Skyline with parking at the hotel LHRSKA /v1/hotel/HPLHRSKA /v1/product/LHRSKA 134.00 136.68 2 1 TRL RO 8 134.00 0 2.00 0.00 4.00 0.00 0.00 0.00 2.99 YourABTANumber YourPassword YourKey YourToken 2017-12-01 1 T21 8 1 ```### European Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/MUC?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=D20&ParkingDays=8&System=ABG&lang=de```### European Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml Schweigers Landgasthof MUCLAN /v1/hotel/FRMUCLAN /v1/product/MUCLAN 120.00 NaN 2 0 DZ F 15 120.00 Airporthotel Regent MUCREG /v1/hotel/FRMUCREG /v1/product/MUCREG 97.00 NaN 2 0 DZ F 15 97.00 NH München Airport MUCAST /v1/hotel/FRMUCAST /v1/product/MUCAST 113.00 NaN 2 0 DZ U 8 113.00 0.00 0.00 0.00 TESTG Redacted mytestkey generate 2017-12-01 1 D20 8 ABG de 1 ```", - "url": "/hxapi/hotel/av/" - } - , - - "hxapi-hotel": { - "title": "Hotels", - "content": "# Hotels[API Docs](/hxapi/) > product:[Hotels](index)## Hotel EndpointsHere are the hotel specific endpoints: | Action | Endpoint | Method | | ------ | -------- | ------ | | Availability at hotel | [https://api.holidayextras.com/v1/hotel/LocationCode](av) | GET | | Make booking at hotel | [https://api.holidayextras.com/v1/hotel/LocationCode](bkg) | POST | | Pre-booking price check | [https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck](priceCheck) | GET |Please note: All hotel requests include parking options of zero, 8 and 15 days parking. To make a request for a hotel only product, please select zero days parking.## Hotel User JourneyTo follow -", - "url": "/hxapi/hotel/" - } - , - - "hxapi-productlibrary": { - "title": "Product Library", - "content": "# Product LibraryThe data returned from a Product Library request depends on the type of product you ask for. A request for a car park returns different fields than a request for a hotel.By default, only fields that contain a value are returned.You can specify the fields you want returned. Simply add the parameter fields and specify the field names. An error/warning element will be returned for any fields which do not exist, but the request will still return those elements for which there is a value. If you request a valid field, but there is no value, it will not be returned.The purpose of most of the fields should be self-explanatory. If there is anything you do not understand, please email . There are no guarantees about the types of data returned, you should make no assumptions about a specific field being an integer etc.Data returned should not be cached locally for periods of time greater than one day (24 hours).### URL/product/{productCode}### MethodGET### Parameters| Name | Format | Required ||--------|--------|----------|| token | String | N || key | String | Y || fields | String | N |## Available FieldsThe available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.{% codetabs %}{% codetab Parking %}{% include_relative _parkingFields.md %}{% endcodetab %}{% codetab Hotel room only %}{% include_relative _hotelOnlyFields.md %}{% endcodetab %}{% codetab Hotel with parking %}{% include_relative _hotelParkingFields.md %}{% endcodetab %}{% codetab Lounge %}{% include_relative _loungeFields.md %}{% endcodetab %}{% codetab Fast track %}{% include_relative _fastTrackFields.md %}{% endcodetab %}{% endcodetabs %}---## Examples### Example 1 - Default Response#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_1.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_1.json %}```{% endcodetab %}{% endcodetabs %}---### Example 2 - Restricted field list#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_2.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_2.json %}```{% endcodetab %}{% endcodetabs %}---### Example 3 - German Parking Request#### RequestRequests for German products return a different set of fields. Explanation of fields not currently available.{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_3.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_3.json %}```{% endcodetab %}{% endcodetabs %}", - "url": "/hxapi/productlibrary/" - } - , - - "hxapi-lounge": { - "title": "Lounge", - "content": "# LoungeHere are the lounge specific endpoints:| Request | Endpoint | Method || --- | --- | --- || Availability of lounges at airport | [https://api.holidayextras.com/v1/lounge/AirportCode](av/airport) | GET || Make booking for lounge | [https://api.holidayextras.com/v1/lounge/LoungeCode](bkg) | POST |", - "url": "/hxapi/lounge/" - } - , - "hxapi": { "title": "Detailed Guides", "content": "# Detailed Guides[API Docs](/hxapi/) > index## Product GuidesPlease check the table below for details of which products are available in each region.|Product Endpoints|UK|Europe||-----------------|--|------||[Parking](/hxapi/parking)|Yes|Yes||[Hotels](/hxapi/hotel)|Yes|Yes||[Lounges](/hxapi/lounge)|Yes|Yes||[FastTrack](/hxapi/fasttrack)|Yes|No||Transfers|No|No|## Non-Product Specific GuidesThese endpoints are not product-specific. Please check the table below for details of which endpoints are available for each region.|Generic Endpoints|UK|Europe||-----------------|--|------||[User token](/hxapi/usertoken)|Yes|Yes||[Location](/hxapi/locations)|Yes|Yes||[Terminal](/hxapi/terminal)|Yes|No||[Barcode / QRCode](/hxapi/barcode)|Yes|No||[Product library](/hxapi/productlibrary)|Yes|Yes||[Managing a booking](/hxapi/viewamendcancel)|Yes|Yes||[Update a booking's flight](/hxapi/flightUpdate)|Yes|No||[Bundles](/hxapi/bundles)|Yes|No||[Upgrade Availability](/hxapi/upgrade)|Yes|No## \"DE-Start\" Product GuidesThis documentation relates to an existing integration with a partner in Germany. It is included here for reference only, and is not to be used or considered for new partner integrations.|Product Endpoints|UK|Europe||-----------------|--|------||[DE-Start](/hxapi/de-start)|No|Yes|## ReferenceLists of conventions used in this API.* [API Errors](/hxapi/reference/errors)* [Titles](/hxapi/reference/titles)", @@ -421,13 +421,6 @@ } , - "hxapi-parking-pricecheck": { - "title": "Car Park Price Check", - "content": "# Car Park Price Check[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av) > [Price Check](/hxapi/parking/priceCheck)## Car Park Pre-booking Price Check RequestThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck```For example, for _Maple Manor Meet and Greet at London Gatwick North terminal_ the endpoint is:```https://api.holidayextras.com/v1/carpark/LGW4/priceCheck```### Request ParametersNB: All parameter names are case sensitive.| Name | Data Type | Format | Mandatory? | Additional Information ||------------------------|-----------|-------------------|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | N* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | This is the same token used in the availability request. || ArrivalDate | Date | YYYY-MM-DD | Y | Date customer drops vehicle at car park. || ArrivalTime | Time | HHMM | Y | Time customer drops vehicle at car park. || DepartDate | Date | YYYY-MM-DD | Y | Date customer picks up vehicle from car park. || DepartTime | Time | HHMM | Y | Time customer picks up vehicle from car park. || NumberOfPax | Integer | [0-9] 2 chars | Y | Number of passengers. || System | String | [A-Z] 3 chars | Y* | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only). |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/parking/bkg).## Car Park Price Check Response| Field | Additional Information ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice | This is the total price for the booking including all upgrades || API_Header/Request | A list of parameters that were sent in the booking request. |## Worked ExamplesBelow are worked examples of both the request and response for the price check for parking.### UK Parking price check#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1200&DepartDate=2025-07-08&DepartTime=1200&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_response.xml %}```### UK Parking price check with Upgrades#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1230&DepartDate=2025-07-08&DepartTime=1345&NumberOfPax=1&Supplements[0][Code]=HXOST1&Supplements[0][Date]=2025-07-01&Supplements[0][Quantity]=1&Supplements[1][Code]=LHRSFS&Supplements[1][Date]=2025-07-01&Supplements[1][Adults]=2&Supplements[1][Children]=1```#### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```### Error example: no availability#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-09-15&ArrivalTime=1300&DepartDate=2024-09-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_no_availability_response.xml %}```### Error example: request which is incorrect or can't be actioned#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-11-15&ArrivalTime=2500&DepartDate=2024-11-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_incorrect_request_response.xml %}```", - "url": "/hxapi/parking/priceCheck/" - } - , - "hxapi-hotel-pricecheck": { "title": "Hotel Price Check", "content": "# Hotel Price CheckThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.## MethodGET## EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck```For example, for _Mercure at London Heathrow_ the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck```## Request ParametersNB: All parameter names are case sensitive.| Name | Data Type | Format | Mandatory? | Additional Information ||------------------------|-----------|--------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | N* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | This is the same token used in the availability request. || ArrivalDate | Date | YYYY-MM-DD | Y | Date customer arrives at hotel. || Nights | Integer | 1, 2, 3, etc | Y | Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays. || RoomCode | String | [A-Z0-9] 3 chars | Y | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes. || Adults | Integer | [1-5] 1 char | Y | The number of adults occupying the room. || Children | Integer | [0-4] 1 char | Y | The number of children occupying the room. || ParkingDays | Integer | [0-9] 2 chars | Y | NB: The maximum duration accepted for ParkingDays is 30. || CustomerRef | String | [A-Z0-9] 20 chars | N | Enter your Customer Reference to help match bookings for accounting purposes. || Remarks | String | [A-Z0-9] 60 chars | N | Pass in Remarks for notification such as COT REQUESTED in ROOM || Waiver | Boolean | [0,1] | Y | Defaults to 0 if not supplied. || DataProtection | String | [Y,N] | N | Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied. || System | String | [A-Z] 3 chars | Y* | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only). || lang | String | [A-Z] 2 chars | Y* | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.) |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/hotel/bkg).## Multiple rooms on same bookingThe additional parameters for including a second room are:| Name | Data Type | Format | Mandatory? | Additional Information ||--------------------|-----------|-------------------------------------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|| SecondRoomType | String | [A-Z0-9] 2 chars | N* | This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per [Room Codes](/hxapi/types/roomcode). || SecondRoomCode | String | [Room Codes](/hxapi/types/roomcode) | N | NB: Please note that the room codes differ between availability and booking requests. || SecondRoomAdults | Integer | [1-5] 1 char | N | The number of adults occupying the second room. || SecondRoomChildren | Integer | [0-4] 1 char | N | The number of children occupying the second room. |## UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are:| Name | Data Type | Format | Mandatory? ||----------------|-----------|-------------------|------------|| CarDropoffDate | Date | YYYY-MM-DD | Y || CarDropoffTime | Time | HHMM | Y || CarPickupDate | Date | YYYY-MM-DD | Y || CarPickupTime | Time | HHMM | Y |# Hotel Price Check Response| Field | Additional Information ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice | This is the total price for the booking including all upgrades || API_Header/Request | A list of parameters that were sent in the booking request. |# Worked ExamplesBelow are worked examples of both the request and response for the price check for hotels.## UK Hotel price check### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0```### Response```xml{% include_relative examples/_uk_room_only_price_check_response.xml %}```## UK Hotel price check with Upgrades### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-10&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0&Supplements[0][Code]=LGWSOE&Supplements[0][Date]=2025-07-10&Supplements[0][Quantity]=1&Supplements[0][TotalPrice]=40.00&Supplements[1][Code]=LGWASC&Supplements[1][Date]=2025-07-11&Supplements[1][Adults]=2&Supplements[1][Children]=0&Supplements[1][TotalPrice]=82.00```### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```## Error example: no availability### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=0&Nights=1&ArrivalDate=2024-10-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_no_availability_response.xml %}```## Error example: validation error### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=2&Nights=1&ArrivalDate=2024-11-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_validation_error_response.xml %}```", @@ -435,6 +428,13 @@ } , + "hxapi-parking-pricecheck": { + "title": "Car Park Price Check", + "content": "# Car Park Price Check[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av) > [Price Check](/hxapi/parking/priceCheck)## Car Park Pre-booking Price Check RequestThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck```For example, for _Maple Manor Meet and Greet at London Gatwick North terminal_ the endpoint is:```https://api.holidayextras.com/v1/carpark/LGW4/priceCheck```### Request ParametersNB: All parameter names are case sensitive.| Name | Data Type | Format | Mandatory? | Additional Information ||------------------------|-----------|-------------------|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String | [A-Z0-9] 5 chars | Y | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up. || Password | String | [A-Z0-9] 5 chars | N* | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials | String | [A-Z] 3 chars | N | The initials of the Operator / Agent. || key | String | [A-Z] | Y | This will be assigned to you by your Account Manager during set up. || token | String | [0-9] 9 chars | Y | This is the same token used in the availability request. || ArrivalDate | Date | YYYY-MM-DD | Y | Date customer drops vehicle at car park. || ArrivalTime | Time | HHMM | Y | Time customer drops vehicle at car park. || DepartDate | Date | YYYY-MM-DD | Y | Date customer picks up vehicle from car park. || DepartTime | Time | HHMM | Y | Time customer picks up vehicle from car park. || NumberOfPax | Integer | [0-9] 2 chars | Y | Number of passengers. || System | String | [A-Z] 3 chars | Y* | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only). |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/parking/bkg).## Car Park Price Check Response| Field | Additional Information ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice | This is the total price for the booking including all upgrades || API_Header/Request | A list of parameters that were sent in the booking request. |## Worked ExamplesBelow are worked examples of both the request and response for the price check for parking.### UK Parking price check#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1200&DepartDate=2025-07-08&DepartTime=1200&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_response.xml %}```### UK Parking price check with Upgrades#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1230&DepartDate=2025-07-08&DepartTime=1345&NumberOfPax=1&Supplements[0][Code]=HXOST1&Supplements[0][Date]=2025-07-01&Supplements[0][Quantity]=1&Supplements[1][Code]=LHRSFS&Supplements[1][Date]=2025-07-01&Supplements[1][Adults]=2&Supplements[1][Children]=1```#### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```### Error example: no availability#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-09-15&ArrivalTime=1300&DepartDate=2024-09-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_no_availability_response.xml %}```### Error example: request which is incorrect or can't be actioned#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-11-15&ArrivalTime=2500&DepartDate=2024-11-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_incorrect_request_response.xml %}```", + "url": "/hxapi/parking/priceCheck/" + } + , + "payment-gateway-v2-refund": { "title": "Payment Gateway: Refund", "content": "# Payment Gateway: Refund[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Refund](/payment-gateway/v2/refund)## Refund RequestThis endpoint will make a refund based on existing payments.### MethodPOST### EndpointTo make a refund, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/refund```### Request Headers| Name | Data Type | Format | Mandatory? | Additional Information || ---- | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v2+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name | Data Type | Format | Mandatory? | Additional Information | | ---- | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | payments | Array | [String, String] | Y | An array listing all payments made for this booking. | | amount | Integer | [0-9] | Y | The price (in pence) to be refunded. |## Refund ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been refunded | | status | The status of the refund | | error | The error if the refund fails |## ExamplesBelow are examples of both the request and response for a refund.### Refund Request**POST** `https://payment-gateway.holidayextras.co.uk/refund`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v2+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{ \"channel\": \"channel\", \"payments\": [\"testPaymentId1\", \"testPaymentId2\"], \"amount\": 1234}```### Refund Response#### Successful Refund```{ \"amount\": 12.34, \"id\": \"REFUND-testPaymentId1\", \"status\": \"SUCCESS\"}```#### Failed Refund```{ \"amount\": 12.34, \"status\": \"FAIL\", \"error\": \"Failed making refund\"}```", @@ -542,7 +542,7 @@ "partner-v2": { "title": "Partner API 2026 (APIConnect)", - "content": "# Partner API 2026 (APIConnect)Partner API 2026 (APIConnect) is the next step for our platform. It brings UK and EU integrations together in one place, with OAuth 2.0 authentication and standardised contracts defined using an OpenAPI schema. The platform is built to scale as we expand into more markets.This documentation is subject to change. Further features, including a booking list capability to support reconciliation and recovery flows, as well as wider product coverage, will be introduced in later phases.## Environments| | Production | Staging ||---|---|---|| **API** | `https://api.holidayextras.com` | `https://api-sandbox.holidayextras.com` || **Auth** | `https://auth.holidayextras.com` | `https://auth-staging.holidayextras.com` || **OpenAPI Schema** | `https://api.holidayextras.com/partner-api/v2/schema.json` | `https://api-sandbox.holidayextras.com/partner-api/v2/schema.json` |Use staging for development and testing. Authenticate against the matching auth environment -- staging credentials will not work against production and vice versa.View the schema in [Swagger Editor](https://editor.swagger.io/) or import into [Postman](https://www.postman.com/).## Documentation* [Authentication](/partner/v2/authentication/) - OAuth 2.0 client credentials flow* [Understanding the OpenAPI Documentation](/partner/v2/api-endpoint-navigation-guide/) - Endpoint workflows and integration guide* [Event Notifications](/partner/v2/webhook-integration-guide/) - Webhook integration for booking status updates* [Error Responses](/partner/v2/problems/bad-request/) - HTTP error codes and resolution guidance", + "content": "# Partner API 2026 (APIConnect)Partner API 2026 (APIConnect) is the next step for our platform. It brings UK and EU integrations together in one place, with OAuth 2.0 authentication and standardised contracts defined using an OpenAPI schema. The platform is built to scale as we expand into more markets.## DocumentationPartner API 2026 documentation:### **[holidayextras/partner-api-documentation](https://github.com/holidayextras/partner-api-documentation)**Start with the [README](https://github.com/holidayextras/partner-api-documentation/blob/main/README.md) for environments, base URLs, authentication and the current OpenAPI schema.| | ||---|---|| [Getting started](https://github.com/holidayextras/partner-api-documentation/blob/main/onboarding.md) | The route from sandbox access to launch || [Integration guides](https://github.com/holidayextras/partner-api-documentation/tree/main/docs/integration-guides) | Authentication, sandbox testing, search, webhooks, versioning, price lock || [API reference](https://github.com/holidayextras/partner-api-documentation/tree/main/docs/api-reference) | Per-endpoint request and response detail || [Error handling](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/errors.md) | How to respond to errors in your integration || [FAQs](https://github.com/holidayextras/partner-api-documentation/blob/main/faqs.md) | Common questions |", "url": "/partner/v2/" } , @@ -568,6 +568,41 @@ } , + "partner-v2-problems-dependency-unavailable": { + "title": "Dependency Unavailable", + "content": "# Dependency Unavailable| Field | Value ||-------|-------|| **Status** | 503 || **Code** | `dependency_unavailable` |A service the request depended on could not be reached. This is the second of two `503` problems: [Service Unavailable](/partner/v2/problems/service-unavailable/) says the service itself cannot serve the request, while `dependency_unavailable` says the service is healthy but something it needed is not answering.## Common causes- A downstream booking, content or supply service was unreachable- Repeated failures caused the API to stop calling a struggling dependency for a short period, so the call fails immediately rather than waiting- The authentication service could not be reached to verify your token## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/dependency-unavailable\", \"title\": \"Dependency Unavailable\", \"status\": 503, \"detail\": null, \"code\": \"dependency_unavailable\", \"trace_id\": \"abc123def456\", \"errors\": []}````detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message.## How to resolveRetry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. Because the call may have been rejected without being attempted, retries are cheap, but keep the backoff -- retrying immediately will only extend the period the dependency is treated as unavailable. If the error persists, contact support with the `trace_id`.", + "url": "/partner/v2/problems/dependency-unavailable/" + } + , + + "partner-v2-problems-forbidden": { + "title": "Forbidden", + "content": "# Forbidden| Field | Value ||-------|-------|| **Status** | 403 || **Code** | `forbidden` |The credentials are valid, but the account they belong to is not permitted to perform this operation. Unlike a `401`, refreshing the token will not help.## Common causes- The account is not entitled to the product or operation being requested- The requested resource belongs to a different account- The operation is enabled for some environments or brands on the account but not the one being called## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/forbidden\", \"title\": \"Forbidden\", \"status\": 403, \"detail\": \"Not permitted to perform this operation\", \"code\": \"forbidden\", \"trace_id\": \"abc123def456\", \"errors\": []}```## How to resolveDo not retry -- the outcome will not change. Check that the resource being requested belongs to the authenticating account. If the operation should be available to you, contact your account manager or support with the `trace_id` to have the entitlement reviewed.", + "url": "/partner/v2/problems/forbidden/" + } + , + + "partner-v2-problems-gateway-timeout": { + "title": "Gateway Timeout", + "content": "# Gateway Timeout| Field | Value ||-------|-------|| **Status** | 504 || **Code** | `gateway_timeout` |A service the request depended on did not respond within the time budget for the request. The call was abandoned, not refused -- so unlike a `503`, the downstream operation may or may not have completed.## Common causes- A downstream booking or content service was slow to respond- The time budget for the request was already exhausted by earlier calls in the chain- A dependency was recovering from load and responding well below its usual speed## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/gateway-timeout\", \"title\": \"Gateway Timeout\", \"status\": 504, \"detail\": null, \"code\": \"gateway_timeout\", \"trace_id\": \"abc123def456\", \"errors\": []}````detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message.## How to resolveFor reads, retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts.For writes -- creating a booking, or confirming an amendment or cancellation -- a `504` does not tell you whether the operation completed. Retry the request with the **same** `Idempotency-Key` rather than a new one, so a request that did land is returned to you instead of being duplicated. If the error persists, look the booking up before creating it again, and contact support with the `trace_id`.", + "url": "/partner/v2/problems/gateway-timeout/" + } + , + + "partner-v2-problems-gone": { + "title": "Gone", + "content": "# Gone| Field | Value ||-------|-------|| **Status** | 410 || **Code** | `gone` |The resource was once available but has been permanently removed. Unlike a `404`, this is a statement that the resource will not come back, so there is nothing to poll for.## Common causes- The endpoint belongs to a retired API version- The resource was permanently deleted rather than cancelled## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/gone\", \"title\": \"Gone\", \"status\": 410, \"detail\": \"This resource is no longer available\", \"code\": \"gone\", \"trace_id\": \"abc123def456\", \"errors\": []}```## How to resolveDo not retry. If the endpoint has been retired, move to the current version -- see [Versioning](/versioning/) for how versions are published and withdrawn. Otherwise stop requesting the resource and remove any stored reference to it.", + "url": "/partner/v2/problems/gone/" + } + , + + "partner-v2-problems": { + "title": "Error Responses", + "content": "# Error ResponsesThis page is the reference for the problem `type` URIs the API returns. For guidance on how your integration should respond to each one -- when to retry, what to show the customer -- see the [error handling guide](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/errors.md) in [partner-api-documentation](https://github.com/holidayextras/partner-api-documentation), which is the source of truth for Partner API documentation.Every error returned by Partner API v2 uses the same problem details body, served as `application/problem+json`:```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/conflict\", \"title\": \"Conflict\", \"status\": 409, \"detail\": \"The amendment token has expired\", \"code\": \"token_expired\", \"trace_id\": \"abc123def456\", \"errors\": []}```| Field | Description ||-------|-------------|| `type` | A stable URI identifying the class of problem. It resolves to the page for that problem, listed below. || `title` | A short, human-readable summary of the problem class. || `status` | The HTTP status code, repeated in the body. || `detail` | A human-readable explanation of this specific occurrence. Always `null` on a `5xx`. || `code` | A machine-readable value for this specific occurrence. Branch on this, not on `title` or `detail`. || `trace_id` | The identifier to quote when contacting support. Present whenever a trace is available. || `errors` | Field-level failures, each with `field`, `message` and an optional `code`. Always empty on a `5xx`. |## `type` and `code` are not the same thing`type` names the class of problem and is drawn from the fixed list below. `code` names the specific occurrence and can be more precise than the `type`. In the example above, an expired amendment token is a conflict, so `type` is `.../conflict`, but `code` is the narrower `token_expired`.Treat `type` as the stable link to documentation and `code` as the value your integration switches on. A new `code` can appear within an existing `type` without the `type` changing, so match `code` values you know and fall back on `status` for the rest rather than failing closed on an unrecognised value.## Problem types| Status | Canonical `code` | Problem ||--------|------------------|---------|| 400 | `bad_request` | [Bad Request](/partner/v2/problems/bad-request/) || 401 | `unauthorized` | [Unauthorized](/partner/v2/problems/unauthorized/) || 403 | `forbidden` | [Forbidden](/partner/v2/problems/forbidden/) || 404 | `resource_not_found` | [Resource Not Found](/partner/v2/problems/resource-not-found/) || 405 | `method_not_allowed` | [Method Not Allowed](/partner/v2/problems/method-not-allowed/) || 406 | `not_acceptable` | [Not Acceptable](/partner/v2/problems/not-acceptable/) || 408 | `request_timeout` | [Request Timeout](/partner/v2/problems/request-timeout/) || 409 | `conflict` | [Conflict](/partner/v2/problems/conflict/) || 410 | `gone` | [Gone](/partner/v2/problems/gone/) || 415 | `unsupported_media_type` | [Unsupported Media Type](/partner/v2/problems/unsupported-media-type/) || 422 | `unprocessable_entity` | [Unprocessable Entity](/partner/v2/problems/unprocessable-entity/) || 425 | `too_early` | [Too Early](/partner/v2/problems/too-early/) || 429 | `too_many_requests` | [Too Many Requests](/partner/v2/problems/too-many-requests/) || 500 | `internal_error` | [Internal Server Error](/partner/v2/problems/internal-error/) || 502 | `bad_gateway` | [Bad Gateway](/partner/v2/problems/bad-gateway/) || 502 | `upstream_error` | [Upstream Error](/partner/v2/problems/upstream-error/) || 503 | `service_unavailable` | [Service Unavailable](/partner/v2/problems/service-unavailable/) || 503 | `dependency_unavailable` | [Dependency Unavailable](/partner/v2/problems/dependency-unavailable/) || 504 | `gateway_timeout` | [Gateway Timeout](/partner/v2/problems/gateway-timeout/) |## Retrying`4xx` problems describe something about the request and will fail again unchanged -- fix the request rather than retrying it. The exceptions are [Request Timeout](/partner/v2/problems/request-timeout/), [Too Early](/partner/v2/problems/too-early/) and [Too Many Requests](/partner/v2/problems/too-many-requests/), where the request itself was never processed and a later attempt can succeed.`5xx` problems are server-side and usually transient. Retry with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts, then contact support with the `trace_id`.When retrying a write -- creating a booking, or confirming an amendment or cancellation -- always send the **same** `Idempotency-Key` as the original request. A retry with a fresh key can duplicate an operation that had already succeeded.", + "url": "/partner/v2/problems/" + } + , + "partner-v2-problems-internal-error": { "title": "Internal Server Error", "content": "# Internal Server Error| Field | Value ||-------|-------|| **Status** | 500 || **Code** | `internal_error` |An unexpected error occurred on the server. This is a transient error and can be retried.## Retry guidance- Wait at least 2 seconds before the first retry- Use exponential backoff (e.g. 2s, 4s, 8s)- Stop retrying after 3 attemptsIf the error persists, contact support with the `trace_id` from the response.## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/internal-error\", \"title\": \"Internal Server Error\", \"status\": 500, \"code\": \"internal_error\", \"trace_id\": \"abc123def456\", \"errors\": []}```## How to resolveRetry the request with exponential backoff. If the error persists after multiple retries, raise it with your Holiday Extras integration contact and include the `trace_id` value.", @@ -589,6 +624,13 @@ } , + "partner-v2-problems-request-timeout": { + "title": "Request Timeout", + "content": "# Request Timeout| Field | Value ||-------|-------|| **Status** | 408 || **Code** | `request_timeout` |The request was not completed within the time the server was prepared to wait for it. Nothing was processed, so no booking or amendment will have been made.## Common causes- The request body was sent too slowly, or the connection stalled part-way through- A connection was opened and held without a complete request being sent- Network conditions between your client and the API delayed the request## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/request-timeout\", \"title\": \"Request Timeout\", \"status\": 408, \"detail\": \"Request Timeout\", \"code\": \"request_timeout\", \"trace_id\": \"abc123def456\", \"errors\": []}```## How to resolveRetry the request on a new connection. Because nothing was processed, a retry is safe. If timeouts recur, check for network issues or proxies between your client and the API, and confirm your client sends the full request body without long pauses.", + "url": "/partner/v2/problems/request-timeout/" + } + , + "partner-v2-problems-resource-not-found": { "title": "Resource Not Found", "content": "# Resource Not Found| Field | Value ||-------|-------|| **Status** | 404 || **Code** | `resource_not_found` |The requested resource does not exist. This is a permanent error -- retrying with the same parameters will not succeed.## Common causes- Booking reference does not exist- Location code not found for the requested currency## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/resource-not-found\", \"title\": \"Resource not found\", \"status\": 404, \"code\": \"resource_not_found\", \"errors\": [ { \"field\": \"reference\", \"message\": \"Booking with reference ZZZZZZQ not found\" } ]}```## How to resolveVerify the identifier you are using (e.g. booking reference) is correct. A 404 means the resource does not exist -- do not retry automatically.", @@ -596,6 +638,13 @@ } , + "partner-v2-problems-service-unavailable": { + "title": "Service Unavailable", + "content": "# Service Unavailable| Field | Value ||-------|-------|| **Status** | 503 || **Code** | `service_unavailable` |The service is temporarily unable to handle the request. This is a transient, server-side condition and can be retried.## Common causes- A service is being deployed or restarted- A service is shedding load while it recovers- A downstream booking or content service reported itself unavailable## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/service-unavailable\", \"title\": \"Service Unavailable\", \"status\": 503, \"detail\": null, \"code\": \"service_unavailable\", \"trace_id\": \"abc123def456\", \"errors\": []}````detail` is always `null` and `errors` always empty on a `5xx` -- server-side failures are described by `code` and `trace_id`, not by a message.## How to resolveRetry the request with exponential backoff (e.g. 2s, 4s, 8s) and stop after 3 attempts. If the error persists, contact support with the `trace_id` from the response. See also [Dependency Unavailable](/partner/v2/problems/dependency-unavailable/), the other `503` this API can return.", + "url": "/partner/v2/problems/service-unavailable/" + } + , + "partner-v2-problems-too-early": { "title": "Too Early", "content": "# Too Early| Field | Value ||-------|-------|| **Status** | 425 || **Code** | `too_early` |The request was made too early. The booking or resource is not yet in a state where this operation can be performed.## Common causes- Attempting to view or modify a booking that is still being processed- Polling for a booking status before the asynchronous creation has completed## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/too-early\", \"title\": \"Too Early\", \"status\": 425, \"code\": \"too_early\", \"errors\": [ { \"message\": \"Booking is still being processed\" } ]}```## How to resolveWait and retry using the `recommended_polling_seconds` value from the booking creation response. Use exponential backoff if the error persists.", @@ -603,6 +652,20 @@ } , + "partner-v2-problems-too-many-requests": { + "title": "Too Many Requests", + "content": "# Too Many Requests| Field | Value ||-------|-------|| **Status** | 429 || **Code** | `too_many_requests` |The request rate limit for your account has been exceeded. The request was rejected before it was processed, so nothing was created or changed.## Common causes- Sustained request volume above the rate agreed for your account- A burst of parallel requests, such as a batch job started all at once- A retry loop with no backoff, which multiplies the original request rate## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/too-many-requests\", \"title\": \"Too Many Requests\", \"status\": 429, \"detail\": \"Rate limit exceeded\", \"code\": \"too_many_requests\", \"trace_id\": \"abc123def456\", \"errors\": []}```## How to resolveBack off before retrying. If the response carries a `Retry-After` header, wait at least that long; otherwise retry with exponential backoff (e.g. 1s, 2s, 4s) and add jitter so parallel clients do not retry in lockstep. Cap the number of concurrent in-flight requests rather than relying on retries alone. If your integration needs a higher limit, contact your account manager.", + "url": "/partner/v2/problems/too-many-requests/" + } + , + + "partner-v2-problems-unauthorized": { + "title": "Unauthorized", + "content": "# Unauthorized| Field | Value ||-------|-------|| **Status** | 401 || **Code** | `unauthorized` |The request did not carry credentials the API could verify. Responses to this problem also carry a `WWW-Authenticate: Bearer` header.## Common causes- No `Authorization` header was sent, or it was not in the form `Bearer {token}`- The access token has expired- The token was issued by a different environment to the one being called (a staging token against production, or the reverse)- The token's signature could not be verified## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/unauthorized\", \"title\": \"Unauthorized\", \"status\": 401, \"detail\": \"Invalid or expired token\", \"code\": \"unauthorized\", \"trace_id\": \"abc123def456\", \"errors\": []}```## How to resolveRequest a fresh access token from the token endpoint and retry once with the new token. See the [Authentication integration guide](https://github.com/holidayextras/partner-api-documentation/blob/main/docs/integration-guides/02-authentication.md) for the client credentials flow. Do not retry with the same token -- it will fail again. If a newly issued token is still rejected, check that the token and the API host belong to the same environment, then contact support with the `trace_id`.", + "url": "/partner/v2/problems/unauthorized/" + } + , + "partner-v2-problems-unprocessable-entity": { "title": "Unprocessable Entity", "content": "# Unprocessable Entity| Field | Value ||-------|-------|| **Status** | 422 || **Code** | `unprocessable_entity` |The request is well-formed but contains values that cannot be processed. Check the `errors` array for details.## Common causes- Location and currency combination is not supported (e.g. searching for a UK-only airport in EUR)- Product token has expired or is invalid- Business rule violation (e.g. parking exit before entry)## Example response```json{ \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/unprocessable-entity\", \"title\": \"Unprocessable Entity\", \"status\": 422, \"code\": \"unprocessable_entity\", \"errors\": [ { \"field\": \"product_token\", \"message\": \"Product token has expired\" } ]}```## How to resolveReview the `errors` array for specific field-level details. Unlike a 400 (malformed request), a 422 means the request format is correct but the values are not valid for processing.", From 3bb1e900cf095b1e3fe965ecbe0e138d6b48aa04 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 3 Sep 2026 10:50:58 +0000 Subject: [PATCH 3/4] Update dist --- docs/feed.xml | 2 +- docs/hxapi/asynchronous-bookings/index.html | 8 +- docs/hxapi/carhire/availability/index.html | 4 +- docs/hxapi/parking/av/airport/index.html | 20 +- docs/hxapi/productlibrary/index.html | 28 +-- docs/hxapi/transfers/av/index.html | 24 +- docs/hxapi/transfers/cancel/index.html | 4 +- .../transfers/cancellation-policy/index.html | 8 +- docs/hxapi/transfers/view/index.html | 4 +- docs/hxapi/upgrade/index.html | 16 +- docs/hxapi/viewamendcancel/view/index.html | 20 +- docs/search/index.html | 210 +++++++++--------- 12 files changed, 174 insertions(+), 174 deletions(-) diff --git a/docs/feed.xml b/docs/feed.xml index 2de2282b..8cc53840 100644 --- a/docs/feed.xml +++ b/docs/feed.xml @@ -1,2 +1,2 @@ -Jekyll2026-09-03T10:43:06+00:00/feed.xmlHoliday Extras APIDocumentation to give to partners who would like to integrate with our API. +Jekyll2026-09-03T10:50:55+00:00/feed.xmlHoliday Extras APIDocumentation to give to partners who would like to integrate with our API. \ No newline at end of file diff --git a/docs/hxapi/asynchronous-bookings/index.html b/docs/hxapi/asynchronous-bookings/index.html index d74a5f4a..dd066c59 100644 --- a/docs/hxapi/asynchronous-bookings/index.html +++ b/docs/hxapi/asynchronous-bookings/index.html @@ -77,7 +77,7 @@

                                                                                                                                                                                          Availability Request

                                                                                                                                                                                          UK Products Availability Request

                                                                                                                                                                                          -
                                                                                                                                                                                            +
                                                                                                                                                                                            • XML
                                                                                                                                                                                            • @@ -85,7 +85,7 @@

                                                                                                                                                                                              UK Products Availability Request

                                                                                                                                                                                            -
                                                                                                                                                                                              +
                                                                                                                                                                                              • https://api.holidayextras.com/v1/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-01-07&ArrivalTime=1200&DepartDate=2025-01-08&DepartTime=1200&NumberOfPax=1&includeAsyncOnlyProducts=true
                                                                                                                                                                                                @@ -102,7 +102,7 @@ 

                                                                                                                                                                                                UK Products Availability Request

                                                                                                                                                                                                European Products Availability Request

                                                                                                                                                                                                -
                                                                                                                                                                                                  +
                                                                                                                                                                                                  • XML
                                                                                                                                                                                                  • @@ -110,7 +110,7 @@

                                                                                                                                                                                                    European Products Availability R

                                                                                                                                                                                                  -
                                                                                                                                                                                                    +
                                                                                                                                                                                                    • https://api.holidayextras.com/v1/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-12-01&ArrivalTime=1200&DepartDate=2025-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en&includeAsyncOnlyProducts=true
                                                                                                                                                                                                      diff --git a/docs/hxapi/carhire/availability/index.html b/docs/hxapi/carhire/availability/index.html
                                                                                                                                                                                                      index d518e9c8..699892d5 100644
                                                                                                                                                                                                      --- a/docs/hxapi/carhire/availability/index.html
                                                                                                                                                                                                      +++ b/docs/hxapi/carhire/availability/index.html
                                                                                                                                                                                                      @@ -53,7 +53,7 @@ 

                                                                                                                                                                                                      Request

                                                                                                                                                                                                      Example request:

                                                                                                                                                                                                      -
                                                                                                                                                                                                        +
                                                                                                                                                                                                        • XML
                                                                                                                                                                                                        • @@ -61,7 +61,7 @@

                                                                                                                                                                                                          Request

                                                                                                                                                                                                        -
                                                                                                                                                                                                          +
                                                                                                                                                                                                          • https://api.holidayextras.com/v1/sandbox/carHire/products?key=1&From=06NOV16&ArrivalTime=1200&To=13NOV&DepartTime=1600&PickupLocation=FL965&DropoffLocation=FL965&DateOfBirth=1990-10-13
                                                                                                                                                                                                            diff --git a/docs/hxapi/parking/av/airport/index.html b/docs/hxapi/parking/av/airport/index.html
                                                                                                                                                                                                            index dd959290..02b66343 100644
                                                                                                                                                                                                            --- a/docs/hxapi/parking/av/airport/index.html
                                                                                                                                                                                                            +++ b/docs/hxapi/parking/av/airport/index.html
                                                                                                                                                                                                            @@ -49,7 +49,7 @@ 

                                                                                                                                                                                                            Endpoint

                                                                                                                                                                                                            For example, for London Gatwick the endpoint is:

                                                                                                                                                                                                            -
                                                                                                                                                                                                              +
                                                                                                                                                                                                              • XML
                                                                                                                                                                                                              • @@ -57,7 +57,7 @@

                                                                                                                                                                                                                Endpoint

                                                                                                                                                                                                              -
                                                                                                                                                                                                                +
                                                                                                                                                                                                                • https://api.holidayextras.com/v1/carpark/LGW
                                                                                                                                                                                                                  @@ -444,7 +444,7 @@ 

                                                                                                                                                                                                                  Worked Examples

                                                                                                                                                                                                                  UK Products Availability Request

                                                                                                                                                                                                                  -
                                                                                                                                                                                                                    +
                                                                                                                                                                                                                    • XML
                                                                                                                                                                                                                    • @@ -452,7 +452,7 @@

                                                                                                                                                                                                                      UK Products Availability Request

                                                                                                                                                                                                                    -
                                                                                                                                                                                                                      +
                                                                                                                                                                                                                      • https://api.holidayextras.com/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1
                                                                                                                                                                                                                        @@ -471,7 +471,7 @@ 

                                                                                                                                                                                                                        UK Products Availability Response

                                                                                                                                                                                                                        NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                        -
                                                                                                                                                                                                                          +
                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                          • @@ -479,7 +479,7 @@

                                                                                                                                                                                                                            UK Products Availability Response

                                                                                                                                                                                                                            -
                                                                                                                                                                                                                              +
                                                                                                                                                                                                                              • <?xml version="1.0"?>
                                                                                                                                                                                                                                @@ -707,7 +707,7 @@ 

                                                                                                                                                                                                                                UK Products Availability Response

                                                                                                                                                                                                                                European Products Availability Request -
                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                  • @@ -715,7 +715,7 @@

                                                                                                                                                                                                                                    European Products Availability R

                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                    • https://api.holidayextras.com/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en
                                                                                                                                                                                                                                      @@ -734,7 +734,7 @@ 

                                                                                                                                                                                                                                      European Products Availability

                                                                                                                                                                                                                                      NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                        • XML
                                                                                                                                                                                                                                        • @@ -742,7 +742,7 @@

                                                                                                                                                                                                                                          European Products Availability

                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                          • <?xml version="1.0"?>
                                                                                                                                                                                                                                            diff --git a/docs/hxapi/productlibrary/index.html b/docs/hxapi/productlibrary/index.html
                                                                                                                                                                                                                                            index fd5b198c..a25087c3 100644
                                                                                                                                                                                                                                            --- a/docs/hxapi/productlibrary/index.html
                                                                                                                                                                                                                                            +++ b/docs/hxapi/productlibrary/index.html
                                                                                                                                                                                                                                            @@ -83,7 +83,7 @@ 

                                                                                                                                                                                                                                            Available Fields

                                                                                                                                                                                                                                            The available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.

                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                              • Parking
                                                                                                                                                                                                                                              • @@ -97,7 +97,7 @@

                                                                                                                                                                                                                                                Available Fields

                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                • @@ -968,7 +968,7 @@

                                                                                                                                                                                                                                                  Example 1 - Default Response

                                                                                                                                                                                                                                                  Request

                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                    + -
                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                      • https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey
                                                                                                                                                                                                                                                        @@ -1008,7 +1008,7 @@ 

                                                                                                                                                                                                                                                        Request

                                                                                                                                                                                                                                                        Response

                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                          • @@ -1016,7 +1016,7 @@

                                                                                                                                                                                                                                                            Response

                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                            • <?xml version="1.0"?>
                                                                                                                                                                                                                                                              @@ -1403,7 +1403,7 @@ 

                                                                                                                                                                                                                                                              Example 2 - Restricted field list

                                                                                                                                                                                                                                                              Request

                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                        + -
                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                          • https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude
                                                                                                                                                                                                                                            @@ -1443,7 +1443,7 @@ 

                                                                                                                                                                                                                                            Request

                                                                                                                                                                                                                                            Response

                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                              • XML
                                                                                                                                                                                                                                              • @@ -1451,7 +1451,7 @@

                                                                                                                                                                                                                                                Response

                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                • <?xml version="1.0"?>
                                                                                                                                                                                                                                                  @@ -1512,7 +1512,7 @@ 

                                                                                                                                                                                                                                                  Request

                                                                                                                                                                                                                                                  Requests for German products return a different set of fields. Explanation of fields not currently available.

                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                    + -
                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                      • https://api.holidayextras.com/v1/product/FRA0?key=mytestkey
                                                                                                                                                                                                                                                        @@ -1552,7 +1552,7 @@ 

                                                                                                                                                                                                                                                        Request

                                                                                                                                                                                                                                                        Response

                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                          • @@ -1560,7 +1560,7 @@

                                                                                                                                                                                                                                                            Response

                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                            • <?xml version="1.0"?>
                                                                                                                                                                                                                                                              diff --git a/docs/hxapi/transfers/av/index.html b/docs/hxapi/transfers/av/index.html
                                                                                                                                                                                                                                                              index 0a07c4c5..c92d3643 100644
                                                                                                                                                                                                                                                              --- a/docs/hxapi/transfers/av/index.html
                                                                                                                                                                                                                                                              +++ b/docs/hxapi/transfers/av/index.html
                                                                                                                                                                                                                                                              @@ -856,7 +856,7 @@ 

                                                                                                                                                                                                                                                              Worked Examples

                                                                                                                                                                                                                                                              Airport to GIATA

                                                                                                                                                                                                                                                              Request
                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                • @@ -864,7 +864,7 @@
                                                                                                                                                                                                                                                                  Request
                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                  • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602
                                                                                                                                                                                                                                                                    @@ -882,7 +882,7 @@ 
                                                                                                                                                                                                                                                                    Request
                                                                                                                                                                                                                                                                    Response

                                                                                                                                                                                                                                                                    NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                      • XML
                                                                                                                                                                                                                                                                      • @@ -890,7 +890,7 @@
                                                                                                                                                                                                                                                                        Response
                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                        • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 13:06:41">
                                                                                                                                                                                                                                                                          @@ -1128,7 +1128,7 @@ 
                                                                                                                                                                                                                                                                          Response

                                                                                                                                                                                                                                                                          Airport to TTI

                                                                                                                                                                                                                                                                          Request
                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                            • XML
                                                                                                                                                                                                                                                                            • @@ -1136,7 +1136,7 @@
                                                                                                                                                                                                                                                                              Request
                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                              • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602
                                                                                                                                                                                                                                                                                @@ -1155,7 +1155,7 @@ 
                                                                                                                                                                                                                                                                                Response

                                                                                                                                                                                                                                                                                NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                                                                  • @@ -1163,7 +1163,7 @@
                                                                                                                                                                                                                                                                                    Response
                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                    • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 13:06:41">
                                                                                                                                                                                                                                                                                      @@ -1400,7 +1400,7 @@ 
                                                                                                                                                                                                                                                                                      Response

                                                                                                                                                                                                                                                                                      Airport to Postal Address

                                                                                                                                                                                                                                                                                      Request
                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                        • XML
                                                                                                                                                                                                                                                                                        • @@ -1408,7 +1408,7 @@
                                                                                                                                                                                                                                                                                          Request
                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                          • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602
                                                                                                                                                                                                                                                                                            @@ -1427,7 +1427,7 @@ 
                                                                                                                                                                                                                                                                                            Response

                                                                                                                                                                                                                                                                                            NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                              • XML
                                                                                                                                                                                                                                                                                              • @@ -1435,7 +1435,7 @@
                                                                                                                                                                                                                                                                                                Response
                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 16:31:35">
                                                                                                                                                                                                                                                                                                  diff --git a/docs/hxapi/transfers/cancel/index.html b/docs/hxapi/transfers/cancel/index.html
                                                                                                                                                                                                                                                                                                  index 55cc7cb6..8e09e684 100644
                                                                                                                                                                                                                                                                                                  --- a/docs/hxapi/transfers/cancel/index.html
                                                                                                                                                                                                                                                                                                  +++ b/docs/hxapi/transfers/cancel/index.html
                                                                                                                                                                                                                                                                                                  @@ -160,7 +160,7 @@ 

                                                                                                                                                                                                                                                                                                  Cancel Booking Response

                                                                                                                                                                                                                                                                                                  Example

                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                    • XML
                                                                                                                                                                                                                                                                                                    • @@ -168,7 +168,7 @@

                                                                                                                                                                                                                                                                                                      Example

                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                      • <Booking>
                                                                                                                                                                                                                                                                                                        diff --git a/docs/hxapi/transfers/cancellation-policy/index.html b/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                                                                                                                                                                                                        index 4b3a2e9f..cff54ad6 100644
                                                                                                                                                                                                                                                                                                        --- a/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                                                                                                                                                                                                        +++ b/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                                                                                                                                                                                                        @@ -145,7 +145,7 @@ 

                                                                                                                                                                                                                                                                                                        Cancellation Policy Response

                                                                                                                                                                                                                                                                                                        Example

                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                                                                          • @@ -153,7 +153,7 @@

                                                                                                                                                                                                                                                                                                            Example

                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                            • <BookingRef>TB12345</BookingRef>
                                                                                                                                                                                                                                                                                                              @@ -179,7 +179,7 @@ 

                                                                                                                                                                                                                                                                                                              Example

                                                                                                                                                                                                                                                                                                              Example - Non-Cancellable Booking

                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                                                                • @@ -187,7 +187,7 @@

                                                                                                                                                                                                                                                                                                                  Example - Non-Cancellable Booking

                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                    • <BookingRef>TB12345</BookingRef>
                                                                                                                                                                                                                                                                                                                      diff --git a/docs/hxapi/transfers/view/index.html b/docs/hxapi/transfers/view/index.html
                                                                                                                                                                                                                                                                                                                      index a9b771d4..3a4a1c37 100644
                                                                                                                                                                                                                                                                                                                      --- a/docs/hxapi/transfers/view/index.html
                                                                                                                                                                                                                                                                                                                      +++ b/docs/hxapi/transfers/view/index.html
                                                                                                                                                                                                                                                                                                                      @@ -295,7 +295,7 @@ 

                                                                                                                                                                                                                                                                                                                      FlightDetails Fields

                                                                                                                                                                                                                                                                                                                      Example

                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                        • XML
                                                                                                                                                                                                                                                                                                                        • @@ -303,7 +303,7 @@

                                                                                                                                                                                                                                                                                                                          Example

                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                          • <Booking>
                                                                                                                                                                                                                                                                                                                            diff --git a/docs/hxapi/upgrade/index.html b/docs/hxapi/upgrade/index.html
                                                                                                                                                                                                                                                                                                                            index 0e49d66f..c4c0cc48 100644
                                                                                                                                                                                                                                                                                                                            --- a/docs/hxapi/upgrade/index.html
                                                                                                                                                                                                                                                                                                                            +++ b/docs/hxapi/upgrade/index.html
                                                                                                                                                                                                                                                                                                                            @@ -239,7 +239,7 @@ 

                                                                                                                                                                                                                                                                                                                            Example 1 - Carpark Upgrades

                                                                                                                                                                                                                                                                                                                            Request

                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                              • XML
                                                                                                                                                                                                                                                                                                                              • @@ -247,7 +247,7 @@

                                                                                                                                                                                                                                                                                                                                Request

                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                • https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45
                                                                                                                                                                                                                                                                                                                                  @@ -265,7 +265,7 @@ 

                                                                                                                                                                                                                                                                                                                                  Request

                                                                                                                                                                                                                                                                                                                                  Response

                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                    • XML
                                                                                                                                                                                                                                                                                                                                    • @@ -273,7 +273,7 @@

                                                                                                                                                                                                                                                                                                                                      Response

                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                      • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                        @@ -610,7 +610,7 @@ 

                                                                                                                                                                                                                                                                                                                                        Example 1 - Hotel Upgrades

                                                                                                                                                                                                                                                                                                                                        Request

                                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                                                                                                          • @@ -618,7 +618,7 @@

                                                                                                                                                                                                                                                                                                                                            Request

                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                            • https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45
                                                                                                                                                                                                                                                                                                                                              @@ -634,7 +634,7 @@ 

                                                                                                                                                                                                                                                                                                                                              Request

                                                                                                                                                                                                                                                                                                                                              Response

                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                                                                                                • @@ -642,7 +642,7 @@

                                                                                                                                                                                                                                                                                                                                                  Response

                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                  • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                    diff --git a/docs/hxapi/viewamendcancel/view/index.html b/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                                                                                                                                                                                                                    index d76db8f8..3fa86f2a 100644
                                                                                                                                                                                                                                                                                                                                                    --- a/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                                                                                                                                                                                                                    +++ b/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                                                                                                                                                                                                                    @@ -46,7 +46,7 @@ 

                                                                                                                                                                                                                                                                                                                                                    Endpoint

                                                                                                                                                                                                                                                                                                                                                    The endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):

                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                      • XML
                                                                                                                                                                                                                                                                                                                                                      • @@ -54,7 +54,7 @@

                                                                                                                                                                                                                                                                                                                                                        Endpoint

                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                        • https://api.holidayextras.com/v1/booking/YourBookingRef
                                                                                                                                                                                                                                                                                                                                                          @@ -358,7 +358,7 @@ 

                                                                                                                                                                                                                                                                                                                                                          UK Products View Booking (for a

                                                                                                                                                                                                                                                                                                                                                          Request

                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                            • XML
                                                                                                                                                                                                                                                                                                                                                            • @@ -366,7 +366,7 @@

                                                                                                                                                                                                                                                                                                                                                              Request

                                                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                              • https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com
                                                                                                                                                                                                                                                                                                                                                                @@ -383,7 +383,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                Request

                                                                                                                                                                                                                                                                                                                                                                Response

                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                                                                                                                                                  • @@ -391,7 +391,7 @@

                                                                                                                                                                                                                                                                                                                                                                    Response

                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                    • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                      @@ -917,7 +917,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                      Response

                                                                                                                                                                                                                                                                                                                                                                      UK Products View Booking (for a transfer)

                                                                                                                                                                                                                                                                                                                                                                      Request

                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                        • XML
                                                                                                                                                                                                                                                                                                                                                                        • @@ -925,7 +925,7 @@

                                                                                                                                                                                                                                                                                                                                                                          Request

                                                                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                          • https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com
                                                                                                                                                                                                                                                                                                                                                                            @@ -942,7 +942,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                            Request

                                                                                                                                                                                                                                                                                                                                                                            Response

                                                                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                              • XML
                                                                                                                                                                                                                                                                                                                                                                              • @@ -950,7 +950,7 @@

                                                                                                                                                                                                                                                                                                                                                                                Response

                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                  diff --git a/docs/search/index.html b/docs/search/index.html
                                                                                                                                                                                                                                                                                                                                                                                  index 66efd16e..6698b9f6 100644
                                                                                                                                                                                                                                                                                                                                                                                  --- a/docs/search/index.html
                                                                                                                                                                                                                                                                                                                                                                                  +++ b/docs/search/index.html
                                                                                                                                                                                                                                                                                                                                                                                  @@ -43,13 +43,6 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-lounge-av-airport": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Availability At Lounge",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "Availability At LoungeLounge Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/AirportCodeFor example, for lounge availability at Gatwick the endpoint is:https://api.holidayextras.com/v1/lounge/LGWTo find the airport locations available for lounges, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer enters the lounge.              ArrivalTime      Time      HHMM      Y      Time customer enters the lounge.              Adults      Integer      [0-4] 1 char      Y      Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Children      Integer      [0-3] 1 char      N      Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Infants      Integer      1 char      N      Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              OutFlight      String      [A-Z0-9] 9 chars      N      This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal.              Terminal      String      [A-Z1-9] 1 char      N      An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ).              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      Required for requests for European products. (Values available are en, de, it, es, pt and nl.)              fields      String      [A-Z] a csv list of product info fields      N      A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint.      Lounge Availability ResponseThe lounge availability response will return the specific product requested, so long as it has availability on the specific dates and times. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Lounge/Name      The name of the lounge.              Lounge/Code      The product code for the lounge, which must be used in the booking request.              Lounge/BookingURL      The URL to POST the booking request to for this particular product.              Lounge/MoreInfoURL      The link to more information about this product, sourced from the Product Library.              Lounge/NonDiscPrice      The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.              Lounge/Price      The price of product without any surcharges/fees added.              Lounge/terminal      The terminal the lounge is in              API_Header/Request      The API returns every parameter and value you sent in the previous request.      Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Requesthttps://api.holidayextras.com/v1/lounge/LHR?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0UK Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:24:54\">    <Lounge>        <Name>Plaza Premium T5 lounge - 3 hours</Name>        <Code>LHRPA5</Code>        <BookingURL>/v1/lounge/HPLHRPA5</BookingURL>        <MoreInfoURL>/v1/product/LHRPA5</MoreInfoURL>        <NonDiscPrice>80.00</NonDiscPrice>        <Price>80.00</Price>        <terminal>5</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>No1 Lounge, Terminal 3, Heathrow</Name>        <Code>LHRNN3</Code>        <BookingURL>/v1/lounge/HPLHRNN3</BookingURL>        <MoreInfoURL>/v1/product/LHRNN3</MoreInfoURL>        <NonDiscPrice>64.00</NonDiscPrice>        <Price>64.00</Price>        <terminal>3</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>SkyTeam Lounge T4</Name>        <Code>LHRSTE</Code>        <BookingURL>/v1/lounge/HPLHRSTE</BookingURL>        <MoreInfoURL>/v1/product/LHRSTE</MoreInfoURL>        <NonDiscPrice>60.00</NonDiscPrice>        <Price>60.00</Price>        <terminal>4</terminal>        <option_count>14</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>2.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>4.00</CCardSurchargeMax>        <DCardSurchargePercent>0.00</DCardSurchargePercent>        <DCardSurchargeMin>0.00</DCardSurchargeMin>        <DCardSurchargeMax>0.00</DCardSurchargeMax>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <v>1</v>        </Request>    </API_Header></API_Reply>European Products Availability Requesthttps://api.holidayextras.com/v1/lounge/HAM?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0&System=ABG&lang=deEuropean Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:30:25\">    <Lounge>        <Name>Hamburg Airport Lounge</Name>        <Code>HAMLHL</Code>        <BookingURL>/v1/lounge/FRHAMLHL</BookingURL>        <MoreInfoURL>/v1/product/HAMLHL</MoreInfoURL>        <NonDiscPrice>74.00</NonDiscPrice>        <Price>74.00</Price>        <terminal>Z</terminal>        <option_count>1</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>0.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>0.00</CCardSurchargeMax>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <System>ABG</System>            <lang>de</lang>            <v>1</v>        </Request>    </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/lounge/av/airport/"
                                                                                                                                                                                                                                                                                                                                                                                  -      }
                                                                                                                                                                                                                                                                                                                                                                                  -      ,
                                                                                                                                                                                                                                                                                                                                                                                  -    
                                                                                                                                                                                                                                                                                                                                                                                         "hxapi-parking-av-airport": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Availability At Airport",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "Availability At AirportAPI Docs > product:Parking > endpoint:carpark > request:Availability by AirportAirport Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/AirportCodeFor example, for London Gatwick the endpoint is:\tXML\tJSON\thttps://api.holidayextras.com/v1/carpark/LGW\thttps://api.holidayextras.com/v1/carpark/LGW.jsNote the .js extension.To find the airport locations available for car parking, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              NumberOfPax      Integer      [0-9] 2 chars      N      Number of passengers.              OutFlight      String      [A-Z0-9] 9 chars      N      This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal.              Terminal      String      [A-Z1-9] 1 char      N      An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ).              filter      String      [A-Z]      N      Pass in values filter=on_airport, filter=recommended or filter=meet_and_greet to only show car parks meeting those criteria. You can filter by any field that comes back in the filter section of the API. Only a single filter can be used at once.              fields      String      [A-Z] a csv list of product info fields      N      A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint.              top3      Boolean      [0,1]      N      ⚠ Deprecated: This feature limited the search results to only 3 products, one onsite, one park and ride and one meet and greet. It is no longer supported and will be removed in future releases. Your account manager will work with you to ensure the best products are always returned first instead.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      Required for requests for European products. (Values available are en, de, it, es, pt and nl.)      Airport Availability ResponseThe airport availability response will return all the products that have availability at the requested location on specific dates and durations. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  CarPark/Name      The name of the product              CarPark/Code      The product code              CarPark/BookingURL      The URL to POST the booking request to for this particular product. Note: The product code includes prefix.              CarPark/MoreInfoURL      The link to more information about this product, sourced from the Product Library. Note: The product code doesn’t include prefix.              CarPark/RequestFlags      _NB. In Europe this will be replaced with <CarDetFlags>, see below for more info on these.These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request.Flags are only returned when required. The flags which can be returned are: Registration, CarMake, CarModel, CarColour, OutFlight, ReturnFlight, OutTerminal, ReturnTerminal, Destination, MobileNum.              CarPark/NonDiscPrice      The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.              CarPark/TotalPrice      The price of product without any surcharges/fees added.              CarPark/GatePrice      If available, the price of product if you were to turn up on the day.              CarPark/CanAmendCantCancel      Whether the product can be amend but not cancelled.              CarPark/CancellationFeeExceptions      If the carpark has non-standard cancellation fees.              CarPark/AmendmentFeeExceptions      If the carpark has non-standard amendment fees.              CarPark/Filter      We have a filter mechanism on our site, to show particular types of product, such as Meet and Greet. The filters that apply to a product are returned here. Possible values are: meet_and_greet, recommended, terminal, on_airport, valet_included, car_parked_for_you, park_and_stroll and park_and_ride.              Pricing/CreditCardSurcharge      NB: This is only relevant for Intermediary Agents in Europe, where Holiday Extras is responsible for processing the payment, not the Agent. The first step in the calculation is to determine the credit card surcharge payable (x), based on the value of the booking, using this formula: x = (TotalPrice + the CanxWaiver) / 100 x CCardSurchargePercent Second, to prevent the surcharge from exceeding certain boundaries we have min and max thresholds, which can be calculated as follows: if x < CCardSurchargeMin; x = CCardSurchargeMin else if x > CCardSurchargeMax; x = CCardSurchargeMax              Pricing/CancellationWaiver/Waiver      We provide an optional cancellation waiver. If this is not added then cancellation will incur a fee. This returns the cancellation fee cost.              API_Header/Request      The API returns every parameter and value you sent in the previous request.      CarDetFlags (Europe Only)For European products only, the availability response will return a field called <CarDetFlags>, which identifies the fields required when making a booking. (This is instead of the <RequestFlags> field which is returned for UK products only).For example: <CarDetFlags> NNNNNNNNNNNNNNNNNN </CarDetFlags>The order of the flags is always the same, and refers to these parameters respectively:            Position      Parameter      Data Type      Format      Additional Information                  1      Registration      String      See Expanded Formats      Vehicle registration number  NB: This field is not validated through the API.              2      CarMake      String      [A-Z0-9] 25 chars      Make of vehicle, e.g. Audi.              3      CarModel      String      [A-Z0-9] 25 chars      Model of vehicle, e.g. A6.              4      CarColour      String      [A-Z0-9] 25 chars      Colour of vehicle, e.g. White.              5      NumberOfPax      Integer      [0-9]      Number of passengers in the vehicle.              6      CarDropoffTime      Time      HHMM      Arrival time when you drop the vehicle off at the car park e.g 1000.              7      CarPickupTime      Time      HHMM      Return time, when you pick the vehicle up from the car park, e.g. 1600.              8      OutTerminal      String      [A-Z0-9] 2 chars      Single letter or number representation of the terminal e.g N or S or 4              9      OutFltNo      String      [A-Z0-9] 10 chars      Outbound flight number e.g. EZY123.              10      InFltNo      String      [A-Z0-9] 10 chars      Return flight number e.g. EZY124.              11      OutFltTime      Time      HHMM      Departure time of the outbound flight e.g. 1200.              12      InFltTime      Time      HHMM      Arrival time of the inbound flight e.g. 1500.              13      MobileNum      String      [A-Z0-9] 15 chars      Customer’s mobile number.              14      ShipName      String      [A-Z0-9] 20 chars      Name of the ship, e.g. AIDA              15      PierName      String      [A-Z0-9] 20 chars      Name of the pier or port where the ship is departing from              16      ChildSeat      String      Y/N      Is a child car seat needed?              17      AddlServices      String      [A-Z0-9] 50 chars      In this parameter you may add additional remarks regarding the booking.              18      RetTerminal      String      [A-Z0-9] 2 chars      Single letter or number representation of the terminal e.g N or S or 4      NB: Where length restrictions have been noted in the above formats, any additional characters present in a field will be ignored.Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Request\tXML\tJSON\thttps://api.holidayextras.com/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1\thttps://api.holidayextras.com/carpark/LGW.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1Note the .js extension.UK Products Availability ResponseNB: This is a shortened example compiled from a full availability response.\tXML\tJSON\t<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2019-12-06 17:31:56\">  <CarPark>    <Name>Purple Parking - all terminals</Name>    <Code>LGV9</Code>    <BookingURL>/carpark/HPLGV9</BookingURL>    <MoreInfoURL>/product/LGV9</MoreInfoURL>    <RequestFlags>      <CarColour>1</CarColour>      <CarMake>1</CarMake>      <CarModel>1</CarModel>      <Registration>1</Registration>      <ReturnFlight>1</ReturnFlight>    </RequestFlags>    <NonDiscPrice>20.99</NonDiscPrice>    <TotalPrice>19.94</TotalPrice>    <GatePrice>0.00</GatePrice>    <CanAmendCantCancel>0</CanAmendCantCancel>    <Filter>      <meet_and_greet>0</meet_and_greet>      <park_and_ride>1</park_and_ride>      <car_parked_for_you>1</car_parked_for_you>    </Filter>    <advance_purchase>1</advance_purchase>  </CarPark>  <CarPark>    <Name>Purple Parking Flexible - all terminals</Name>    <Code>LGV4</Code>    <BookingURL>/carpark/HPLGV4</BookingURL>    <MoreInfoURL>/product/LGV4</MoreInfoURL>    <RequestFlags>      <CarColour>1</CarColour>      <CarMake>1</CarMake>      <CarModel>1</CarModel>      <Registration>1</Registration>      <ReturnFlight>1</ReturnFlight>    </RequestFlags>    <NonDiscPrice>23.99</NonDiscPrice>    <TotalPrice>22.79</TotalPrice>    <GatePrice>0.00</GatePrice>    <CanAmendCantCancel>0</CanAmendCantCancel>    <Filter>      <meet_and_greet>0</meet_and_greet>      <park_and_ride>1</park_and_ride>      <car_parked_for_you>1</car_parked_for_you>    </Filter>  </CarPark>  <CarPark>    <Name>Purple Parking Winter Special</Name>    <Code>LGB3</Code>    <BookingURL>/carpark/HPLGB3</BookingURL>    <MoreInfoURL>/product/LGB3</MoreInfoURL>    <RequestFlags>      <CarColour>1</CarColour>      <CarMake>1</CarMake>      <CarModel>1</CarModel>      <Registration>1</Registration>      <ReturnFlight>1</ReturnFlight>    </RequestFlags>    <NonDiscPrice>21.59</NonDiscPrice>    <TotalPrice>20.94</TotalPrice>    <GatePrice>0.00</GatePrice>    <CanAmendCantCancel>0</CanAmendCantCancel>    <Filter>      <meet_and_greet>0</meet_and_greet>      <park_and_ride>1</park_and_ride>      <car_parked_for_you>1</car_parked_for_you>    </Filter>  </CarPark>  <Pricing>    <CCardSurchargePercent>0.00</CCardSurchargePercent>    <CCardSurchargeMin>0.00</CCardSurchargeMin>    <CCardSurchargeMax>0.00</CCardSurchargeMax>    <DCardSurchargePercent>0.00</DCardSurchargePercent>    <DCardSurchargeMin>0.00</DCardSurchargeMin>    <DCardSurchargeMax>0.00</DCardSurchargeMax>    <CancellationWaiver>      <Waiver>1.69</Waiver>    </CancellationWaiver>  </Pricing>  <SepaID/>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-01-07</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2020-01-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>    </Request>  </API_Header></API_Reply>\t{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"CarPark\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2019-12-06 17:33:10\"    },    \"CarPark\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Purple Parking - all terminals\",        \"Code\": \"LGV9\",        \"BookingURL\": \"/carpark/HPLGV9.js\",        \"MoreInfoURL\": \"/product/LGV9.js\",        \"_latitude\": 51.142779,        \"_longitude\": -0.211795,        \"RequestFlags\": {          \"CarColour\": 1,          \"CarMake\": 1,          \"CarModel\": 1,          \"Registration\": 1,          \"ReturnFlight\": 1        },        \"NonDiscPrice\": 20.99,        \"TotalPrice\": 19.94,        \"GatePrice\": \"0.00\",        \"CanAmendCantCancel\": \"\",        \"Filter\": {          \"meet_and_greet\": \"0\",          \"park_and_ride\": 1,          \"car_parked_for_you\": 1        },        \"advance_purchase\": true      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Purple Parking Flexible - all terminals\",        \"Code\": \"LGV4\",        \"BookingURL\": \"/carpark/HPLGV4.js\",        \"MoreInfoURL\": \"/product/LGV4.js\",        \"_latitude\": 51.142957,        \"_longitude\": -0.211055,        \"RequestFlags\": {          \"CarColour\": 1,          \"CarMake\": 1,          \"CarModel\": 1,          \"Registration\": 1,          \"ReturnFlight\": 1        },        \"NonDiscPrice\": 23.99,        \"TotalPrice\": 22.79,        \"GatePrice\": \"0.00\",        \"CanAmendCantCancel\": \"\",        \"Filter\": {          \"meet_and_greet\": \"0\",          \"park_and_ride\": 1,          \"car_parked_for_you\": 1        }      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Purple Parking Winter Special\",        \"Code\": \"LGB3\",        \"BookingURL\": \"/carpark/HPLGB3.js\",        \"MoreInfoURL\": \"/product/LGB3.js\",        \"_latitude\": 51.142557,        \"_longitude\": -0.210561,        \"RequestFlags\": {          \"CarColour\": 1,          \"CarMake\": 1,          \"CarModel\": 1,          \"Registration\": 1,          \"ReturnFlight\": 1        },        \"NonDiscPrice\": 21.59,        \"TotalPrice\": 20.94,        \"GatePrice\": \"0.00\",        \"CanAmendCantCancel\": \"\",        \"Filter\": {          \"meet_and_greet\": \"0\",          \"park_and_ride\": 1,          \"car_parked_for_you\": 1        }      }    ],    \"Pricing\": {      \"CCardSurchargePercent\": \"0.00\",      \"CCardSurchargeMin\": \"0.00\",      \"CCardSurchargeMax\": \"0.00\",      \"DCardSurchargePercent\": \"0.00\",      \"DCardSurchargeMin\": \"0.00\",      \"DCardSurchargeMax\": \"0.00\",      \"CancellationWaiver\": [        {          \"Waiver\": 1.69        }      ]    },    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"ArrivalDate\": \"2020-01-07\",        \"ArrivalTime\": 1200,        \"DepartDate\": \"2020-01-08\",        \"DepartTime\": 1200,        \"NumberOfPax\": 1,        \"format\": \"js\"      }    }  }}European Products Availability Request\tXML\tJSON\thttps://api.holidayextras.com/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en\thttps://api.holidayextras.com/carpark/MUC.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=enNote the .js extension.European Products Availability ResponseNB: This is a shortened example compiled from a full availability response.\tXML\tJSON\t<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2019-12-06 18:07:40\">  <CarPark>    <Name>Airparks Parkplatz München Frühbucher</Name>    <Code>MUCC</Code>    <BookingURL>/carpark/FRMUCC</BookingURL>    <MoreInfoURL>/product/MUCC</MoreInfoURL>    <RequestFlags/>    <NonDiscPrice>46.00</NonDiscPrice>    <TotalPrice>46.00</TotalPrice>    <GatePrice>0.00</GatePrice>    <CancellationRule>0</CancellationRule>    <CarDetFlags>NNNNNNNNNNNNNNNNNN</CarDetFlags>    <CarDetails>Y</CarDetails>    <DiscDates/>    <Filter>      <car_parked_for_you>1</car_parked_for_you>      <meet_and_greet>0</meet_and_greet>      <park_and_stroll/>      <on_airport/>      <recommended/>      <special_offer_text>1</special_offer_text>      <valet_included>0</valet_included>      <park_and_ride>1</park_and_ride>    </Filter>  </CarPark>  <CarPark>    <Name>Parkservice Sky München</Name>    <Code>MU01</Code>    <BookingURL>/carpark/FRMU01</BookingURL>    <MoreInfoURL>/product/MU01</MoreInfoURL>    <RequestFlags/>    <NonDiscPrice>28.00</NonDiscPrice>    <TotalPrice>28.00</TotalPrice>    <GatePrice>0.00</GatePrice>    <CancellationRule>0</CancellationRule>    <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags>    <CarDetails>Y</CarDetails>    <DiscDates/>    <Filter>      <car_parked_for_you>0</car_parked_for_you>      <meet_and_greet>0</meet_and_greet>      <park_and_stroll/>      <on_airport/>      <recommended/>      <special_offer_text>0</special_offer_text>      <valet_included>0</valet_included>      <park_and_ride>1</park_and_ride>    </Filter>  </CarPark>  <CarPark>    <Name>Parkservice Sky München Winteraktion</Name>    <Code>MU03</Code>    <BookingURL>/carpark/FRMU03</BookingURL>    <MoreInfoURL>/product/MU03</MoreInfoURL>    <RequestFlags/>    <NonDiscPrice>39.99</NonDiscPrice>    <TotalPrice>39.99</TotalPrice>    <GatePrice>0.00</GatePrice>    <CancellationRule>0</CancellationRule>    <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags>    <CarDetails>Y</CarDetails>    <DiscDates/>    <Filter>      <car_parked_for_you>0</car_parked_for_you>      <meet_and_greet>0</meet_and_greet>      <park_and_stroll/>      <on_airport/>      <recommended/>      <special_offer_text>1</special_offer_text>      <valet_included>0</valet_included>      <park_and_ride>1</park_and_ride>    </Filter>  </CarPark>  <Pricing>    <CCardSurchargePercent>0.00</CCardSurchargePercent>    <CCardSurchargeMin>0.00</CCardSurchargeMin>    <CCardSurchargeMax>0.00</CCardSurchargeMax>  </Pricing>  <SepaID>DE11ZZZ00000633860</SepaID>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-01-07</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2020-01-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <System>ABG</System>      <lang>en</lang>    </Request>  </API_Header></API_Reply>\t{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"CarPark\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2019-12-06 18:26:33\"    },    \"CarPark\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Airparks Parkplatz München Frühbucher\",        \"Code\": \"MUCC\",        \"BookingURL\": \"/carpark/FRMUCC.js\",        \"MoreInfoURL\": \"/product/MUCC.js\",        \"_latitude\": 48.35101,        \"_longitude\": 11.8348,        \"RequestFlags\": {},        \"NonDiscPrice\": 46,        \"TotalPrice\": 46,        \"GatePrice\": \"0.00\",        \"CancellationRule\": \"0\",        \"CarDetFlags\": \"NNNNNNNNNNNNNNNNNN\",        \"CarDetails\": \"Y\",        \"DiscDates\": \"\",        \"Filter\": {          \"car_parked_for_you\": 1,          \"meet_and_greet\": \"0\",          \"park_and_stroll\": \"\",          \"on_airport\": null,          \"recommended\": null,          \"special_offer_text\": 1,          \"valet_included\": \"0\",          \"park_and_ride\": 1        }      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Parkservice Sky München\",        \"Code\": \"MU01\",        \"BookingURL\": \"/carpark/FRMU01.js\",        \"MoreInfoURL\": \"/product/MU01.js\",        \"_latitude\": 48.384242,        \"_longitude\": 11.778148,        \"RequestFlags\": {},        \"NonDiscPrice\": 28,        \"TotalPrice\": 28,        \"GatePrice\": \"0.00\",        \"CancellationRule\": \"0\",        \"CarDetFlags\": \"NNNNNNNNYYNYNNNNNN\",        \"CarDetails\": \"Y\",        \"DiscDates\": \"\",        \"Filter\": {          \"car_parked_for_you\": \"0\",          \"meet_and_greet\": \"0\",          \"park_and_stroll\": \"\",          \"on_airport\": null,          \"recommended\": null,          \"special_offer_text\": \"0\",          \"valet_included\": \"0\",          \"park_and_ride\": 1        }      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Parkservice Sky München Winteraktion\",        \"Code\": \"MU03\",        \"BookingURL\": \"/carpark/FRMU03.js\",        \"MoreInfoURL\": \"/product/MU03.js\",        \"_latitude\": 48.384242,        \"_longitude\": 11.778148,        \"RequestFlags\": {},        \"NonDiscPrice\": 39.99,        \"TotalPrice\": 39.99,        \"GatePrice\": \"0.00\",        \"CancellationRule\": \"0\",        \"CarDetFlags\": \"NNNNNNNNYYNYNNNNNN\",        \"CarDetails\": \"Y\",        \"DiscDates\": \"\",        \"Filter\": {          \"car_parked_for_you\": \"0\",          \"meet_and_greet\": \"0\",          \"park_and_stroll\": \"\",          \"on_airport\": null,          \"recommended\": null,          \"special_offer_text\": 1,          \"valet_included\": \"0\",          \"park_and_ride\": 1        }      }    ],    \"Pricing\": {      \"CCardSurchargePercent\": \"0.00\",      \"CCardSurchargeMin\": \"0.00\",      \"CCardSurchargeMax\": \"0.00\"    },    \"SepaID\": \"DE11ZZZ00000633860\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"ArrivalDate\": \"2020-01-07\",        \"ArrivalTime\": 1200,        \"DepartDate\": \"2020-01-08\",        \"DepartTime\": 1200,        \"NumberOfPax\": 1,        \"System\": \"ABG\",        \"lang\": \"en\",        \"format\": \"js\"      }    }  }}",
                                                                                                                                                                                                                                                                                                                                                                                  @@ -64,6 +57,13 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-lounge-av-airport": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Availability At Lounge",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "Availability At LoungeLounge Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/AirportCodeFor example, for lounge availability at Gatwick the endpoint is:https://api.holidayextras.com/v1/lounge/LGWTo find the airport locations available for lounges, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer enters the lounge.              ArrivalTime      Time      HHMM      Y      Time customer enters the lounge.              Adults      Integer      [0-4] 1 char      Y      Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Children      Integer      [0-3] 1 char      N      Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Infants      Integer      1 char      N      Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              OutFlight      String      [A-Z0-9] 9 chars      N      This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal.              Terminal      String      [A-Z1-9] 1 char      N      An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ).              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      Required for requests for European products. (Values available are en, de, it, es, pt and nl.)              fields      String      [A-Z] a csv list of product info fields      N      A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint.      Lounge Availability ResponseThe lounge availability response will return the specific product requested, so long as it has availability on the specific dates and times. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Lounge/Name      The name of the lounge.              Lounge/Code      The product code for the lounge, which must be used in the booking request.              Lounge/BookingURL      The URL to POST the booking request to for this particular product.              Lounge/MoreInfoURL      The link to more information about this product, sourced from the Product Library.              Lounge/NonDiscPrice      The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.              Lounge/Price      The price of product without any surcharges/fees added.              Lounge/terminal      The terminal the lounge is in              API_Header/Request      The API returns every parameter and value you sent in the previous request.      Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Requesthttps://api.holidayextras.com/v1/lounge/LHR?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0UK Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:24:54\">    <Lounge>        <Name>Plaza Premium T5 lounge - 3 hours</Name>        <Code>LHRPA5</Code>        <BookingURL>/v1/lounge/HPLHRPA5</BookingURL>        <MoreInfoURL>/v1/product/LHRPA5</MoreInfoURL>        <NonDiscPrice>80.00</NonDiscPrice>        <Price>80.00</Price>        <terminal>5</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>No1 Lounge, Terminal 3, Heathrow</Name>        <Code>LHRNN3</Code>        <BookingURL>/v1/lounge/HPLHRNN3</BookingURL>        <MoreInfoURL>/v1/product/LHRNN3</MoreInfoURL>        <NonDiscPrice>64.00</NonDiscPrice>        <Price>64.00</Price>        <terminal>3</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>SkyTeam Lounge T4</Name>        <Code>LHRSTE</Code>        <BookingURL>/v1/lounge/HPLHRSTE</BookingURL>        <MoreInfoURL>/v1/product/LHRSTE</MoreInfoURL>        <NonDiscPrice>60.00</NonDiscPrice>        <Price>60.00</Price>        <terminal>4</terminal>        <option_count>14</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>2.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>4.00</CCardSurchargeMax>        <DCardSurchargePercent>0.00</DCardSurchargePercent>        <DCardSurchargeMin>0.00</DCardSurchargeMin>        <DCardSurchargeMax>0.00</DCardSurchargeMax>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <v>1</v>        </Request>    </API_Header></API_Reply>European Products Availability Requesthttps://api.holidayextras.com/v1/lounge/HAM?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0&System=ABG&lang=deEuropean Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:30:25\">    <Lounge>        <Name>Hamburg Airport Lounge</Name>        <Code>HAMLHL</Code>        <BookingURL>/v1/lounge/FRHAMLHL</BookingURL>        <MoreInfoURL>/v1/product/HAMLHL</MoreInfoURL>        <NonDiscPrice>74.00</NonDiscPrice>        <Price>74.00</Price>        <terminal>Z</terminal>        <option_count>1</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>0.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>0.00</CCardSurchargeMax>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <System>ABG</System>            <lang>de</lang>            <v>1</v>        </Request>    </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/lounge/av/airport/"
                                                                                                                                                                                                                                                                                                                                                                                  +      }
                                                                                                                                                                                                                                                                                                                                                                                  +      ,
                                                                                                                                                                                                                                                                                                                                                                                  +    
                                                                                                                                                                                                                                                                                                                                                                                         "hxapi-viewamendcancel-amend-complex": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Amend Booking - complex (with reprice)",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "Amend Booking - complex (with reprice)API Docs > product:amendThe booking details that can be changed for a complex amend are as follows:  Arrival date or time;  Depart date or time.Amend Booking RequestWe recommend using the view booking method first, to ensure that you have all the details required from the most up to date record of the booking.You can then run a GET booking request using the amend endpoint and methodology detailed here to check the new amount (increase / decrease in price from original booking).The recommended process for amending a booking is as follows.  Call the view booking method to ensure that you have all the details required from the most up to date record of the booking.  Compose the amendment request as per the details below i.e. include the date change details. Then send this request as a GET rather than a POST. This will return the details of the pricing change.  If the client is happy with the pricing change then resend the request as a POST this will confirm and commit the changes.MethodPOSTEndpointThe endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):https://api.holidayextras.com/v1/booking/YourBookingRefRequest ParametersNB: All parameter names are case sensitive.For all amend booking requests, you will need to send these parameters:            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              Email      String      [A-Z0-9] 50 chars      Y      Email address used to make the booking (i.e. the email address of the lead passenger)              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).      In order to amend the booking with the new details, you only need to pass in the specific parameters you want to amend. For a complex amend these are as follows:            Name      Data Type      Format      Mandatory?      Additional Information                  ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              Supplements[]      -      -      N      Amend supplement details by sending the parameters to amend. See below for more details      Upgrade AmendmentsAs with booking upgrades it is possible to supply an array of Supplements to the amendment request to change the details of booked upgrades.To make amendments you need to specify the code of the upgrade to be changed and the fields you wish to change. The available fields are as below.            Name      Data Type      Format      Mandatory?      Additional Information                  Adults      Integer      [0-9]      N      When specified the Children parameter must also be specified otherwise it will be assumed to be 0              Children      Integer      [0-9]      N      When specified the Adults parameter must also be specified otherwise it will be assumed to be 0              Quantity      Integer      [0-9]      N      Change the required quantity of per booking or per room upgrades              Remove      -      -      N      The presence of this field will cause the upgrade to be removed from the booking      To add new upgrades you just need to include the upgrade details in the same fashion as when booking an upgrade.Get Amendment Price ResponseThis response will be given when a GET version of this request is sent. This should be used to retrieve the new price before committing to amendments.            Name      Additional Information                  Pricing/OriginalPrice      The price paid for the booking before any amendments              Pricing/NewPrice      The price to be paid if the amendments are confirmed              Pricing/CanxWaiver      The cost of any cancellation waiver that may be on the booking              Pricing/Duration      The new duration of the stay              Pricing/MinPricingDuration      The smallest duration of stay that the price can be increased by. For example if only increasing by 1 day but the MinPricingDuration is 3 days you will be charged for 3 days.              Pricing/PriceDifference      The difference between the originally paid price and the new price              Carpark/Code      Code of the booked product              Carpark/Name      Name of the booked product              Carpark/MoreInfoURL                     Carpark/BookingURL                     BarCode                     QRCode                     API_Header/Request      Copy of the original request params      *NOTE* If the Pricing/PriceDifference is negative the minus sign will be a suffix e.g. <PriceDifference>7.00-</PriceDifference>Amend Booking ResponseThe amend booking response will return the booking record with all of the updated details.For a detailed explanation of the fields returned, please see the respective booking requests for hotels, parking and lounges.Worked ExamplesBelow are worked examples of both the request and response for amending (complex) a booking.Amend Booking (complex for a hotel)RequestThe original booking was made for a hotel staying on 1st December 2018 with 8 days parking.https://api.holidayextras.com/booking/YourBookingRef<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <ArrivalDate>2018-12-02</ArrivalDate>  <ParkingDays>15</ParkingDays></Request>Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"Hotel\" Customer=\"A\" Session=\"999999999\" RequestCode=\"14\" Result=\"OK\">  <CarDetails>    <Registration>TEST123</Registration>    <CarMake/>    <CarModel/>    <CarColour/>    <OutFlight>TBC</OutFlight>  </CarDetails>  <ClientDetails>    <Title>MRS</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Address/>    <DataProtection>Y</DataProtection>    <Email>test@test.com</Email>  </ClientDetails>  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>931</AgentComm>    <VATonComm/>  </Booking>  <Pricing>    <OriginalPrice>93.10</OriginalPrice>    <NewPrice>93.10</NewPrice>    <CCardSurchargeAmount>0.00</CCardSurchargeAmount>    <CanxWaiver>0.00</CanxWaiver>    <AmendmentFee>N/A</AmendmentFee>    <PriceDifference>N/A</PriceDifference>  </Pricing>  <Itinerary>    <ArrivalDate>2018-12-02</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>RO</BoardBasis>    <Code>LHRMEP</Code>    <CarDropoffTime>0000</CarDropoffTime>    <CarPickupTime>0000</CarPickupTime>    <CarPickupDate>2018-12-17</CarPickupDate>    <ReturnFlight/>    <TerminalCode/>    <ParkingDays>15</ParkingDays>    <ParkingSpaces>1</ParkingSpaces>    <NonSmoking>Y</NonSmoking>  </Itinerary>  <Room>    <Rooms>1</Rooms>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Price>93.10</Price>    <Code>DBL</Code>  </Room>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <ArrivalDate>2018-12-02</ArrivalDate>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>15</ParkingDays>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>93.10</PriceCheckPrice>      <v>1</v>    </Request>  </API_Header></API_Reply>Amend Parking Booking With UpgradesOriginal booking made for 11th November 2020 with Fast track upgrade for 2 adults and 1 childRequesthttps://api.holidayextras.com/booking/YourBookingRef<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <Supplements>    <Code>STNSFS</Code>    <Adults>2</Adults>    <Children>2</Children>  </Supplements></Request>Get Amendment Price Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"CarPark\" Customer=\"A\" Session=\"999999999\" RequestCode=\"13\" Result=\"OK\">    <Pricing>        <OriginalPrice>72.98</OriginalPrice>        <NewPrice>79.98</NewPrice>        <CCardSurchargeAmount>0.00</CCardSurchargeAmount>        <CanxWaiver>0.00</CanxWaiver>        <Duration>8</Duration>        <MinPricingDuration>1</MinPricingDuration>        <PriceDifference>7.00</PriceDifference>    </Pricing>    <CarPark>        <Code>STN5</Code>        <Name>Long Stay</Name>        <MoreInfoURL>/v1/product/STN5</MoreInfoURL>        <BookingURL>/v1/carpark/STN5</BookingURL>        <Filter>            <meet_and_greet>0</meet_and_greet>        </Filter>    </CarPark>    <BarCode>/v1/barcode/YourBookingRef.png?key=YourKey</BarCode>    <QRCode>/v1/qrcode/YourBookingRef.png?key=YourKey</QRCode>    <API_Header>        <Request>            <v>1</v>        </Request>    </API_Header></API_Reply>Confirm Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"CarPark\" Customer=\"A\" Session=\"999999999\" RequestCode=\"14\" Result=\"OK\">  <CarDetails>    <CarColour>White</CarColour>    <CarMake>Range Rover</CarMake>    <CarModel>Evoque</CarModel>    <Registration>TE17 STS</Registration>    <OutFlight/>  </CarDetails>  <ClientDetails>    <Title>MRS</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Address/>    <DataProtection>Y</DataProtection>    <Email>test@test.com</Email>  </ClientDetails>  <Booking>    <BookingRef>YourBookingRef</BookingRef>  </Booking>  <Pricing>    <OriginalPrice>72.98</OriginalPrice>    <NewPrice>79.98</NewPrice>    <PriceDiff>7.00</PriceDiff>    <CCardSurchargeAmount>0.00</CCardSurchargeAmount>    <CanxWaiver>0.00</CanxWaiver>  </Pricing>  <CarPark>    <ArrivalDate>2020-11-11</ArrivalDate>    <DepartDate>2020-11-19</DepartDate>    <ArrivalTime>1230</ArrivalTime>    <DepartTime>1345</DepartTime>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>VIR19</ReturnFlight>    <Duration>8</Duration>    <Remarks/>    <Code>STN5</Code>    <Name>Long Stay</Name>    <MoreInfoURL>/v1/product/STN5</MoreInfoURL>    <distance_to_airport>On airport</distance_to_airport>    <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction>    <logo>/imageLibrary/Images/85730-official-stansted-airport-parking-long-stay.png</logo>    <BookingURL>/v1/carpark/STN5</BookingURL>    <Filter>      <meet_and_greet>0</meet_and_greet>    </Filter>  </CarPark>  <BarCode>/v1/barcode/YourBookingRef.png?key=YourKey</BarCode>  <QRCode>/v1/qrcode/YourBookingRef.png?key=YourKey</QRCode>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <Email>test@test.com</Email>      <Supplements>        <Code>STNSFS</Code>        <Adults>2</Adults>        <Children>2</Children>      </Supplements>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  @@ -106,20 +106,6 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-hotel-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Hotel Booking Request",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "Hotel Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/hotel/LocationCodeFor example, for Mercure at London Heathrow the endpoint is:https://api.holidayextras.com/v1/hotel/LHRMEARequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer arrives at hotel.              Nights      Integer      1, 2, 3, etc      Y      Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays.              RoomCode      String      [A-Z0-9] 3 chars      Y      See RoomCodes for a list of valid codes.              Adults      Integer      [1-5] 1 char      Y      The number of adults occupying the room.              Children      Integer      [0-4] 1 char      Y      The number of children occupying the room.              ParkingDays      Integer      [0-9] 2 chars      Y      NB: The maximum duration accepted for ParkingDays is 30.              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger. If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on. NB: This field can be set to NA              Town      String      [A-Z] 20 chars      Y      Town of address. NB: This field can be set to NA              County      String      [A-Z] 20 chars      Y      County of address. NB: This field can be set to NA              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address. NB: This field can be set to NA              DayPhone      Integer      [0-9] 20 chars max      N      The customer’s telephone number.              Email      String      [A-Z0-9] 50 chars      Y      The email address of customer.              CustomerRef      String      [A-Z0-9] 20 chars      N      Enter your Customer Reference to help match bookings for accounting purposes.              Remarks      String      [A-Z0-9] 60 chars      N      Pass in Remarks for notification such as COT REQUESTED in ROOM              Waiver      Boolean      [0,1]      Y      Defaults to 0 if not supplied.              DataProtection      String      [Y,N]      N      Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied.              PriceCheckFlag      String      [Y]      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9]      Y      Price of the product, received from the availability request or price check.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/hotel/LGWSOF HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Multiple rooms on same bookingCurrently, we can only accept a maximum of 2 rooms per booking. If the customer needs more, you will need to make multiple requests. If an intermediary account, you should note that this would lead to multiple transactions on the credit card, and multiple charges, and therefore we advise against it.The additional parameters for including a second room are:            Name      Data Type      Format      Mandatory?      Additional Information                  SecondRoomType      String      [A-Z0-9] 2 chars      N*      This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per Room Codes.              SecondRoomCode      String      Room Codes      N      NB: Please note that the room codes differ between availability and booking requests.              SecondRoomAdults      Integer      [1-5] 1 char      N      The number of adults occupying the second room.              SecondRoomChildren      Integer      [0-4] 1 char      N      The number of children occupying the second room.      UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are:            Name      Data Type      Format      Mandatory?                  CarDropoffDate      Date      YYYY-MM-DD      Y              CarDropoffTime      Time      HHMM      Y              CarPickupDate      Date      YYYY-MM-DD      Y              CarPickupTime      Time      HHMM      Y              ReturnFlight      String      [A-Z0-9] 10 chars      N              TerminalCode      String      [A-Z0-9] 2 chars      N              Registration      String      [A-Z0-9] 20 chars      N              CarMake      String      [A-Z0-9] 20 chars      N              CarModel      String      [A-Z0-9] 20 chars      N              CarColour      String      [A-Z0-9] 20 chars      N      PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Hotel Booking ResponseThe hotel booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              Itinerary      This section confirms details of the hotel on the booking.              Room      This section confirms details of the room booked at the hotel.              ClientDetails      Confirmation of the customer’s details that were sent in the booking request.              Pricing      Confirmation of the price paid by the customer for the hotel room.              Booking/Status    (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval  (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking hotels.UK Hotel Booking - Room OnlyRequesthttps://api.holidayextras.com/v1/hotel/LHRMEA<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DBL</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>55.00</PriceCheckPrice>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>        <AgentComm>6.53</AgentComm>        <VATonComm>0.00</VATonComm>        <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>    </Booking>    <Hotel/>    <Itinerary>        <TotalPrice>55.00</TotalPrice>        <ArrivalDate>2017-12-01</ArrivalDate>        <Nights>1</Nights>        <BoardBasis>RO</BoardBasis>        <NonSmoking>N</NonSmoking>        <ReturnFlight/>        <TerminalCode/>        <Code>LHRMEA</Code>        <Name>Mercure</Name>        <ParkingDays>0</ParkingDays>        <ParkingSpaces>0</ParkingSpaces>    </Itinerary>    <Room>        <Adults>2</Adults>        <Children>0</Children>        <Infants>0</Infants>        <Code>DBL</Code>    </Room>    <CarDetails>        <Registration/>        <CarMake/>        <CarModel/>        <CarColour/>    </CarDetails>    <ClientDetails>        <Title>MR</Title>        <Initial>T</Initial>        <Surname>TEST</Surname>        <Email>test@test.com</Email>        <Address/>        <Town/>        <County/>        <Postcode/>        <EvePhone/>    </ClientDetails>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2017-12-01</ArrivalDate>            <Nights>1</Nights>            <RoomCode>DBL</RoomCode>            <ParkingDays>0</ParkingDays>            <Adults>2</Adults>            <Children>0</Children>            <Title>Mr</Title>            <Initial>T</Initial>            <Surname>TEST</Surname>            <Address >1 Test Street</Address >            <Town>Testville</Town>            <County>Testshire</County>            <Postcode>TE1 STS</Postcode>            <DayPhone>01234567890</DayPhone>            <Email>test@test.com</Email>            <DataProtection>N</DataProtection>            <PriceCheckFlag>Y</PriceCheckFlag>            <PriceCheckPrice>55.00</PriceCheckPrice>            <v>1</v>        </Request>    </API_Header></API_Reply>European Hotel BookingRequesthttps://api.holidayextras.com/v1/hotel/MUCLAN<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DZ</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>120.00</PriceCheckPrice>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"4\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <MoreInfoURL>/v1/booking/YourBookingRef.de</MoreInfoURL>  </Booking>  <Hotel/>  <Itinerary>    <ArrivalDate>2017-12-01</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>F</BoardBasis>    <NonSmoking>N</NonSmoking>    <ParkingDays>0</ParkingDays>    <ParkingSpaces>0</ParkingSpaces>    <Code>MUCLAN</Code>    <Name>Schweigers Landgasthof</Name>  </Itinerary>  <Room>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Code>DZ</Code>  </Room>  <ClientDetails>    <Title>Herr</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>TEST@TEST.COM</Email>    <Town>TESTVILLE</Town>    <Postcode>TE1 STS</Postcode>    <DayPhone>01234567890</DayPhone>    <Remarks/>    <Address0>1 Test Street</Address0>    <Address1>TBC</Address1>    <DataProtection>N</DataProtection>    <County>TESTSHIRE</County>  </ClientDetails>  <Pricing>    <Price>120.00</Price>  </Pricing>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>0</ParkingDays>      <Adults>2</Adults>      <Children>0</Children>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address0>1 Test Street</Address0>      <Town>Testville</Town>      <County>Testshire</County>      <Postcode>TE1 STS</Postcode>      <DayPhone>01234567890</DayPhone>      <Email>test@test.com</Email>      <DataProtection>N</DataProtection>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>120.00</PriceCheckPrice>      <System>ABG</System>      <lang>de</lang>      <v>1</v>    </Request>  </API_Header></API_Reply>UK Hotel booking with UpgradesRequesthttps://api.holidayextras.com/v1/hotel/LGWSOF<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-10</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DBL</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>135.00</PriceCheckPrice>  <Supplements>    <Code>LGWSOE</Code>    <Date>2020-11-10</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>40.00</TotalPrice>  </Supplements>  <Supplements>    <Code>LGWASC</Code>    <Date>2020-11-11</Date>    <LoungeArrival>2020-11-11 12:30</LoungeArrival>    </Quantity>    <Adults>2</Adults>    <Children>0</Children>    <TotalPrice>56.00</TotalPrice>  </Supplements>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>13.45</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <Hotel/>  <Itinerary>    <TotalPrice>255.55</TotalPrice>    <ArrivalDate>2020-11-10</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>RO</BoardBasis>    <NonSmoking>N</NonSmoking>    <ReturnFlight/>    <TerminalCode/>    <Code>LGWSOF</Code>    <Name>Sofitel</Name>    <ParkingDays>0</ParkingDays>    <ParkingSpaces>0</ParkingSpaces>  </Itinerary>  <Room>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Code>DBL</Code>  </Room>  <CarDetails>    <Registration/>    <CarMake/>    <CarModel/>    <CarColour/>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>test@test.com</Email>    <Address/>    <Town/>    <County/>    <Postcode/>    <EvePhone>01234567890</EvePhone>  </ClientDetails>  <CurrentSupplements>    <Code>LGWSOE</Code>    <Name>Luxury room upgrade</Name>    <Price>66.50</Price>    <NonDiscPrice>66.50</NonDiscPrice>    <Per>room</Per>    <Adults>0</Adults>    <Children>0</Children>    <Date>2020-11-10</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <CurrentSupplements>    <Code>LGWASC</Code>    <Name>Club Aspire North Lounge</Name>    <Price>47.50</Price>    <NonDiscPrice>47.50</NonDiscPrice>    <Per>person</Per>    <Adults>2</Adults>    <Children>0</Children>    <Date>2020-11-11</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-11-10</ArrivalDate>      <ArrivalTime>12:30</ArrivalTime>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>Test</Surname>      <Address>Holiday Extras Ltd</Address>      <Address>Ashford Road</Address>      <Town>Hythe</Town>      <County>Kent</County>      <PostCode>CT214JF</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>135.00</PriceCheckPrice>      <Adults>2</Adults>      <Children>0</Children>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>0</ParkingDays>      <Supplements>        <Code>LGWSOE</Code>        <Date>2020-11-10</Date>        <Quantity>1</Quantity>        <TotalPrice>70.00</TotalPrice>      </Supplements>      <Supplements>        <Code>LGWASC</Code>        <Date>2020-11-11</Date>        <Adults>2</Adults>        <Children>0</Children>        <TotalPrice>56.00</TotalPrice>      </Supplements>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/hotel/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                  -      }
                                                                                                                                                                                                                                                                                                                                                                                  -      ,
                                                                                                                                                                                                                                                                                                                                                                                  -    
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-lounge-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Book Lounge",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "Book LoungeLounge Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/LoungeCodeFor example, for Plaza Premium T5 lounge - 3 hours at London Heathrow Airport the endpoint is:https://api.holidayextras.com/v1/lounge/LHRPA5Request ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer wishes to enter the lounge.              ArrivalTime      Time      HHMM      Y      Time customer wishes to enter the lounge.              Adults      Integer      [0-4] 1 char      Y      Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Children      Integer      [0-3] 1 char      N      Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Infants      Integer      1 char      Y      Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.NB: This field can be set to NA              Town      String      [A-Z] 20 chars      Y      Town of address NB: This field can be set to NA              County      String      [A-Z] 20 chars      Y      County of address NB: This field can be set to NA              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address NB: This field can be set to NA              Email      String      [A-Z0-9] 50 chars      Y      Email of lead passenger              MobileNum      String      [0-9] 20 char      Y      Mobile phone number of lead passenger.              CustomerRef      String      [A-Z0-9] 20 chars      N      A unique reference code associated with the customer’s booking for tracking and reference purposes.              PriceCheckFlag      String      Y      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9] 8 chars      Y      Price of the product, received from the availability request or price check.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              Waiver      Boolean      [0,1]      Y      Defaults to 0 if not supplied.              lang      String      [A-Z] 2 chars      Y*      Sets the language of the booking. (languages available are en, de, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/lounge/LHRNN3 HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Lounge Booking ResponseThe lounge booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              Booking/MoreInfoURL      The URL for viewing the booking. See view booking for more details.              Booking/Status (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking a lounge.UK Products BookingRequesthttps://api.holidayextras.com/v1/lounge/LHRPO3<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2018-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <Adults>2</Adults>  <Children>0</Children>  <Infants>0</Infants>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <MobileNum>01234567890</MobileNum>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>70.00</PriceCheckPrice></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>7.00</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <Initials>YourInitials</Initials>      <ArrivalDate>2018-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <Adults>2</Adults>      <Children>0</Children>      <Infants>0</Infants>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <MobileNum>01234567890</MobileNum>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>70.00</PriceCheckPrice>      <v>1</v>    </Request>  </API_Header></API_Reply>European Products BookingRequesthttps://api.holidayextras.com/v1/lounge/HAMLHL<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <System>ABG</System>  <ArrivalDate>2018-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <Adults>2</Adults>  <Children>0</Children>  <Infants>0</Infants>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <MobileNum>01234567890</MobileNum>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>70.00</PriceCheckPrice></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>5.44</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <System>ABG</System>      <ArrivalDate>2018-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <Adults>2</Adults>      <Children>0</Children>      <Infants>0</Infants>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <MobileNum>01234567890</MobileNum>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>70.00</PriceCheckPrice>      <v>1</v>    </Request>  </API_Header></API_Reply>UK Product Booking with UpgradesRequesthttps://api.holidayextras.com/v1/lounge/LHRPO3<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-08</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <Adults>2</Adults>  <Children>0</Children>  <Infants>0</Infants>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <MobileNum>01234567890</MobileNum>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>70.00</PriceCheckPrice>  <Supplements>    <Code>HXODC1</Code>    <Date>2020-11-08</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>2.99</TotalPrice>  </Supplements></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>7.00</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <CurrentSupplements>    <Code>HXODC1</Code>    <Name>Outbound Delay Cover</Name>    <Price>2.99</Price>    <NonDiscPrice>2.99</NonDiscPrice>    <Per>booking</Per>    <Adults>0</Adults>    <Children>0</Children>    <Date>2020-11-08</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <Initials>YourInitials</Initials>      <ArrivalDate>2020-11-08</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <Adults>2</Adults>      <Children>0</Children>      <Infants>0</Infants>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <MobileNum>01234567890</MobileNum>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>70.00</PriceCheckPrice>      <Supplements>        <Code>HXODC1</Code>        <Quantity>1</Quantity>        <TotalPrice>2.99</TotalPrice>      </Supplements>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/lounge/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                  -      }
                                                                                                                                                                                                                                                                                                                                                                                  -      ,
                                                                                                                                                                                                                                                                                                                                                                                  -    
                                                                                                                                                                                                                                                                                                                                                                                         "hxapi-parking-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Book Car Park",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "Book Car ParkAPI Docs > product:Parking > endpoint:carpark > Make BookingCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/CarParkCodeFor example, for Maple Manor Meet and Greet at London Gatwick North terminal the endpoint is:https://api.holidayextras.com/v1/carpark/LGW4Request ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.NB: This field can be set to NA              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              County      String      [A-Z] 20 chars      Y      County of address NB: This field can be set to NA              CustomerRef      String      [A-Z0-9] 20 chars      N      A unique reference code associated with the customer’s booking for tracking and reference purposes.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              Email      String      [A-Z0-9] 50 chars      Y      Email of lead passenger              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              NumberOfPax      Integer      [0-9] 2 chars      Y      Number of passengers.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address NB: This field can be set to NA              PriceCheckFlag      String      Y      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9]      Y      Price of the product, received from the availability request or price check.              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              Town      String      [A-Z] 20 chars      Y      Town of address NB: This field can be set to NA              lang      String      [A-Z] 2 chars      Y*      For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/carpark/STN5 HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.UK ProductsThe <RequestFlags> field dictates which fields need to be sent as part of the booking request.European ProductsThe availability response will return a list of 18 flags in the <CarDetFlags> field with a yes/no response to indicate if required. The order of the flags is always the same.PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              CarDetails      Confirmation of the vehicle details that were sent in the booking request.              CarDetails/Registration                     CarDetails/CarMake                     CarDetails/CarModel                     CarDetails/CarColour                     CarDetails/OutFlight                     CarDetails/Destination                     CarDetails/MobileNum                     ClientDetails      Confirmation of the lead passenger’s details that were sent in the booking request.              ClientDetails/Title                     ClientDetails/Initials                     ClientDetails/Surname                     ClientDetails/Email                     HandlingFee      Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero.              MoreInfoURL      The URL for viewing the booking. See view booking for more details.              CarPark      Details of the car park that were sent in the booking request.              CarPark/ArrivalDate                     CarPark/DepartDate                     CarPark/ArrivalTime                     CarPark/DepartTime                     CarPark/Duration                     CarPark/NumberOfPax                     CarPark/ReturnFlight                     CarPark/Code                     CarPark/TotalPrice                     CarPark/Name                     CarPark/introduction      Production description text              CarPark/logo      Product logo. Prepend with https:              CarPark/RequiresQRCode      Whether the QR Code needs to be used for this carpark, instead of the barcode              CarPark/BookingUrl      Prepend with https://api.holidayextras.com/              CarPark/MoreInfoUrl      Prepend with https://api.holidayextras.com/              BarCode      URL to the barcode for the booking. Prepend with https://api.holidayextras.com/              QRCode      URL to the QR code for the booking. Prepend with https://api.holidayextras.com/              QRCodeValue      (EU only) Value of the QR code that comes with email confirmation. More details about QR Code              QRCodeValueStr      (EU only) Value of the QR code that comes with email confirmation, when returning as part of a JSON resposne this value will be a string. More details about QR Code              FastTrackVouchers/Name      Only present if Fast track products have been purchased - Name used to separate multiple voucher products              FastTrackVouchers/Source      Link to the voucher document to be embeded in the client email              FastTrackVouchers/type      Content type qualifier for the Source              Booking/Status  (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking car parking.UK Products BookingRequesthttps://api.holidayextras.com/carpark/LGW4<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <DepartDate>2017-12-08</DepartDate>  <DepartTime>1200</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>57.99</PriceCheckPrice>  <CarColour>White</CarColour>  <CarMake>Range Rover</CarMake>  <CarModel>Evoque</CarModel>  <Destination>Munich</Destination>  <OutFlight>EZY8985</OutFlight>  <OutTerminal>N</OutTerminal>  <Registration>TE17 STS</Registration>  <ReturnFlight>EZY8982</ReturnFlight>  <ReturnTerminal>N</ReturnTerminal>  <MobileNum>01234567890</MobileNum></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>7.25</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>    <CarMake>RANGE ROVER</CarMake>    <CarModel>EVOQUE</CarModel>    <CarColour>WHITE</CarColour>    <OutFlight>EZY8985</OutFlight>    <Destination>MUNICH</Destination>    <MobileNum/>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>test@test.com</Email>  </ClientDetails>  <HandlingFee>0.00</HandlingFee>  <MoreInfoURL>/booking/YourBookingRef</MoreInfoURL>  <CarPark>    <ArrivalDate>2017-12-01</ArrivalDate>    <DepartDate>2017-12-08</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>7</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>EZY8982</ReturnFlight>    <Code>LGW4</Code>    <TotalPrice>57.99</TotalPrice>    <Name>Maple Manor Meet and Greet North</Name>    <introduction>With 20 years' experience in providing a great service, Maple Manor Meet and Greet parking is a firm favourite with our customers and it's easy to see why. One of their professional, insured chauffeurs will meet you at the North terminal and park your car for you in a secured car park while you catch your flight. It couldn't be simpler and all for this low price. We only sell airport-approved Meet and Greet services and Maple Manor is no exception.</introduction>    <advance_purchase>1</advance_purchase>    <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/LGW4_LGV0_LGT9_LGY8_thumbnail_logo.png</logo>    <BookingURL>/carpark/LGW4</BookingURL>    <MoreInfoURL>/product/LGW4</MoreInfoURL>  </CarPark>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>57.99</PriceCheckPrice>      <CarColour>White</CarColour>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <Registration>TE17 STS</Registration>      <Destination>Munich</Destination>      <OutFlight>EZY8985</OutFlight>      <OutTerminal>N</OutTerminal>      <ReturnFlight>EZY8982</ReturnFlight>      <ReturnTerminal>N</ReturnTerminal>      <MobileNum>01234567890</MobileNum>    </Request>  </API_Header></API_Reply>European Products BookingRequesthttps://api.holidayextras.com/carpark/MU01<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <DepartDate>2017-12-08</DepartDate>  <DepartTime>1200</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>HERR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>35.00</PriceCheckPrice>  <System>ABG</System>  <OutFltNo>EZY8982</OutFltNo>  <InFltNo>EZY8985</InFltNo>  <InFltTime>1130</InFltTime></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"4\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>3.75</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <MoreInfoURL>/carpark/YourBookingRef.de</MoreInfoURL>  <CarPark>    <ArrivalDate>2017-12-01</ArrivalDate>    <DepartDate>2017-12-08</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>7</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight/>    <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags>    <Code>MU01</Code>    <Name>Parkservice Sky München</Name>    <BookingURL>/carpark/MU01.de</BookingURL>    <MoreInfoURL>/product/MU01.de</MoreInfoURL>    <TotalPrice>35.00</TotalPrice>    <GatePrice>0.00</GatePrice>  </CarPark>  <BarCode>/barcode/YourBookingRef.png?key=YourKey</BarCode>  <ClientDetails>    <Title>HERR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>TEST@TEST.COM</Email>    <Town>TESTVILLE</Town>    <Postcode>TE12 3ST</Postcode>    <DayPhone>TBC</DayPhone>    <Remarks/>    <Address0>123 TEST STREET</Address0>    <DataProtection>Y</DataProtection>    <County>TESTSHIRE</County>    <Confirmation>Y</Confirmation>  </ClientDetails>  <Pricing>    <TotalPrice>35.00</TotalPrice>  </Pricing>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Title>HERR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>35.00</PriceCheckPrice>      <System>ABG</System>      <OutFltNo>EZY8982</OutFltNo>      <InFltNo>EZY8985</InFltNo>      <InFltTime>1130</InFltTime>    </Request>  </API_Header></API_Reply>UK Product booking With UpgradesRequesthttps://api.holidayextras.com/carpark/STN5<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-08</ArrivalDate>  <ArrivalTime>1230</ArrivalTime>  <ArrivalDate>2020-11-06</ArrivalDate>  <DepartTime>1345</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>57.99</PriceCheckPrice>  <CarColour>White</CarColour>  <CarMake>Range Rover</CarMake>  <CarModel>Evoque</CarModel>  <Destination>Munich</Destination>  <OutFlight>EZY8985</OutFlight>  <OutTerminal>N</OutTerminal>  <Registration>TE17 STS</Registration>  <ReturnFlight>EZY8982</ReturnFlight>  <ReturnTerminal>N</ReturnTerminal>  <MobileNum>01234567890</MobileNum>  <Supplements>    <Code>HXOST1</Code>    <Date>2020-11-08</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>1.99</TotalPrice>  </Supplements>  <Supplements>    <Code>STNSFS</Code>    <Date>2020-11-08</Date>    </Quantity>    <Adults>2</Adults>    <Children>1</Children>    <TotalPrice>15.00</TotalPrice>  </Supplements></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>3.75</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>    <CarMake>RANGE ROVER</CarMake>    <CarModel>EVOQUE</CarModel>    <CarColour>WHITE</CarColour>    <OutFlight/>    <Destination>-</Destination>    <MobileNum>01234567890</MobileNum>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>Test</Surname>    <Email>test@test.com</Email>  </ClientDetails>  <HandlingFee>0.00</HandlingFee>  <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  <CarPark>    <ArrivalDate>2020-11-08</ArrivalDate>    <DepartDate>2020-11-16</DepartDate>    <ArrivalTime>1230</ArrivalTime>    <DepartTime>1345</DepartTime>    <Duration>8</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>VIR19</ReturnFlight>    <Code>STN5</Code>    <TotalPrice>49.99</TotalPrice>    <Name>Long Stay</Name>    <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction>    <advance_purchase>1</advance_purchase>    <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/85730-official-stansted-airport-parking-long-stay.png</logo>    <RequiresQRCode>0</RequiresQRCode>    <BookingURL>/v1/carpark/STN5</BookingURL>    <MoreInfoURL>/v1/product/STN5</MoreInfoURL>  </CarPark>  <BarCode>/v1/barcode/YourBookingRef.png?key=ONLIN</BarCode>  <QRCode>/v1/qrcode/YourBookingRef.png?key=ONLIN</QRCode>  <FastTrackVouchers>    <name>Fast Track Voucher</name>    <source>https://voucher.holidayextras.co.uk/voucher/fastTrack?email=YourEmail&amp;booking_ref=YourBookingRef&amp;agent=YourABTANumber&amp;productType=carparks&amp;productCode=STNSFS</source>    <type>text/html</type>  </FastTrackVouchers>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-11-08</ArrivalDate>      <ArrivalTime>12:30</ArrivalTime>      <DepartDate>2020-11-16</DepartDate>      <DepartTime>13:45</DepartTime>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>50.05</PriceCheckPrice>      <CarColour>White</CarColour>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <Registration>TE17 STS</Registration>      <ReturnFlight>VIR19</ReturnFlight>      <Supplement>        <Code>HXOST1</Code>        <Date>2017-12-01</Date>        <Quantity>1</Quantity>      </Supplement>      <Supplement>        <Code>STNSFS</Code>        <Date>2017-12-01</Date>        <Adults>2</Adults>        <Children>1</Children>      </Supplement>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  @@ -134,6 +120,20 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-hotel-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Hotel Booking Request",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "Hotel Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/hotel/LocationCodeFor example, for Mercure at London Heathrow the endpoint is:https://api.holidayextras.com/v1/hotel/LHRMEARequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer arrives at hotel.              Nights      Integer      1, 2, 3, etc      Y      Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays.              RoomCode      String      [A-Z0-9] 3 chars      Y      See RoomCodes for a list of valid codes.              Adults      Integer      [1-5] 1 char      Y      The number of adults occupying the room.              Children      Integer      [0-4] 1 char      Y      The number of children occupying the room.              ParkingDays      Integer      [0-9] 2 chars      Y      NB: The maximum duration accepted for ParkingDays is 30.              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger. If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on. NB: This field can be set to NA              Town      String      [A-Z] 20 chars      Y      Town of address. NB: This field can be set to NA              County      String      [A-Z] 20 chars      Y      County of address. NB: This field can be set to NA              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address. NB: This field can be set to NA              DayPhone      Integer      [0-9] 20 chars max      N      The customer’s telephone number.              Email      String      [A-Z0-9] 50 chars      Y      The email address of customer.              CustomerRef      String      [A-Z0-9] 20 chars      N      Enter your Customer Reference to help match bookings for accounting purposes.              Remarks      String      [A-Z0-9] 60 chars      N      Pass in Remarks for notification such as COT REQUESTED in ROOM              Waiver      Boolean      [0,1]      Y      Defaults to 0 if not supplied.              DataProtection      String      [Y,N]      N      Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied.              PriceCheckFlag      String      [Y]      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9]      Y      Price of the product, received from the availability request or price check.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/hotel/LGWSOF HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Multiple rooms on same bookingCurrently, we can only accept a maximum of 2 rooms per booking. If the customer needs more, you will need to make multiple requests. If an intermediary account, you should note that this would lead to multiple transactions on the credit card, and multiple charges, and therefore we advise against it.The additional parameters for including a second room are:            Name      Data Type      Format      Mandatory?      Additional Information                  SecondRoomType      String      [A-Z0-9] 2 chars      N*      This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per Room Codes.              SecondRoomCode      String      Room Codes      N      NB: Please note that the room codes differ between availability and booking requests.              SecondRoomAdults      Integer      [1-5] 1 char      N      The number of adults occupying the second room.              SecondRoomChildren      Integer      [0-4] 1 char      N      The number of children occupying the second room.      UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are:            Name      Data Type      Format      Mandatory?                  CarDropoffDate      Date      YYYY-MM-DD      Y              CarDropoffTime      Time      HHMM      Y              CarPickupDate      Date      YYYY-MM-DD      Y              CarPickupTime      Time      HHMM      Y              ReturnFlight      String      [A-Z0-9] 10 chars      N              TerminalCode      String      [A-Z0-9] 2 chars      N              Registration      String      [A-Z0-9] 20 chars      N              CarMake      String      [A-Z0-9] 20 chars      N              CarModel      String      [A-Z0-9] 20 chars      N              CarColour      String      [A-Z0-9] 20 chars      N      PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Hotel Booking ResponseThe hotel booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              Itinerary      This section confirms details of the hotel on the booking.              Room      This section confirms details of the room booked at the hotel.              ClientDetails      Confirmation of the customer’s details that were sent in the booking request.              Pricing      Confirmation of the price paid by the customer for the hotel room.              Booking/Status    (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval  (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking hotels.UK Hotel Booking - Room OnlyRequesthttps://api.holidayextras.com/v1/hotel/LHRMEA<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DBL</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>55.00</PriceCheckPrice>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>        <AgentComm>6.53</AgentComm>        <VATonComm>0.00</VATonComm>        <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>    </Booking>    <Hotel/>    <Itinerary>        <TotalPrice>55.00</TotalPrice>        <ArrivalDate>2017-12-01</ArrivalDate>        <Nights>1</Nights>        <BoardBasis>RO</BoardBasis>        <NonSmoking>N</NonSmoking>        <ReturnFlight/>        <TerminalCode/>        <Code>LHRMEA</Code>        <Name>Mercure</Name>        <ParkingDays>0</ParkingDays>        <ParkingSpaces>0</ParkingSpaces>    </Itinerary>    <Room>        <Adults>2</Adults>        <Children>0</Children>        <Infants>0</Infants>        <Code>DBL</Code>    </Room>    <CarDetails>        <Registration/>        <CarMake/>        <CarModel/>        <CarColour/>    </CarDetails>    <ClientDetails>        <Title>MR</Title>        <Initial>T</Initial>        <Surname>TEST</Surname>        <Email>test@test.com</Email>        <Address/>        <Town/>        <County/>        <Postcode/>        <EvePhone/>    </ClientDetails>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2017-12-01</ArrivalDate>            <Nights>1</Nights>            <RoomCode>DBL</RoomCode>            <ParkingDays>0</ParkingDays>            <Adults>2</Adults>            <Children>0</Children>            <Title>Mr</Title>            <Initial>T</Initial>            <Surname>TEST</Surname>            <Address >1 Test Street</Address >            <Town>Testville</Town>            <County>Testshire</County>            <Postcode>TE1 STS</Postcode>            <DayPhone>01234567890</DayPhone>            <Email>test@test.com</Email>            <DataProtection>N</DataProtection>            <PriceCheckFlag>Y</PriceCheckFlag>            <PriceCheckPrice>55.00</PriceCheckPrice>            <v>1</v>        </Request>    </API_Header></API_Reply>European Hotel BookingRequesthttps://api.holidayextras.com/v1/hotel/MUCLAN<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DZ</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>120.00</PriceCheckPrice>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"4\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <MoreInfoURL>/v1/booking/YourBookingRef.de</MoreInfoURL>  </Booking>  <Hotel/>  <Itinerary>    <ArrivalDate>2017-12-01</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>F</BoardBasis>    <NonSmoking>N</NonSmoking>    <ParkingDays>0</ParkingDays>    <ParkingSpaces>0</ParkingSpaces>    <Code>MUCLAN</Code>    <Name>Schweigers Landgasthof</Name>  </Itinerary>  <Room>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Code>DZ</Code>  </Room>  <ClientDetails>    <Title>Herr</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>TEST@TEST.COM</Email>    <Town>TESTVILLE</Town>    <Postcode>TE1 STS</Postcode>    <DayPhone>01234567890</DayPhone>    <Remarks/>    <Address0>1 Test Street</Address0>    <Address1>TBC</Address1>    <DataProtection>N</DataProtection>    <County>TESTSHIRE</County>  </ClientDetails>  <Pricing>    <Price>120.00</Price>  </Pricing>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>0</ParkingDays>      <Adults>2</Adults>      <Children>0</Children>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address0>1 Test Street</Address0>      <Town>Testville</Town>      <County>Testshire</County>      <Postcode>TE1 STS</Postcode>      <DayPhone>01234567890</DayPhone>      <Email>test@test.com</Email>      <DataProtection>N</DataProtection>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>120.00</PriceCheckPrice>      <System>ABG</System>      <lang>de</lang>      <v>1</v>    </Request>  </API_Header></API_Reply>UK Hotel booking with UpgradesRequesthttps://api.holidayextras.com/v1/hotel/LGWSOF<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-10</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DBL</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>135.00</PriceCheckPrice>  <Supplements>    <Code>LGWSOE</Code>    <Date>2020-11-10</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>40.00</TotalPrice>  </Supplements>  <Supplements>    <Code>LGWASC</Code>    <Date>2020-11-11</Date>    <LoungeArrival>2020-11-11 12:30</LoungeArrival>    </Quantity>    <Adults>2</Adults>    <Children>0</Children>    <TotalPrice>56.00</TotalPrice>  </Supplements>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>13.45</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <Hotel/>  <Itinerary>    <TotalPrice>255.55</TotalPrice>    <ArrivalDate>2020-11-10</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>RO</BoardBasis>    <NonSmoking>N</NonSmoking>    <ReturnFlight/>    <TerminalCode/>    <Code>LGWSOF</Code>    <Name>Sofitel</Name>    <ParkingDays>0</ParkingDays>    <ParkingSpaces>0</ParkingSpaces>  </Itinerary>  <Room>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Code>DBL</Code>  </Room>  <CarDetails>    <Registration/>    <CarMake/>    <CarModel/>    <CarColour/>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>test@test.com</Email>    <Address/>    <Town/>    <County/>    <Postcode/>    <EvePhone>01234567890</EvePhone>  </ClientDetails>  <CurrentSupplements>    <Code>LGWSOE</Code>    <Name>Luxury room upgrade</Name>    <Price>66.50</Price>    <NonDiscPrice>66.50</NonDiscPrice>    <Per>room</Per>    <Adults>0</Adults>    <Children>0</Children>    <Date>2020-11-10</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <CurrentSupplements>    <Code>LGWASC</Code>    <Name>Club Aspire North Lounge</Name>    <Price>47.50</Price>    <NonDiscPrice>47.50</NonDiscPrice>    <Per>person</Per>    <Adults>2</Adults>    <Children>0</Children>    <Date>2020-11-11</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-11-10</ArrivalDate>      <ArrivalTime>12:30</ArrivalTime>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>Test</Surname>      <Address>Holiday Extras Ltd</Address>      <Address>Ashford Road</Address>      <Town>Hythe</Town>      <County>Kent</County>      <PostCode>CT214JF</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>135.00</PriceCheckPrice>      <Adults>2</Adults>      <Children>0</Children>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>0</ParkingDays>      <Supplements>        <Code>LGWSOE</Code>        <Date>2020-11-10</Date>        <Quantity>1</Quantity>        <TotalPrice>70.00</TotalPrice>      </Supplements>      <Supplements>        <Code>LGWASC</Code>        <Date>2020-11-11</Date>        <Adults>2</Adults>        <Children>0</Children>        <TotalPrice>56.00</TotalPrice>      </Supplements>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/hotel/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                  +      }
                                                                                                                                                                                                                                                                                                                                                                                  +      ,
                                                                                                                                                                                                                                                                                                                                                                                  +    
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-lounge-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Book Lounge",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "Book LoungeLounge Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/LoungeCodeFor example, for Plaza Premium T5 lounge - 3 hours at London Heathrow Airport the endpoint is:https://api.holidayextras.com/v1/lounge/LHRPA5Request ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer wishes to enter the lounge.              ArrivalTime      Time      HHMM      Y      Time customer wishes to enter the lounge.              Adults      Integer      [0-4] 1 char      Y      Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Children      Integer      [0-3] 1 char      N      Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Infants      Integer      1 char      Y      Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.NB: This field can be set to NA              Town      String      [A-Z] 20 chars      Y      Town of address NB: This field can be set to NA              County      String      [A-Z] 20 chars      Y      County of address NB: This field can be set to NA              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address NB: This field can be set to NA              Email      String      [A-Z0-9] 50 chars      Y      Email of lead passenger              MobileNum      String      [0-9] 20 char      Y      Mobile phone number of lead passenger.              CustomerRef      String      [A-Z0-9] 20 chars      N      A unique reference code associated with the customer’s booking for tracking and reference purposes.              PriceCheckFlag      String      Y      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9] 8 chars      Y      Price of the product, received from the availability request or price check.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              Waiver      Boolean      [0,1]      Y      Defaults to 0 if not supplied.              lang      String      [A-Z] 2 chars      Y*      Sets the language of the booking. (languages available are en, de, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/lounge/LHRNN3 HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Lounge Booking ResponseThe lounge booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              Booking/MoreInfoURL      The URL for viewing the booking. See view booking for more details.              Booking/Status (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking a lounge.UK Products BookingRequesthttps://api.holidayextras.com/v1/lounge/LHRPO3<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2018-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <Adults>2</Adults>  <Children>0</Children>  <Infants>0</Infants>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <MobileNum>01234567890</MobileNum>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>70.00</PriceCheckPrice></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>7.00</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <Initials>YourInitials</Initials>      <ArrivalDate>2018-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <Adults>2</Adults>      <Children>0</Children>      <Infants>0</Infants>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <MobileNum>01234567890</MobileNum>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>70.00</PriceCheckPrice>      <v>1</v>    </Request>  </API_Header></API_Reply>European Products BookingRequesthttps://api.holidayextras.com/v1/lounge/HAMLHL<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <System>ABG</System>  <ArrivalDate>2018-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <Adults>2</Adults>  <Children>0</Children>  <Infants>0</Infants>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <MobileNum>01234567890</MobileNum>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>70.00</PriceCheckPrice></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>5.44</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <System>ABG</System>      <ArrivalDate>2018-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <Adults>2</Adults>      <Children>0</Children>      <Infants>0</Infants>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <MobileNum>01234567890</MobileNum>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>70.00</PriceCheckPrice>      <v>1</v>    </Request>  </API_Header></API_Reply>UK Product Booking with UpgradesRequesthttps://api.holidayextras.com/v1/lounge/LHRPO3<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-08</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <Adults>2</Adults>  <Children>0</Children>  <Infants>0</Infants>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <MobileNum>01234567890</MobileNum>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>70.00</PriceCheckPrice>  <Supplements>    <Code>HXODC1</Code>    <Date>2020-11-08</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>2.99</TotalPrice>  </Supplements></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>7.00</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <CurrentSupplements>    <Code>HXODC1</Code>    <Name>Outbound Delay Cover</Name>    <Price>2.99</Price>    <NonDiscPrice>2.99</NonDiscPrice>    <Per>booking</Per>    <Adults>0</Adults>    <Children>0</Children>    <Date>2020-11-08</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <Initials>YourInitials</Initials>      <ArrivalDate>2020-11-08</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <Adults>2</Adults>      <Children>0</Children>      <Infants>0</Infants>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <MobileNum>01234567890</MobileNum>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>70.00</PriceCheckPrice>      <Supplements>        <Code>HXODC1</Code>        <Quantity>1</Quantity>        <TotalPrice>2.99</TotalPrice>      </Supplements>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/lounge/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                  +      }
                                                                                                                                                                                                                                                                                                                                                                                  +      ,
                                                                                                                                                                                                                                                                                                                                                                                  +    
                                                                                                                                                                                                                                                                                                                                                                                         "hxapi-bundles": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Bundles",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "BundlesSome results that are returned from availability on the API will be what we call bundles, these consist of a main product, such as a hotel, bundled together with an additional supplement, like a dinner.Bundles are currently only available on hotel searches.AvailabilityBundles can be identified by their product code, which has an additional element preceding the main product code joined by a +.E.g...<Name>Cresta Court with 2-course dinner</Name><Code>MANCCT+B519</Code><BookingURL>/v1/hotel/HPMANCCT+B519</BookingURL><Price>110.65</Price>...The price given will be for the entire bundle including the supplement with the current passenger quantity ( determined by the given room code ).A product library request can be made with the complete bundle product code to get content related to the package as a whole instead of simply the main product. E.g /v1/product/MANCCT+B519BookingThe BookingURL element will contain the full product code, including prefix, that must be supplied when a bundle is to be booked, this will ensure that system books the main product as well as the appropriate supplement. When booking a bundle on a hotel search the quantity of the supplement will be determined by the given room occupancy in the Adults and Children fields.The booking response for a bundle booking will show the main product and the booked supplement as seperate elements. The TotalPrice field will contain the full price of the booking, but the supplement price will also be shown separately under the CurrentSupplements block.E.g...<Booking><BookingRef>XXXXX</BookingRef><AgentComm>12.41</AgentComm><VATonComm>2.07</VATonComm><MoreInfoURL>/v1/booking/XXXXX</MoreInfoURL></Booking><Hotel/><Itinerary><TotalPrice>110.65</TotalPrice><ArrivalDate>2019-03-10</ArrivalDate><Nights>1</Nights><BoardBasis>RO</BoardBasis><NonSmoking>N</NonSmoking><ReturnFlight/><TerminalCode/><Code>MANCCT</Code><Name/><ParkingDays>0</ParkingDays><ParkingSpaces>0</ParkingSpaces></Itinerary><Room><Adults>2</Adults><Children>1</Children><Infants>0</Infants><Code>TRL</Code></Room><CurrentSupplements><Code>MANCDI</Code><Name>2-course dinner</Name><Price>29.90</Price><NonDiscPrice>29.90</NonDiscPrice><Per>person</Per><Adults>2</Adults><Children>1</Children><Date>2019-03-10</Date><Canx>Y</Canx><Remarks/></CurrentSupplements>...The product code of the supplement will also be returned in the booking response which can be used to retrieve product specific content in the product library request that can be displayed on booking confirmations. When creating confirmation emails be sure to highlight that the supplement has been added as a part of this booking.Post BookingA bundle booking can be amended or cancelled following the same rules as a general product. The supplement has a Canx field in the booking response that will define if that particular add-on can be cancelled as part of the booking. It is not currently possible to amend the quantity of the supplement or remove it from the booking using the API.",
                                                                                                                                                                                                                                                                                                                                                                                  @@ -141,10 +141,10 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-viewamendcancel-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "Cancel BookingAPI Docs > product:cancelCancel Booking RequestCancelling a booking is a two-stage process:  Check if the booking is cancellable, and any charges for doing so, using the GET method outlined below;  Cancel the booking using the POST method outlined below.MethodGET / POSTEndpointThe endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):https://api.holidayextras.com/v1/booking/YourBookingRefRequest ParametersStep 1: Check if booking is cancellable (GET)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to N for this initial step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Step 2: Cancel booking (POST)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to Y for the cancellation step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Cancel Booking ResponseThe cancel booking response will confirm that a booking has been cancelled in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Cancel/RefundAmount      This shows the amount to be refunded to the customer.              API_Header/Request      A list of parameters that were sent in the booking request.      Credit Card FeesAs of 12th January 2018 we no longer charge credit card fees, in line with the Payment Services Directive (PSD2). This applies to both UK and EU products.Worked examplesBelow are worked examples of both the request and response for cancelling a booking.Cancel Booking Request - Step 1https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&ConfirmCancel=N&CancelRef=YourCancelRefCancel Booking Response - Step 1<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef/>        <CancelInfo>There is no charge for cancelling this booking</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>N</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancel Booking Request - Step 2https://api.holidayextras.com/v1/booking/YourBookingRef    <Request>        <ABTANumber>YourABTA</ABTANumber>        <Password>YourPassword</Password>        <Initials>YourInitials</Initials>        <key>YourKey</key>        <ConfirmCancel>Y</ConfirmCancel>        <CancelRef>YourCancelRef</CancelRef>    </Request>Cancel Booking Response - Step 2<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef>06684</CancelRef>        <CancelInfo>Please retrieve your client's copy of voucher as booking will be reinstated if used</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>Y</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancelling bookings made with a credit or debit cardA small number of agents in Europe pass through payment details in our API (for historic reasons). The method for cancelling these products differs slightly in that an extra parameter is required to authenticate against the booking. The extra parameter is identified below.            Name      Data Type      Format      Mandatory?      Additional Information              CreditCardLast4      Integer      [0-9] 4 chars      Y      These are the last 4 digits on the card that the customer used to make payment.      The cancellation request must be POSTed against the following endpoint:https://payment.holidayextras.com/legacy/",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/viewamendcancel/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-transfers-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Transfers Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "Transfers Cancel BookingImportant Notes  Check cancellation fees first: Before cancelling, use the Cancellation Policy endpoint to check if the booking is cancellable and to see any applicable fees and refund amounts  This DELETE request will immediately cancel the booking - ensure you want to proceed before making the request  Cancellation fees and refund amounts will depend on the booking’s cancellation policy  Once cancelled, a booking cannot be uncancelled or modifiedCancel Booking RequestMethodDELETEEndpointThe endpoint to use is:https://api.holidayextras.com/v1/transfers/booking/[BookingRef]Where [BookingRef] is the booking reference you received when making the original booking.For example:https://api.holidayextras.com/v1/transfers/booking/TBBGNHMTRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              CancelRef      String      [A-Z0-9]      Y      Reference number for the cancellation provided by your system.      Cancel Booking ResponseIf the cancellation is successful, the response will contain booking and cancellation details including any fees and refund information.Note: The CancelFee in this response is a string formatted as currency (e.g., “10.50”), while the dedicated Cancellation Policy endpoint returns fee amounts as integers in pence/cents.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      Unique identifier for the transfer booking.              Booking/Status      Current status of the booking after cancellation (e.g., Cancelled).              Cancel/CancelFee      Fee charged for the cancellation, if applicable (string value in currency format, e.g., “10.50”).              Cancel/CancelRef      Reference number for the cancellation.              Cancel/CancelInfo      Information about the cancellation.              Cancel/RefundAmount      Amount refunded for the cancellation, if applicable (numeric value).      Example\tXML\tJSON\t<Booking>  <BookingRef>TBBGNHMT</BookingRef>  <Status>Cancelled</Status></Booking><Cancel>  <CancelFee>10.50</CancelFee>  <CancelRef>CANCEL123456</CancelRef>  <CancelInfo>Booking cancelled successfully</CancelInfo>  <RefundAmount>93.02</RefundAmount></Cancel>\t{  \"Booking\": {    \"BookingRef\": \"TBBGNHMT\",    \"Status\": \"Cancelled\"  },  \"Cancel\": {    \"CancelFee\": \"10.50\",    \"CancelRef\": \"CANCEL123456\",    \"CancelInfo\": \"Booking cancelled successfully\",    \"RefundAmount\": 93.02  }}Error ResponsesThe API will return error responses in the following scenarios:Already Cancelled Booking (409 Conflict)If the booking has already been cancelled and cannot be cancelled again:{  \"Code\": \"ConflictError\",  \"Message\": \"Booking has already been cancelled\"}Invalid Parameters (400 Bad Request)If required parameters are missing or malformed:{  \"Code\": \"ValidationError\",  \"Message\": \"Missing or invalid required parameter\"}Booking Not Found (404 Not Found)If no booking is found with the provided reference:{  \"Code\": \"NotFound\",  \"Message\": \"Booking not found with provided reference\"}",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/transfers/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  @@ -155,10 +155,10 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-transfers-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Transfers Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "Transfers Cancel BookingImportant Notes  Check cancellation fees first: Before cancelling, use the Cancellation Policy endpoint to check if the booking is cancellable and to see any applicable fees and refund amounts  This DELETE request will immediately cancel the booking - ensure you want to proceed before making the request  Cancellation fees and refund amounts will depend on the booking’s cancellation policy  Once cancelled, a booking cannot be uncancelled or modifiedCancel Booking RequestMethodDELETEEndpointThe endpoint to use is:https://api.holidayextras.com/v1/transfers/booking/[BookingRef]Where [BookingRef] is the booking reference you received when making the original booking.For example:https://api.holidayextras.com/v1/transfers/booking/TBBGNHMTRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              CancelRef      String      [A-Z0-9]      Y      Reference number for the cancellation provided by your system.      Cancel Booking ResponseIf the cancellation is successful, the response will contain booking and cancellation details including any fees and refund information.Note: The CancelFee in this response is a string formatted as currency (e.g., “10.50”), while the dedicated Cancellation Policy endpoint returns fee amounts as integers in pence/cents.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      Unique identifier for the transfer booking.              Booking/Status      Current status of the booking after cancellation (e.g., Cancelled).              Cancel/CancelFee      Fee charged for the cancellation, if applicable (string value in currency format, e.g., “10.50”).              Cancel/CancelRef      Reference number for the cancellation.              Cancel/CancelInfo      Information about the cancellation.              Cancel/RefundAmount      Amount refunded for the cancellation, if applicable (numeric value).      Example\tXML\tJSON\t<Booking>  <BookingRef>TBBGNHMT</BookingRef>  <Status>Cancelled</Status></Booking><Cancel>  <CancelFee>10.50</CancelFee>  <CancelRef>CANCEL123456</CancelRef>  <CancelInfo>Booking cancelled successfully</CancelInfo>  <RefundAmount>93.02</RefundAmount></Cancel>\t{  \"Booking\": {    \"BookingRef\": \"TBBGNHMT\",    \"Status\": \"Cancelled\"  },  \"Cancel\": {    \"CancelFee\": \"10.50\",    \"CancelRef\": \"CANCEL123456\",    \"CancelInfo\": \"Booking cancelled successfully\",    \"RefundAmount\": 93.02  }}Error ResponsesThe API will return error responses in the following scenarios:Already Cancelled Booking (409 Conflict)If the booking has already been cancelled and cannot be cancelled again:{  \"Code\": \"ConflictError\",  \"Message\": \"Booking has already been cancelled\"}Invalid Parameters (400 Bad Request)If required parameters are missing or malformed:{  \"Code\": \"ValidationError\",  \"Message\": \"Missing or invalid required parameter\"}Booking Not Found (404 Not Found)If no booking is found with the provided reference:{  \"Code\": \"NotFound\",  \"Message\": \"Booking not found with provided reference\"}",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/transfers/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-viewamendcancel-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "Cancel BookingAPI Docs > product:cancelCancel Booking RequestCancelling a booking is a two-stage process:  Check if the booking is cancellable, and any charges for doing so, using the GET method outlined below;  Cancel the booking using the POST method outlined below.MethodGET / POSTEndpointThe endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):https://api.holidayextras.com/v1/booking/YourBookingRefRequest ParametersStep 1: Check if booking is cancellable (GET)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to N for this initial step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Step 2: Cancel booking (POST)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to Y for the cancellation step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Cancel Booking ResponseThe cancel booking response will confirm that a booking has been cancelled in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Cancel/RefundAmount      This shows the amount to be refunded to the customer.              API_Header/Request      A list of parameters that were sent in the booking request.      Credit Card FeesAs of 12th January 2018 we no longer charge credit card fees, in line with the Payment Services Directive (PSD2). This applies to both UK and EU products.Worked examplesBelow are worked examples of both the request and response for cancelling a booking.Cancel Booking Request - Step 1https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&ConfirmCancel=N&CancelRef=YourCancelRefCancel Booking Response - Step 1<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef/>        <CancelInfo>There is no charge for cancelling this booking</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>N</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancel Booking Request - Step 2https://api.holidayextras.com/v1/booking/YourBookingRef    <Request>        <ABTANumber>YourABTA</ABTANumber>        <Password>YourPassword</Password>        <Initials>YourInitials</Initials>        <key>YourKey</key>        <ConfirmCancel>Y</ConfirmCancel>        <CancelRef>YourCancelRef</CancelRef>    </Request>Cancel Booking Response - Step 2<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef>06684</CancelRef>        <CancelInfo>Please retrieve your client's copy of voucher as booking will be reinstated if used</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>Y</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancelling bookings made with a credit or debit cardA small number of agents in Europe pass through payment details in our API (for historic reasons). The method for cancelling these products differs slightly in that an extra parameter is required to authenticate against the booking. The extra parameter is identified below.            Name      Data Type      Format      Mandatory?      Additional Information              CreditCardLast4      Integer      [0-9] 4 chars      Y      These are the last 4 digits on the card that the customer used to make payment.      The cancellation request must be POSTed against the following endpoint:https://payment.holidayextras.com/legacy/",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/viewamendcancel/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  @@ -225,94 +225,94 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-viewamendcancel": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Manage A Booking",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Manage A Booking[API Docs](/hxapi/) > product:[viewamendcancel](index)## Manage A Booking EndpointsHere are the endpoints for managing a booking:| View booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](view) | GET || Amend booking - Simple | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_simple) | POST || Amend booking - Complex | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_complex) | POST || Cancel booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](cancel) | POST |## Manage A Booking Top TipsThe three methods provided will enable your customers via your integration to manage their own booking online.### Amending a bookingWe allow both simple and complex amends:- A ***simple amend*** is where the booking details are updated, without affecting the price. This is also known as an \"amend no re-price\". For example, adding a car registration number to a parking booking.- A ***complex amend*** is where the booking details are updated and this does affect the price. This is also known as an \"amend re-price\". For example, changing the date of a booking.",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/viewamendcancel/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-parking-av": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Carpark Endpoint",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Carpark Endpoint[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av)## /carpark/LocationOrCarParkCodeWhere `LocationOrCarParkCode` can be the location (Airport, Port etc) or a specific car park product code.",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/parking/av/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-hotel-av": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Hotel Availability Request",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "## Hotel Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/LocationCode```For example, for London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHR```If you know the specific hotel code, then you can request availability by entering that into the endpoint. For example, for the Hilton at London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRHIL```To find the airport locations available for hotels, please refer to the [locations endpoint.](/hxapi/locations)### Request ParametersNB: All parameter names are case sensitive.| Name           | Data Type | Format                                  | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                        ||----------------|-----------|-----------------------------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber     | String    | [A-Z0-9] 5 chars                        | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                               || Password       | String    | [A-Z0-9] 5 chars                        | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                               || Initials       | String    | [A-Z] 3 chars                           | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                         || key            | String    | [A-Z]                                   | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                           || token          | String    | [0-9] 9 chars                           | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                    || ArrivalDate    | Date      | YYYY-MM-DD                              | Y          | Date customer arrives at hotel.                                                                                                                                                                                                                                                                                                               || Nights         | Integer   | 1                                       | Y          | Number of nights the customer wants to stay in the hotel. NB: It is only possible to book one night stays.                                                                                                                                                                                                                                    || RoomType       | String    | [A-Z0-9] 3 chars                        | Y          | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes.                                                                                                                                                                                                                                                                             || SecondRoomType | String    | [A-Z0-9] 3 chars                        | N*         | NB: This feature is only available in the UK. This parameter is mandatory if the customer wishes to book two rooms at the same time. (Max 2 rooms) The room codes are as per RoomType.                                                                                                                                                || ParkingDays    | Integer   | [0-9] 2 chars                           | Y          | NB: The maximum duration accepted for ParkingDays is 30.                                                                                                                                                                                                                                                                                      || System         | String    | [A-Z] 3 chars                           | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                || lang           | String    | [A-Z] 2 chars                           | Y*         | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.)                                                                                                                                                                                                                                    || Terminal       | String    | [A-Z1-9] 1 char                         | N          | An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the [Terminal](/hxapi/terminal) request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). || fields         | String    | [A-Z] a csv list of product info fields | N          | A list of product info fields can be passed in to return configurable product information e.g. `fields=name,address,latitude,sellingpoint`.                                                                                                                                                                                                   |## Hotel Availability ResponseFor a detailed explanation of the fields returned, please see below:| Field                              | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                            ||------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Hotel/Name                         | The name of the product                                                                                                                                                                                                                                                                                                                                                                                                           || Hotel/Code                         | The product code                                                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/BookingURL                   | The URL to POST the booking request to for this particular product.                                                                                                                                                                                                                                                                                                                                                               || Hotel/MoreInfoURL                  | The link to more information about this product, sourced from the Product Library.                                                                                                                                                                                                                                                                                                                                                || Hotel/RequestFlags                 | These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request. Flags are only returned when required. The flags which can be returned are: `Registration`, `CarMake`, `CarModel`, `CarColour`, `OutFlight`, `ReturnFlight`, `OutTerminal`, `ReturnTerminal`, `Destination`, `MobileNum` || Hotel/Price                        | The price of product without any surcharges/fees added.                                                                                                                                                                                                                                                                                                                                                                           || Hotel/PriceWithSurcharge           | *NB: Please ignore this field - we no longer accept new agents sending payment details via our API.*                                                                                                                                                                                                                                                                                                                              || Hotel/Adults*                      | The maximum number of adults included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                      || Hotel/Children*                    | The maximum number of children included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                    || Hotel/RoomCode                     | *NB: Please ignore this field as it relates to internal systems.*                                                                                                                                                                                                                                                                                                                                                                 || Hotel/BoardBasis                   | *NB: Please ignore this field as it is no longer used and will be deprecated in future versions of the API.*                                                                                                                                                                                                                                                                                                                      || Hotel/ParkingDays                  | This returns the number of days parking available. NB: This may differ from the value requested, due to parking packages usually being set up in the system as either 4, 8 or 15 days.                                                                                                                                                                                                                                        || Hotel/NonDiscPrice                 | The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.                                                                                                                                                                                                                                                                                                                       || Hotel/CancellationFeeExceptions    | If the hotel has non-standard cancellation fees.                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/AmendmentFeeExceptions       | If the hotel has non-standard amendment fees.                                                                                                                                                                                                                                                                                                                                                                                     || Hotel/noncancellable_nonrefundable | Is this hotel noncancellable or non-refundable?                                                                                                                                                                                                                                                                                                                                                                                   || Hotel/parking_includes_arrival     | If parking during the customer's hotel stay included in their parking package                                                                                                                                                                                                                                                                                                                                                     || Hotel/CarPark                      | If your request included car parking, this is the car park code.                                                                                                                                                                                                                                                                                                                                                                  || Hotel/Filter                       | *NB: Please ignore this field as it is for internal use only.*                                                                                                                                                                                                                                                                                                                                                                    || Hotel/lead_time_cancellation       | This is the number of days before the booking starts that the product will switch from flexible to non-flexible.                                                                                                                                                                                                                                                                                                                  || API_Header/Request                 | The API returns every parameter and value you sent in the previous request.                                                                                                                                                                                                                                                                                                                                                       | \\* Where two rooms have been requested, these fields represent the total of adults and children across all rooms. Additional fields will show the individual room occupancy:  `FirstRoomAdults`, `FirstRoomChildren`, `SecondRoomAdults` and `SecondRoomChildren`.## Key Information on HotelsPlease read this section through carefully, as it contains useful information about restrictions on how hotels must be sold.### Advance purchaseAdvance purchase products are non-refundable and non-cancellable. As a result, Cancellation Waiver must *not* be sold to customers purchasing a product with `advance_purchase` set to 1.### Day Use OnlyThere is a field in the product library for hotels, named `day_use_only`. Day use products must not be sold to customers wishing to have an overnight stay where `day_use_only` is set to 1.### Parking Includes ArrivalIn order to establish whether the package includes parking for the night of the hotel stay the `parking_includes_arrival` field needs to be taken into account.Where this field is set to 0, this means the night of the hotel stay is not included as there is free overnight parking. Parking stay will start from the following day. Where it is set to 1, this means that parking starts from the date the customer checks into the hotel.### Mystery / Un-named ProductsThere are some hotels in which the name field will not provide the name of the hotel e.g `Mystery 4-star hotel`.  The name of these hotels should not be provided to the customer until the booking is made, along with other identifying details such as address, hotel images, restaurant names etc.### Lead time cancellationFlexible bookings become non flexible within a certain timeframe before the stay date ie booking turns non flexible within 30 days of stay.Scenario 1* Flexible booking made outside 60 days of stay.* Cancellation policy - only able to canx up to 30 days before stay date.* Booking is non flex within 30 days of stay date.Scenario 2* Flexible booking made inside 60 days of stay date.* Cancellation policy - only able to canx up to 3 days before stay date.* Booking is non flex within 3 days of stay date.## Worked ExamplesBelow are worked examples of both the requests and responses for hotel availability.### UK Hotel Availability Request - Room Only (zero days parking)```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=0```### UK Hotel Availability Response - Room Only (zero days parking)NB: This is a shortened example compiled from a full availability response.```xml            Mercure        LHRMEA        /v1/hotel/HPLHRMEA        /v1/product/LHRMEA                    1                45.00        45.90        2        1        TRL        RO        0        45.00        30        1        1        1                Thistle T5        LHRPAA        /v1/hotel/HPLHRPAA        /v1/product/LHRPAA                85.50        87.21        2        1        TRL        RO        0        85.50        30        1                    0                1                Hilton T5        LHRHLT        /v1/hotel/HPLHRHLT        /v1/product/LHRHLT                    1            1            1                99.00        100.98        2        1        TRL        RO        0        99.00                2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            0            1            ```### UK Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=8```### UK Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Mercure with Purple Parking Meet and Greet        LHRMPU        /v1/hotel/HPLHRMPU        /v1/product/LHRMPU                    1            1            1            1            1            1            1                129.00        131.58        2        1        TRL        RO        8        129.00        LHR5        LHR5                    1                        Thistle T5 with parking at the hotel and breakfast        LHRPAT        /v1/hotel/HPLHRPAT        /v1/product/LHRPAT                130.00        132.60        2        1        TRL        RO        8        130.00                    1            1            0                       Sheraton Skyline with parking at the hotel       LHRSKA       /v1/hotel/HPLHRSKA       /v1/product/LHRSKA              134.00       136.68       2       1       TRL       RO       8       134.00                  0                     2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            8            1            ```### European Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/MUC?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=D20&ParkingDays=8&System=ABG&lang=de```### European Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Schweigers Landgasthof        MUCLAN        /v1/hotel/FRMUCLAN        /v1/product/MUCLAN                120.00        NaN        2        0        DZ        F        15        120.00                Airporthotel Regent        MUCREG        /v1/hotel/FRMUCREG        /v1/product/MUCREG                97.00        NaN        2        0        DZ        F        15        97.00                  NH München Airport          MUCAST          /v1/hotel/FRMUCAST          /v1/product/MUCAST                    113.00          NaN          2          0          DZ          U          8          113.00                0.00        0.00        0.00                                TESTG            Redacted            mytestkey            generate            2017-12-01            1            D20            8            ABG            de            1            ```",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/hotel/av/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-parking": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Parking",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Parking[API Docs](/hxapi/) > product:[Parking](index)## Parking EndpointsHere are the car parking specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/v1/carpark/AirportCode](av/airport)            | GET    | | Availability at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](av/carpark)            | GET    | | Make booking at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](bkg)                   | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck](priceCheck) | GET    |## Parking User JourneyBelow is a diagram detailing how the endpoints can be used to create a parking user journey. More information on each endpoint can be found in the detailed guides listed above. ![Image of Parking User Journey](/hxapi/parking/Parking_User_Journey.png)## Parking Top TipsWe have put together these top tips, which detail how to optimise your use of our API for providing parking to your customers.#### Merging Product Library data into availability responseTo save sending a separate `https` request for information from the Product Library, you can specify a comma-separated list of values to pull this information back with the availability request.Just specify a parameter named ``fields`` and include the Product Library field names there.For example:```&fields=field_a,field_b,field_c```Alternatively, the method for querying the product library as a separate request [is outlined here](/hxapi/productlibrary/index).#### Advance purchaseThere is a field in the Product Library for car parks, named ``advance_purchase``. Advance purchase products are non-refundable and non-cancellable. As a result, the Cancellation Waiver must not be sold to customers purchasing a product with ``advance_purchase`` set to 1.#### Request flagsThe request flags brought back from availability searches indicate the fields required in the booking by the car park. You *must* retrieve this information from the customer at the time of booking.There are occasions where your booking will go through without sending this information but can fail later when importing the bookings to car parks. This causes us considerable administrative difficulties and may result in your customer's booking being cancelled without notice.#### Good to go meet and greetNew product types which are amendable by dates and times but cannot be cancelled.  The response will return `CanAmendCantCancel` set to either 1 or 0.",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/parking/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-hotel": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Hotels",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Hotels[API Docs](/hxapi/) > product:[Hotels](index)## Hotel EndpointsHere are the hotel specific endpoints: | Action                                     | Endpoint                                                                         | Method | | ------                                     | --------                                                                         | ------ | | Availability at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](av)            | GET    | | Make booking at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](bkg)           | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck](priceCheck) | GET    |Please note: All hotel requests include parking options of zero, 8 and 15 days parking. To make a request for a hotel only product, please select zero days parking.## Hotel User JourneyTo follow -",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/hotel/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-transfers-av": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Transfers Availability",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Transfers Availability## Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/search```Here is an example:```https://api.holidayextras.com/v1/transfers/search?token=[TOKEN]&key=[KEY]&ABTANumber=[ABTA]&FromDate=2020-08-01&FromTime=1000&ReturnDate=2020-08-07&ReturnTime=1730&PickUp=AGP&PickUpType=IATA&DropOff=85101062&DropOffType=TTI&OutFlight=U28605&ReturnFlight=U28602&Adults=2```### Request ParametersNB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                       ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                  || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                            || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                          || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                          || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                   || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                  || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                  || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                   || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.  || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                       || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                     || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                        || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                    || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                              || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                               || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                  || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                            || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                  || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines. || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                      || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                    || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                       || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                   || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                             || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                              || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                 || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                 || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                       || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                     || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                      || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                            || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                     |#### Dates and TimesIt's important to note that availability should be requested with accurate dates and times. A good scenario would be if an Airport Transfer is required, where the `PickUp` would be an Airport and the `DropOff` would be a Hotel. The `FromDate` and `FromTime` should be the flight arrival date and time. If a return transfer is requested, then the `ReturnDate` and `ReturnTime` should be the flight departure date and time, our system will calculate an estimated pickup time from the Hotel.## Availability ResponseIf availability has been found for the requested parameters, the response will contain a `Transfers` field with all the nested Transfers available. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                      | Additional Information                                                                                      ||----------------------------|-------------------------------------------------------------------------------------------------------------|| Transfers/Name             | The name of the Transfer.                                                                                   || Transfers/Code             | The product code for the transfer, which must be used in the booking request.                               || Transfers/BookingURL       | The URL to POST the booking request to for this particular product.                                         || Transfers/TotalPrice       | The total price of the Transfer/s.                                                                          || Transfers/NonDiscPrice     | If a discount has been applied, this is the total price before discount.                                    || Transfers/SalesCurrency    | Three character identifier for the sale currency to qualify the price.                                      || Transfers/Images/Src       | Link to a image for the product. Prefix with `https:`.                                                      || Transfers/Images/Alt       | The alt tag for the image.                                                                                  || Transfers/Category         | The category assigned to the Transfer/s, for the full list of categories [please see below](/hxapi/transfers/av/#transfer-categories). || Transfers/Disclaimer       | Depending on supplier and transfer type, the Disclaimer will contain pickup details.                        || Transfers/ProviderDetails  | Shows the providers name and rating (if applicable).                                                        || Transfers/Cancellation     | Shows the cancellation period before pickup date/time.                                                      || Transfers/VehicleDetails   | Details about the vehicle being used for the Transfer/s.                                                    || Transfers/OutboundTransfer | Details about the outbound transfer.                                                                        || Transfers/ReturnTransfer   | Details about the return transfer (This field will be `null` if no return was requested).                   || Transfers/PartnerOwnSupply | Product originates from partner’s own supply. Your account manager will confirm whether you should use this. || Transfers/SupplierCost     | Supplier cost for this transfer. Only available for selected products and requests.                     |#### [Transfer Categories](#transfer-categories)Here are the available categories which may be returned, there will only be one category assigned to each Transfer:- private_adapted_vehicle- private_car- private_coach- private_electric_car- private_excutive_car- private_executive_electric_car- private_helicopter- private_limousine- private_luxury_car- private_minibus- private_minivan- private_sea_plane- private_speed_boat- private_suv- private_water_taxi- shared_express_shuttle- shared_shuttle- shared_water_taxi### Example```json{    \"API_Reply\": {        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 1,            \"Result\": \"OK\",            \"cached\": true,            \"expires\": \"2020-07-21 15:20:14\"        },        \"Transfers\": [            {                \"ATTRIBUTES\": [],                \"Name\": \"Shuttle\",                \"Code\": \"TBHT39\",                \"BookingURL\": \"/v1/transfers/TBHT39.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 103.52,                \"NonDiscPrice\": 103.52,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"shared_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:30\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Speedy Shuttle\",                \"Code\": \"TBHT519\",                \"BookingURL\": \"/v1/transfers/TBHT519.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 134.8,                \"NonDiscPrice\": 134.8,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"speedy_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:45\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Car\",                \"Code\": \"TBHT43\",                \"BookingURL\": \"/v1/transfers/TBHT43.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 201.72,                \"NonDiscPrice\": 201.72,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_transfer\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Executive Car\",                \"Code\": \"TBHT18\",                \"BookingURL\": \"/v1/transfers/TBHT18.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 291.86,                \"NonDiscPrice\": 291.86,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_luxury.jpeg\",                        \"Alt\": \"private luxury\"                    }                ],                \"Category\": \"private_executive\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Minibus\",                \"Code\": \"TBHT2\",                \"BookingURL\": \"/v1/transfers/TBHT2.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 295.32,                \"NonDiscPrice\": 295.32,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_minibus\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 5,                    \"MaxCapacity\": 8,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 8,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            }        ],        \"Pricing\": {},        \"SepaID\": \"\",        \"API_Header\": {            \"Request\": {                \"ABTANumber\": \"YourABTANumber\",                \"Password\": \"YourPassword\",                \"Initials\": \"YourInitials\",                \"key\": \"YourKey\",                \"token\": \"YourToken\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1000,                \"ReturnDate\": \"2020-08-07\",                \"ReturnTime\": 1730,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"OutFlight\": \"U28605\",                \"ReturnFlight\": \"U28602\",                \"Adults\": 2,                \"v\": 1,                \"format\": \"js\"            }        }    }}```### Worked ExamplesBelow are some worked examples of both the request and response when requesting transfers availability.#### Airport to GIATA##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      GIATA      439771      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"GIATA\",        \"DropOff\": 439771,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to TTI##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      TTI      10147575      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"TTI\",        \"DropOff\": 10147575,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to Postal Address##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP          //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg      private standard        private_transfer                                                  72      100      0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      postal-address      Hotel Rural Castillo De Biar      Carretera de Banyeres      s/n      Biar      Alicante      03410      ES      -0.76832006      38.63852215      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 16:26:43\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [{          \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",          \"Alt\": \"private standard\"        }],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      }    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"postal-address\",        \"DropOffName\": \"Hotel Rural Castillo De Biar\",        \"DropOffAddress\": [          \"Carretera de Banyeres\",          \"s/n\"        ],        \"DropOffTown\": \" Biar\",        \"DropOffCounty\": \"Alicante\",        \"DropOffPostcode\": \"03410\",        \"DropOffCountryCode\": \"ES\",        \"DropOffLongitude\": -0.76832006,        \"DropOffLatitude\": 38.63852215,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/transfers/av/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-lounge": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Lounge",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# LoungeHere are the lounge specific endpoints:| Request | Endpoint | Method || --- | --- | --- || Availability of lounges at airport | [https://api.holidayextras.com/v1/lounge/AirportCode](av/airport) | GET || Make booking for lounge | [https://api.holidayextras.com/v1/lounge/LoungeCode](bkg) | POST |",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/lounge/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-transfers-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Transfers Booking",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Transfers Booking## Booking Request### MethodPOST### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/[CODE]```Where ```[CODE]``` is the product code received in the availability request of the product you want to book.Here is an example for the following Availability response:```TBHT1169922/transfers/TBHT1169922...```Your Make Booking request will have the following URL: https://api.holidayextras.com/v1/transfers/TBHT1169922### Request ParametersThe parameters _must_ be sent in the body of the request, as `x-www-form-urlencoded` data.NB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   ||--------------------|-----------|------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                              || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                        || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                                      || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                                                                                                                                                                                                                                              || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                              || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                              || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                                || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                                                                                                                                                                                                                                              || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                        || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                             || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                               || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                                                                                                                                                                                                                                             || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                                                                                                                                                                                                                                             || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                        || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                 || Title              | String    | [A-Z]            | Y          | Title of lead passenger, an option from the [list of valid titles](/hxapi/reference/titles)                                                                                                                                                                                                                                                                                                                                                                                                                              || FirstName          | String    | [A-Z]            | Y          | The lead passenger's first name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || LastName           | String    | [A-Z]            | Y          | The lead passenger's last name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || Email              | String    | [A-Z] 50 chars   | Y          | The lead passenger's email address.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || DayPhone           | Integer   | [0-9] 20 chars   | Y          | The lead passenger's contact telephone number.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || Price              | Float     | [0-9]            | Y          | The total price of the Transfer/s (This will be the value of the `TotalPrice` property returned in the availability response).                                                                                                                                                                                                                                                                                                                                                                                           || PriceCheckFlag     | String    | Y/N              | N          | Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.         || PriceCheckPrice    | Float     | [0-9]            | N          | Price of the product, received from the availability request or price check.  Only required when `PriceCheckFlag` is `Y`                                                                                                                                                                                                                                                                                                                                                                                                 |#### PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers' payment details being passed to us via the API. Further details can be found in our section on [Payment](/hxapi/payment).Please contact your Account Manager if you have any questions concerning payment.## Booking ResponseIf the booking has been successful, the response will contain a `Booking` field which will have a `BookingRef` property. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                                     | Additional Information                                                                                                                                     ||-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                        | The reference for the booking, use this reference in all communication with us relating to this booking.                                                   || Booking/AgentComm                         | Commission earned from this booking.                                                                                                                       || Booking/MoreInfoURL                       | The URL to GET more information about the booking (view [View Booking Request](../view) for more information).                        || Booking/Status (Future)                   | Indicates the current status of the booking (`Pending`, `Confirmed`, `Cancelled`, or `Error`).                                                             || Booking/SuggestedPollingInterval (Future) | Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier. |### Example```json{    \"API_Reply\": {        \"Booking\": {            \"BookingRef\": \"TBBGNHMT\",            \"AgentComm\": \"0.17\",            \"VATonComm\": \"0.00\",            \"MoreInfoURL\": \"/v1/booking/TBBGNHMT.js\",            \"Status\": \"Pending\",            \"SuggestedPollingInterval\": 3600        },        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 5,            \"Result\": \"OK\"        },        \"API_Header\": {            \"Request\": {                \"key\": \"TEST\",                \"token\": \"d2d6dedd-606f-4f00-aa8c-526a358e927c\",                \"ABTANumber\": \"TESTL\",                \"Password\": \"Redacted\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1255,                \"ReturnDate\": \"2020-08-10\",                \"ReturnTime\": 1355,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"Adults\": 2,                \"Title\": \"MR\",                \"FirstName\": \"Test\",                \"LastName\": \"Test\",                \"Email\": \"test@holidayextras.com\",                \"DayPhone\": \"07123456789\",                \"Price\": 103.52,                \"OutFlight\": \"LS1405\",                \"ReturnFlight\": \"LS1406\",                \"v\": 1,                \"format\": \"js\"            }        }    }}```[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/transfers/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-carhire": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Car Hire",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Car Hire[API Docs](/hxapi/) > product:[Car Hire](index)These are the car hire requests.| Action | Endpoint | Method || --- | --- | --- || Lookup Locations | [https://api.holidayextras.com/v1/carHire/locations](locations) | GET || Availability | [https://api.holidayextras.com/v1/carHire/products](availability) | GET || Make Booking | [https://api.holidayextras.com/v1/carHire/](booking/make) | POST || Lookup Booking | [https://api.holidayextras.com/v1/carHire-booking/](booking/lookup) | GET |",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/carhire/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-transfers": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Transfers",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Transfers[API Docs](/hxapi/) > product:[Transfers](index)## Transfer EndpointsWhen using the Transfer endpoints below, you will be able to search using various types of location data which will represent the transfers pickup and dropoff points. Currently, the API will accept IATA Codes, TTI Codes and Postcodes (Postcodes can be used for UK Transfers).You will need a token to call the api. To get the user token use the existing endpoint: [Get Token](https://docs.holidayextras.co.uk/hxapi/usertoken/).For the complete API specification, see the [OpenAPI schema](https://api.holidayextras.com/v1/transfers/openapi.yml). | Action                     | Endpoint                                                                     | Method | | ------                     | --------                                                                     | ------ | | Availability               | [https://api.holidayextras.com/v1/transfers/search](av)                    | GET    | | Make Booking               | [https://api.holidayextras.com/v1/transfers/[TransferCode]](bkg)           | POST   | | View Booking               | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](view)    | GET    | | Cancel Booking             | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](cancel)  | DELETE | | Cancellation Policy        | [https://api.holidayextras.com/v1/transfers/[BookingRef]/cancellation-policy](cancellation-policy) | GET    | | Amend Booking              | not supported                                                                |   -    |",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/transfers/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-parking-av": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Carpark Endpoint",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Carpark Endpoint[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av)## /carpark/LocationOrCarParkCodeWhere `LocationOrCarParkCode` can be the location (Airport, Port etc) or a specific car park product code.",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/parking/av/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-productlibrary": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Product Library",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Product LibraryThe data returned from a Product Library request depends on the type of product you ask for. A request for a car park returns different fields than a request for a hotel.By default, only fields that contain a value are returned.You can specify the fields you want returned. Simply add the parameter fields and specify the field names. An error/warning element will be returned for any fields which do not exist, but the request will still return those elements for which there is a value. If you request a valid field, but there is no value, it will not be returned.The purpose of most of the fields should be self-explanatory. If there is anything you do not understand, please email . There are no guarantees about the types of data returned, you should make no assumptions about a specific field being an integer etc.Data returned should not be cached locally for periods of time greater than one day (24 hours).### URL/product/{productCode}### MethodGET### Parameters| Name   | Format | Required ||--------|--------|----------|| token  | String | N        || key    | String | Y        || fields | String | N        |## Available FieldsThe available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.{% codetabs %}{% codetab Parking %}{% include_relative _parkingFields.md %}{% endcodetab %}{% codetab Hotel room only %}{% include_relative _hotelOnlyFields.md %}{% endcodetab %}{% codetab Hotel with parking %}{% include_relative _hotelParkingFields.md %}{% endcodetab %}{% codetab Lounge %}{% include_relative _loungeFields.md %}{% endcodetab %}{% codetab Fast track %}{% include_relative _fastTrackFields.md %}{% endcodetab %}{% endcodetabs %}---## Examples### Example 1 - Default Response#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_1.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_1.json %}```{% endcodetab %}{% endcodetabs %}---### Example 2 - Restricted field list#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_2.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_2.json %}```{% endcodetab %}{% endcodetabs %}---### Example 3 - German Parking Request#### RequestRequests for German products return a different set of fields. Explanation of fields not currently available.{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_3.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_3.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/productlibrary/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-parking": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Parking",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Parking[API Docs](/hxapi/) > product:[Parking](index)## Parking EndpointsHere are the car parking specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/v1/carpark/AirportCode](av/airport)            | GET    | | Availability at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](av/carpark)            | GET    | | Make booking at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](bkg)                   | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck](priceCheck) | GET    |## Parking User JourneyBelow is a diagram detailing how the endpoints can be used to create a parking user journey. More information on each endpoint can be found in the detailed guides listed above. ![Image of Parking User Journey](/hxapi/parking/Parking_User_Journey.png)## Parking Top TipsWe have put together these top tips, which detail how to optimise your use of our API for providing parking to your customers.#### Merging Product Library data into availability responseTo save sending a separate `https` request for information from the Product Library, you can specify a comma-separated list of values to pull this information back with the availability request.Just specify a parameter named ``fields`` and include the Product Library field names there.For example:```&fields=field_a,field_b,field_c```Alternatively, the method for querying the product library as a separate request [is outlined here](/hxapi/productlibrary/index).#### Advance purchaseThere is a field in the Product Library for car parks, named ``advance_purchase``. Advance purchase products are non-refundable and non-cancellable. As a result, the Cancellation Waiver must not be sold to customers purchasing a product with ``advance_purchase`` set to 1.#### Request flagsThe request flags brought back from availability searches indicate the fields required in the booking by the car park. You *must* retrieve this information from the customer at the time of booking.There are occasions where your booking will go through without sending this information but can fail later when importing the bookings to car parks. This causes us considerable administrative difficulties and may result in your customer's booking being cancelled without notice.#### Good to go meet and greetNew product types which are amendable by dates and times but cannot be cancelled.  The response will return `CanAmendCantCancel` set to either 1 or 0.",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/parking/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-de-start": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "DE-Start",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# DE-StartThis documentation relates to an existing partner integration - it is NOT to be used or considered for any new partner integrations. The documentation relates to parking products only.## DE-Start EndpointsHere are the DE-Start specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/de-start/v1/carpark/AirportCode](/hxapi/de-start/airport)| GET    | | Booking at car park | [https://api.holidayextras.com/de-start/v1/carpark/CarParkCode](/hxapi/de-start/bkg)| POST   | | Cancel booking | [https://api.holidayextras.com/de-start/v1/booking/YourBookingRef](/hxapi/de-start/cancel)| GET / POST   |",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/de-start/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-upgrade": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Product Upgrades",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Product Upgrades[API Docs](/hxapi/) > [Product Upgrades](/hxapi/upgrade)## Upgrades Availability RequestUpgrades are currently only supported for parking, hotel and lounge bookings. Upgrades can be requested on a per product basis.#### MethodGET#### Endpoint/upgrade/{productCode}NB: Where `productCode` is the code of the base product i.e. the parking/hotel/lounge etc. product.```https://api.holidayextras.com/v1/upgrade/LGV4```## Request Parameters| Name        | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                          ||-------------|-----------|------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber  | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                 || Password    | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials    | String    | [A-Z] 3 chars    | N          | The initials of the Operator / Agent.                                                                                                                           || key         | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                             || token       | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                      || ArrivalDate | String    | YYYY-MM-DD       | Y          | This should be the same as the `ArrivalDate` from the base product request.                                                                                     || ArrivalTime | Time      | HHMM             | Y          | This should be the same as the `ArrivalTime` from the base product request.                                                                                     || DepartDate  | Date      | YYYY-MM-DD       | N          | This should be the same as the `DepartDate` from the base product request.                                                                                      || DepartTime  | Time      | HHMM             | N          | This should be the same as the `DepartTime` from the base product request.                                                                                      || Adults      | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of adults in the party                                                                                            || Children    | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of children in the party                                                                                          |## Upgrade Availability ResponseThe response will return a list of available upgrades.Upgrades are sold on a per booking, per person, or per room basis.Upgrades can be for the day before travel, day of departure or day of return.| Field              | Additional Information                                                                      ||--------------------|---------------------------------------------------------------------------------------------|| Code               | Product code for the upgrade                                                                || Name               | Name of the upgrade                                                                         || Per                | Pricing basis, either per *P*erson, per *B*ooking, per *R*oom                               || Canx               | Whether the upgrade is cancellable (Y/N)                                                    || description        |                                                                                             || supplement_type    | Type classification for the upgrade                                                         || Date               | Date the upgrade is to be booked for. Format YYYY-MM-DD                                     || only_for_adults    | Upgrades restricted to adult only parties e.g. Adult only lounges                           || Price              | The price of the upgrade minus any discounts. Only present for per booking upgrades         || NonDiscPrice       | The total price of the upgrade before discounts. Only present for per booking upgrades      || DiscAmt            | The amount of any discount applied. Only present for per booking upgrades                   || AdPrice            | The per adult price minus any discounts. Only present for per person upgrades               || NonDiscAdPrice     | The per adult price before any discounts. Only present for per person upgrades              || AdDiscAmt          | The amount of discount applied to the per adult price. Only present for per person upgrades || ChPrice            | The per child price minus any discounts. Only present for per person upgrades               || NonDiscChPrice     | The per child price before any discounts. Only present for per person upgrades              || ChDiscAmt          | The amount of discount applied to the child price. Only present for per person upgrades     || API_Header/Request | The API returns every parameter and value you sent in the request.                          |## Examples### Example 1 - Carpark Upgrades#### Request{% codetabs %}  {% codetab XML %}  ```https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45  ```  {% endcodetab %}  {% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/STN5.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```  {% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_1_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_1_response.json %}```{% endcodetab %}{% endcodetabs %}### Example 1 - Hotel Upgrades#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/LGWSOF.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_2_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_2_response.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/upgrade/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-hotel-av": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Hotel Availability Request",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "## Hotel Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/LocationCode```For example, for London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHR```If you know the specific hotel code, then you can request availability by entering that into the endpoint. For example, for the Hilton at London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRHIL```To find the airport locations available for hotels, please refer to the [locations endpoint.](/hxapi/locations)### Request ParametersNB: All parameter names are case sensitive.| Name           | Data Type | Format                                  | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                        ||----------------|-----------|-----------------------------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber     | String    | [A-Z0-9] 5 chars                        | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                               || Password       | String    | [A-Z0-9] 5 chars                        | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                               || Initials       | String    | [A-Z] 3 chars                           | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                         || key            | String    | [A-Z]                                   | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                           || token          | String    | [0-9] 9 chars                           | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                    || ArrivalDate    | Date      | YYYY-MM-DD                              | Y          | Date customer arrives at hotel.                                                                                                                                                                                                                                                                                                               || Nights         | Integer   | 1                                       | Y          | Number of nights the customer wants to stay in the hotel. NB: It is only possible to book one night stays.                                                                                                                                                                                                                                    || RoomType       | String    | [A-Z0-9] 3 chars                        | Y          | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes.                                                                                                                                                                                                                                                                             || SecondRoomType | String    | [A-Z0-9] 3 chars                        | N*         | NB: This feature is only available in the UK. This parameter is mandatory if the customer wishes to book two rooms at the same time. (Max 2 rooms) The room codes are as per RoomType.                                                                                                                                                || ParkingDays    | Integer   | [0-9] 2 chars                           | Y          | NB: The maximum duration accepted for ParkingDays is 30.                                                                                                                                                                                                                                                                                      || System         | String    | [A-Z] 3 chars                           | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                || lang           | String    | [A-Z] 2 chars                           | Y*         | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.)                                                                                                                                                                                                                                    || Terminal       | String    | [A-Z1-9] 1 char                         | N          | An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the [Terminal](/hxapi/terminal) request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). || fields         | String    | [A-Z] a csv list of product info fields | N          | A list of product info fields can be passed in to return configurable product information e.g. `fields=name,address,latitude,sellingpoint`.                                                                                                                                                                                                   |## Hotel Availability ResponseFor a detailed explanation of the fields returned, please see below:| Field                              | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                            ||------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Hotel/Name                         | The name of the product                                                                                                                                                                                                                                                                                                                                                                                                           || Hotel/Code                         | The product code                                                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/BookingURL                   | The URL to POST the booking request to for this particular product.                                                                                                                                                                                                                                                                                                                                                               || Hotel/MoreInfoURL                  | The link to more information about this product, sourced from the Product Library.                                                                                                                                                                                                                                                                                                                                                || Hotel/RequestFlags                 | These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request. Flags are only returned when required. The flags which can be returned are: `Registration`, `CarMake`, `CarModel`, `CarColour`, `OutFlight`, `ReturnFlight`, `OutTerminal`, `ReturnTerminal`, `Destination`, `MobileNum` || Hotel/Price                        | The price of product without any surcharges/fees added.                                                                                                                                                                                                                                                                                                                                                                           || Hotel/PriceWithSurcharge           | *NB: Please ignore this field - we no longer accept new agents sending payment details via our API.*                                                                                                                                                                                                                                                                                                                              || Hotel/Adults*                      | The maximum number of adults included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                      || Hotel/Children*                    | The maximum number of children included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                    || Hotel/RoomCode                     | *NB: Please ignore this field as it relates to internal systems.*                                                                                                                                                                                                                                                                                                                                                                 || Hotel/BoardBasis                   | *NB: Please ignore this field as it is no longer used and will be deprecated in future versions of the API.*                                                                                                                                                                                                                                                                                                                      || Hotel/ParkingDays                  | This returns the number of days parking available. NB: This may differ from the value requested, due to parking packages usually being set up in the system as either 4, 8 or 15 days.                                                                                                                                                                                                                                        || Hotel/NonDiscPrice                 | The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.                                                                                                                                                                                                                                                                                                                       || Hotel/CancellationFeeExceptions    | If the hotel has non-standard cancellation fees.                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/AmendmentFeeExceptions       | If the hotel has non-standard amendment fees.                                                                                                                                                                                                                                                                                                                                                                                     || Hotel/noncancellable_nonrefundable | Is this hotel noncancellable or non-refundable?                                                                                                                                                                                                                                                                                                                                                                                   || Hotel/parking_includes_arrival     | If parking during the customer's hotel stay included in their parking package                                                                                                                                                                                                                                                                                                                                                     || Hotel/CarPark                      | If your request included car parking, this is the car park code.                                                                                                                                                                                                                                                                                                                                                                  || Hotel/Filter                       | *NB: Please ignore this field as it is for internal use only.*                                                                                                                                                                                                                                                                                                                                                                    || Hotel/lead_time_cancellation       | This is the number of days before the booking starts that the product will switch from flexible to non-flexible.                                                                                                                                                                                                                                                                                                                  || API_Header/Request                 | The API returns every parameter and value you sent in the previous request.                                                                                                                                                                                                                                                                                                                                                       | \\* Where two rooms have been requested, these fields represent the total of adults and children across all rooms. Additional fields will show the individual room occupancy:  `FirstRoomAdults`, `FirstRoomChildren`, `SecondRoomAdults` and `SecondRoomChildren`.## Key Information on HotelsPlease read this section through carefully, as it contains useful information about restrictions on how hotels must be sold.### Advance purchaseAdvance purchase products are non-refundable and non-cancellable. As a result, Cancellation Waiver must *not* be sold to customers purchasing a product with `advance_purchase` set to 1.### Day Use OnlyThere is a field in the product library for hotels, named `day_use_only`. Day use products must not be sold to customers wishing to have an overnight stay where `day_use_only` is set to 1.### Parking Includes ArrivalIn order to establish whether the package includes parking for the night of the hotel stay the `parking_includes_arrival` field needs to be taken into account.Where this field is set to 0, this means the night of the hotel stay is not included as there is free overnight parking. Parking stay will start from the following day. Where it is set to 1, this means that parking starts from the date the customer checks into the hotel.### Mystery / Un-named ProductsThere are some hotels in which the name field will not provide the name of the hotel e.g `Mystery 4-star hotel`.  The name of these hotels should not be provided to the customer until the booking is made, along with other identifying details such as address, hotel images, restaurant names etc.### Lead time cancellationFlexible bookings become non flexible within a certain timeframe before the stay date ie booking turns non flexible within 30 days of stay.Scenario 1* Flexible booking made outside 60 days of stay.* Cancellation policy - only able to canx up to 30 days before stay date.* Booking is non flex within 30 days of stay date.Scenario 2* Flexible booking made inside 60 days of stay date.* Cancellation policy - only able to canx up to 3 days before stay date.* Booking is non flex within 3 days of stay date.## Worked ExamplesBelow are worked examples of both the requests and responses for hotel availability.### UK Hotel Availability Request - Room Only (zero days parking)```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=0```### UK Hotel Availability Response - Room Only (zero days parking)NB: This is a shortened example compiled from a full availability response.```xml            Mercure        LHRMEA        /v1/hotel/HPLHRMEA        /v1/product/LHRMEA                    1                45.00        45.90        2        1        TRL        RO        0        45.00        30        1        1        1                Thistle T5        LHRPAA        /v1/hotel/HPLHRPAA        /v1/product/LHRPAA                85.50        87.21        2        1        TRL        RO        0        85.50        30        1                    0                1                Hilton T5        LHRHLT        /v1/hotel/HPLHRHLT        /v1/product/LHRHLT                    1            1            1                99.00        100.98        2        1        TRL        RO        0        99.00                2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            0            1            ```### UK Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=8```### UK Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Mercure with Purple Parking Meet and Greet        LHRMPU        /v1/hotel/HPLHRMPU        /v1/product/LHRMPU                    1            1            1            1            1            1            1                129.00        131.58        2        1        TRL        RO        8        129.00        LHR5        LHR5                    1                        Thistle T5 with parking at the hotel and breakfast        LHRPAT        /v1/hotel/HPLHRPAT        /v1/product/LHRPAT                130.00        132.60        2        1        TRL        RO        8        130.00                    1            1            0                       Sheraton Skyline with parking at the hotel       LHRSKA       /v1/hotel/HPLHRSKA       /v1/product/LHRSKA              134.00       136.68       2       1       TRL       RO       8       134.00                  0                     2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            8            1            ```### European Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/MUC?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=D20&ParkingDays=8&System=ABG&lang=de```### European Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Schweigers Landgasthof        MUCLAN        /v1/hotel/FRMUCLAN        /v1/product/MUCLAN                120.00        NaN        2        0        DZ        F        15        120.00                Airporthotel Regent        MUCREG        /v1/hotel/FRMUCREG        /v1/product/MUCREG                97.00        NaN        2        0        DZ        F        15        97.00                  NH München Airport          MUCAST          /v1/hotel/FRMUCAST          /v1/product/MUCAST                    113.00          NaN          2          0          DZ          U          8          113.00                0.00        0.00        0.00                                TESTG            Redacted            mytestkey            generate            2017-12-01            1            D20            8            ABG            de            1            ```",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/hotel/av/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-de-start": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "DE-Start",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# DE-StartThis documentation relates to an existing partner integration - it is NOT to be used or considered for any new partner integrations. The documentation relates to parking products only.## DE-Start EndpointsHere are the DE-Start specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/de-start/v1/carpark/AirportCode](/hxapi/de-start/airport)| GET    | | Booking at car park | [https://api.holidayextras.com/de-start/v1/carpark/CarParkCode](/hxapi/de-start/bkg)| POST   | | Cancel booking | [https://api.holidayextras.com/de-start/v1/booking/YourBookingRef](/hxapi/de-start/cancel)| GET / POST   |",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/de-start/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-hotel": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Hotels",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Hotels[API Docs](/hxapi/) > product:[Hotels](index)## Hotel EndpointsHere are the hotel specific endpoints: | Action                                     | Endpoint                                                                         | Method | | ------                                     | --------                                                                         | ------ | | Availability at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](av)            | GET    | | Make booking at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](bkg)           | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck](priceCheck) | GET    |Please note: All hotel requests include parking options of zero, 8 and 15 days parking. To make a request for a hotel only product, please select zero days parking.## Hotel User JourneyTo follow -",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/hotel/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-productlibrary": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Product Library",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Product LibraryThe data returned from a Product Library request depends on the type of product you ask for. A request for a car park returns different fields than a request for a hotel.By default, only fields that contain a value are returned.You can specify the fields you want returned. Simply add the parameter fields and specify the field names. An error/warning element will be returned for any fields which do not exist, but the request will still return those elements for which there is a value. If you request a valid field, but there is no value, it will not be returned.The purpose of most of the fields should be self-explanatory. If there is anything you do not understand, please email . There are no guarantees about the types of data returned, you should make no assumptions about a specific field being an integer etc.Data returned should not be cached locally for periods of time greater than one day (24 hours).### URL/product/{productCode}### MethodGET### Parameters| Name   | Format | Required ||--------|--------|----------|| token  | String | N        || key    | String | Y        || fields | String | N        |## Available FieldsThe available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.{% codetabs %}{% codetab Parking %}{% include_relative _parkingFields.md %}{% endcodetab %}{% codetab Hotel room only %}{% include_relative _hotelOnlyFields.md %}{% endcodetab %}{% codetab Hotel with parking %}{% include_relative _hotelParkingFields.md %}{% endcodetab %}{% codetab Lounge %}{% include_relative _loungeFields.md %}{% endcodetab %}{% codetab Fast track %}{% include_relative _fastTrackFields.md %}{% endcodetab %}{% endcodetabs %}---## Examples### Example 1 - Default Response#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_1.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_1.json %}```{% endcodetab %}{% endcodetabs %}---### Example 2 - Restricted field list#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_2.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_2.json %}```{% endcodetab %}{% endcodetabs %}---### Example 3 - German Parking Request#### RequestRequests for German products return a different set of fields. Explanation of fields not currently available.{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_3.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_3.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/productlibrary/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-lounge": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Lounge",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# LoungeHere are the lounge specific endpoints:| Request | Endpoint | Method || --- | --- | --- || Availability of lounges at airport | [https://api.holidayextras.com/v1/lounge/AirportCode](av/airport) | GET || Make booking for lounge | [https://api.holidayextras.com/v1/lounge/LoungeCode](bkg) | POST |",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/lounge/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-transfers-av": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Transfers Availability",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Transfers Availability## Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/search```Here is an example:```https://api.holidayextras.com/v1/transfers/search?token=[TOKEN]&key=[KEY]&ABTANumber=[ABTA]&FromDate=2020-08-01&FromTime=1000&ReturnDate=2020-08-07&ReturnTime=1730&PickUp=AGP&PickUpType=IATA&DropOff=85101062&DropOffType=TTI&OutFlight=U28605&ReturnFlight=U28602&Adults=2```### Request ParametersNB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                       ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                  || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                            || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                          || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                          || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                   || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                  || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                  || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                   || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.  || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                       || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                     || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                        || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                    || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                              || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                               || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                  || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                            || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                  || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines. || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                      || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                    || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                       || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                   || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                             || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                              || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                 || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                 || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                       || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                     || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                      || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                            || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                     |#### Dates and TimesIt's important to note that availability should be requested with accurate dates and times. A good scenario would be if an Airport Transfer is required, where the `PickUp` would be an Airport and the `DropOff` would be a Hotel. The `FromDate` and `FromTime` should be the flight arrival date and time. If a return transfer is requested, then the `ReturnDate` and `ReturnTime` should be the flight departure date and time, our system will calculate an estimated pickup time from the Hotel.## Availability ResponseIf availability has been found for the requested parameters, the response will contain a `Transfers` field with all the nested Transfers available. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                      | Additional Information                                                                                      ||----------------------------|-------------------------------------------------------------------------------------------------------------|| Transfers/Name             | The name of the Transfer.                                                                                   || Transfers/Code             | The product code for the transfer, which must be used in the booking request.                               || Transfers/BookingURL       | The URL to POST the booking request to for this particular product.                                         || Transfers/TotalPrice       | The total price of the Transfer/s.                                                                          || Transfers/NonDiscPrice     | If a discount has been applied, this is the total price before discount.                                    || Transfers/SalesCurrency    | Three character identifier for the sale currency to qualify the price.                                      || Transfers/Images/Src       | Link to a image for the product. Prefix with `https:`.                                                      || Transfers/Images/Alt       | The alt tag for the image.                                                                                  || Transfers/Category         | The category assigned to the Transfer/s, for the full list of categories [please see below](/hxapi/transfers/av/#transfer-categories). || Transfers/Disclaimer       | Depending on supplier and transfer type, the Disclaimer will contain pickup details.                        || Transfers/ProviderDetails  | Shows the providers name and rating (if applicable).                                                        || Transfers/Cancellation     | Shows the cancellation period before pickup date/time.                                                      || Transfers/VehicleDetails   | Details about the vehicle being used for the Transfer/s.                                                    || Transfers/OutboundTransfer | Details about the outbound transfer.                                                                        || Transfers/ReturnTransfer   | Details about the return transfer (This field will be `null` if no return was requested).                   || Transfers/PartnerOwnSupply | Product originates from partner’s own supply. Your account manager will confirm whether you should use this. || Transfers/SupplierCost     | Supplier cost for this transfer. Only available for selected products and requests.                     |#### [Transfer Categories](#transfer-categories)Here are the available categories which may be returned, there will only be one category assigned to each Transfer:- private_adapted_vehicle- private_car- private_coach- private_electric_car- private_excutive_car- private_executive_electric_car- private_helicopter- private_limousine- private_luxury_car- private_minibus- private_minivan- private_sea_plane- private_speed_boat- private_suv- private_water_taxi- shared_express_shuttle- shared_shuttle- shared_water_taxi### Example```json{    \"API_Reply\": {        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 1,            \"Result\": \"OK\",            \"cached\": true,            \"expires\": \"2020-07-21 15:20:14\"        },        \"Transfers\": [            {                \"ATTRIBUTES\": [],                \"Name\": \"Shuttle\",                \"Code\": \"TBHT39\",                \"BookingURL\": \"/v1/transfers/TBHT39.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 103.52,                \"NonDiscPrice\": 103.52,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"shared_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:30\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Speedy Shuttle\",                \"Code\": \"TBHT519\",                \"BookingURL\": \"/v1/transfers/TBHT519.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 134.8,                \"NonDiscPrice\": 134.8,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"speedy_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:45\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Car\",                \"Code\": \"TBHT43\",                \"BookingURL\": \"/v1/transfers/TBHT43.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 201.72,                \"NonDiscPrice\": 201.72,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_transfer\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Executive Car\",                \"Code\": \"TBHT18\",                \"BookingURL\": \"/v1/transfers/TBHT18.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 291.86,                \"NonDiscPrice\": 291.86,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_luxury.jpeg\",                        \"Alt\": \"private luxury\"                    }                ],                \"Category\": \"private_executive\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Minibus\",                \"Code\": \"TBHT2\",                \"BookingURL\": \"/v1/transfers/TBHT2.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 295.32,                \"NonDiscPrice\": 295.32,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_minibus\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 5,                    \"MaxCapacity\": 8,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 8,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            }        ],        \"Pricing\": {},        \"SepaID\": \"\",        \"API_Header\": {            \"Request\": {                \"ABTANumber\": \"YourABTANumber\",                \"Password\": \"YourPassword\",                \"Initials\": \"YourInitials\",                \"key\": \"YourKey\",                \"token\": \"YourToken\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1000,                \"ReturnDate\": \"2020-08-07\",                \"ReturnTime\": 1730,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"OutFlight\": \"U28605\",                \"ReturnFlight\": \"U28602\",                \"Adults\": 2,                \"v\": 1,                \"format\": \"js\"            }        }    }}```### Worked ExamplesBelow are some worked examples of both the request and response when requesting transfers availability.#### Airport to GIATA##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      GIATA      439771      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"GIATA\",        \"DropOff\": 439771,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to TTI##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      TTI      10147575      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"TTI\",        \"DropOff\": 10147575,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to Postal Address##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP          //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg      private standard        private_transfer                                                  72      100      0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      postal-address      Hotel Rural Castillo De Biar      Carretera de Banyeres      s/n      Biar      Alicante      03410      ES      -0.76832006      38.63852215      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 16:26:43\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [{          \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",          \"Alt\": \"private standard\"        }],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      }    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"postal-address\",        \"DropOffName\": \"Hotel Rural Castillo De Biar\",        \"DropOffAddress\": [          \"Carretera de Banyeres\",          \"s/n\"        ],        \"DropOffTown\": \" Biar\",        \"DropOffCounty\": \"Alicante\",        \"DropOffPostcode\": \"03410\",        \"DropOffCountryCode\": \"ES\",        \"DropOffLongitude\": -0.76832006,        \"DropOffLatitude\": 38.63852215,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/transfers/av/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-viewamendcancel": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Manage A Booking",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Manage A Booking[API Docs](/hxapi/) > product:[viewamendcancel](index)## Manage A Booking EndpointsHere are the endpoints for managing a booking:| View booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](view) | GET || Amend booking - Simple | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_simple) | POST || Amend booking - Complex | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_complex) | POST || Cancel booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](cancel) | POST |## Manage A Booking Top TipsThe three methods provided will enable your customers via your integration to manage their own booking online.### Amending a bookingWe allow both simple and complex amends:- A ***simple amend*** is where the booking details are updated, without affecting the price. This is also known as an \"amend no re-price\". For example, adding a car registration number to a parking booking.- A ***complex amend*** is where the booking details are updated and this does affect the price. This is also known as an \"amend re-price\". For example, changing the date of a booking.",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/viewamendcancel/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-transfers-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Transfers Booking",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Transfers Booking## Booking Request### MethodPOST### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/[CODE]```Where ```[CODE]``` is the product code received in the availability request of the product you want to book.Here is an example for the following Availability response:```TBHT1169922/transfers/TBHT1169922...```Your Make Booking request will have the following URL: https://api.holidayextras.com/v1/transfers/TBHT1169922### Request ParametersThe parameters _must_ be sent in the body of the request, as `x-www-form-urlencoded` data.NB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   ||--------------------|-----------|------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                              || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                        || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                                      || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                                                                                                                                                                                                                                              || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                              || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                              || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                                || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                                                                                                                                                                                                                                              || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                        || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                             || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                               || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                                                                                                                                                                                                                                             || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                                                                                                                                                                                                                                             || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                        || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                 || Title              | String    | [A-Z]            | Y          | Title of lead passenger, an option from the [list of valid titles](/hxapi/reference/titles)                                                                                                                                                                                                                                                                                                                                                                                                                              || FirstName          | String    | [A-Z]            | Y          | The lead passenger's first name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || LastName           | String    | [A-Z]            | Y          | The lead passenger's last name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || Email              | String    | [A-Z] 50 chars   | Y          | The lead passenger's email address.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || DayPhone           | Integer   | [0-9] 20 chars   | Y          | The lead passenger's contact telephone number.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || Price              | Float     | [0-9]            | Y          | The total price of the Transfer/s (This will be the value of the `TotalPrice` property returned in the availability response).                                                                                                                                                                                                                                                                                                                                                                                           || PriceCheckFlag     | String    | Y/N              | N          | Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.         || PriceCheckPrice    | Float     | [0-9]            | N          | Price of the product, received from the availability request or price check.  Only required when `PriceCheckFlag` is `Y`                                                                                                                                                                                                                                                                                                                                                                                                 |#### PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers' payment details being passed to us via the API. Further details can be found in our section on [Payment](/hxapi/payment).Please contact your Account Manager if you have any questions concerning payment.## Booking ResponseIf the booking has been successful, the response will contain a `Booking` field which will have a `BookingRef` property. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                                     | Additional Information                                                                                                                                     ||-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                        | The reference for the booking, use this reference in all communication with us relating to this booking.                                                   || Booking/AgentComm                         | Commission earned from this booking.                                                                                                                       || Booking/MoreInfoURL                       | The URL to GET more information about the booking (view [View Booking Request](../view) for more information).                        || Booking/Status (Future)                   | Indicates the current status of the booking (`Pending`, `Confirmed`, `Cancelled`, or `Error`).                                                             || Booking/SuggestedPollingInterval (Future) | Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier. |### Example```json{    \"API_Reply\": {        \"Booking\": {            \"BookingRef\": \"TBBGNHMT\",            \"AgentComm\": \"0.17\",            \"VATonComm\": \"0.00\",            \"MoreInfoURL\": \"/v1/booking/TBBGNHMT.js\",            \"Status\": \"Pending\",            \"SuggestedPollingInterval\": 3600        },        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 5,            \"Result\": \"OK\"        },        \"API_Header\": {            \"Request\": {                \"key\": \"TEST\",                \"token\": \"d2d6dedd-606f-4f00-aa8c-526a358e927c\",                \"ABTANumber\": \"TESTL\",                \"Password\": \"Redacted\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1255,                \"ReturnDate\": \"2020-08-10\",                \"ReturnTime\": 1355,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"Adults\": 2,                \"Title\": \"MR\",                \"FirstName\": \"Test\",                \"LastName\": \"Test\",                \"Email\": \"test@holidayextras.com\",                \"DayPhone\": \"07123456789\",                \"Price\": 103.52,                \"OutFlight\": \"LS1405\",                \"ReturnFlight\": \"LS1406\",                \"v\": 1,                \"format\": \"js\"            }        }    }}```[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/transfers/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-carhire": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Car Hire",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Car Hire[API Docs](/hxapi/) > product:[Car Hire](index)These are the car hire requests.| Action | Endpoint | Method || --- | --- | --- || Lookup Locations | [https://api.holidayextras.com/v1/carHire/locations](locations) | GET || Availability | [https://api.holidayextras.com/v1/carHire/products](availability) | GET || Make Booking | [https://api.holidayextras.com/v1/carHire/](booking/make) | POST || Lookup Booking | [https://api.holidayextras.com/v1/carHire-booking/](booking/lookup) | GET |",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/carhire/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-transfers": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Transfers",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Transfers[API Docs](/hxapi/) > product:[Transfers](index)## Transfer EndpointsWhen using the Transfer endpoints below, you will be able to search using various types of location data which will represent the transfers pickup and dropoff points. Currently, the API will accept IATA Codes, TTI Codes and Postcodes (Postcodes can be used for UK Transfers).You will need a token to call the api. To get the user token use the existing endpoint: [Get Token](https://docs.holidayextras.co.uk/hxapi/usertoken/).For the complete API specification, see the [OpenAPI schema](https://api.holidayextras.com/v1/transfers/openapi.yml). | Action                     | Endpoint                                                                     | Method | | ------                     | --------                                                                     | ------ | | Availability               | [https://api.holidayextras.com/v1/transfers/search](av)                    | GET    | | Make Booking               | [https://api.holidayextras.com/v1/transfers/[TransferCode]](bkg)           | POST   | | View Booking               | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](view)    | GET    | | Cancel Booking             | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](cancel)  | DELETE | | Cancellation Policy        | [https://api.holidayextras.com/v1/transfers/[BookingRef]/cancellation-policy](cancellation-policy) | GET    | | Amend Booking              | not supported                                                                |   -    |",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/transfers/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-upgrade": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Product Upgrades",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Product Upgrades[API Docs](/hxapi/) > [Product Upgrades](/hxapi/upgrade)## Upgrades Availability RequestUpgrades are currently only supported for parking, hotel and lounge bookings. Upgrades can be requested on a per product basis.#### MethodGET#### Endpoint/upgrade/{productCode}NB: Where `productCode` is the code of the base product i.e. the parking/hotel/lounge etc. product.```https://api.holidayextras.com/v1/upgrade/LGV4```## Request Parameters| Name        | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                          ||-------------|-----------|------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber  | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                 || Password    | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials    | String    | [A-Z] 3 chars    | N          | The initials of the Operator / Agent.                                                                                                                           || key         | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                             || token       | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                      || ArrivalDate | String    | YYYY-MM-DD       | Y          | This should be the same as the `ArrivalDate` from the base product request.                                                                                     || ArrivalTime | Time      | HHMM             | Y          | This should be the same as the `ArrivalTime` from the base product request.                                                                                     || DepartDate  | Date      | YYYY-MM-DD       | N          | This should be the same as the `DepartDate` from the base product request.                                                                                      || DepartTime  | Time      | HHMM             | N          | This should be the same as the `DepartTime` from the base product request.                                                                                      || Adults      | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of adults in the party                                                                                            || Children    | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of children in the party                                                                                          |## Upgrade Availability ResponseThe response will return a list of available upgrades.Upgrades are sold on a per booking, per person, or per room basis.Upgrades can be for the day before travel, day of departure or day of return.| Field              | Additional Information                                                                      ||--------------------|---------------------------------------------------------------------------------------------|| Code               | Product code for the upgrade                                                                || Name               | Name of the upgrade                                                                         || Per                | Pricing basis, either per *P*erson, per *B*ooking, per *R*oom                               || Canx               | Whether the upgrade is cancellable (Y/N)                                                    || description        |                                                                                             || supplement_type    | Type classification for the upgrade                                                         || Date               | Date the upgrade is to be booked for. Format YYYY-MM-DD                                     || only_for_adults    | Upgrades restricted to adult only parties e.g. Adult only lounges                           || Price              | The price of the upgrade minus any discounts. Only present for per booking upgrades         || NonDiscPrice       | The total price of the upgrade before discounts. Only present for per booking upgrades      || DiscAmt            | The amount of any discount applied. Only present for per booking upgrades                   || AdPrice            | The per adult price minus any discounts. Only present for per person upgrades               || NonDiscAdPrice     | The per adult price before any discounts. Only present for per person upgrades              || AdDiscAmt          | The amount of discount applied to the per adult price. Only present for per person upgrades || ChPrice            | The per child price minus any discounts. Only present for per person upgrades               || NonDiscChPrice     | The per child price before any discounts. Only present for per person upgrades              || ChDiscAmt          | The amount of discount applied to the child price. Only present for per person upgrades     || API_Header/Request | The API returns every parameter and value you sent in the request.                          |## Examples### Example 1 - Carpark Upgrades#### Request{% codetabs %}  {% codetab XML %}  ```https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45  ```  {% endcodetab %}  {% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/STN5.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```  {% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_1_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_1_response.json %}```{% endcodetab %}{% endcodetabs %}### Example 1 - Hotel Upgrades#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/LGWSOF.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_2_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_2_response.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/upgrade/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  @@ -400,17 +400,17 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "payment-gateway-v2-pay": {
                                                                                                                                                                                                                                                                                                                                                                                  +      "payment-gateway-v1-pay": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Payment Gateway: Pay",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v2/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.**Note**: We have added postalCode and countryCode as NatWest have started refusing payments without this information.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v2+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [0-9A-Z]{16} | N | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. If this is not supplied, then one will be generated for this payment and returned as part of the result. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | Integer | [0-9] | Y | The price (in pence) to be paid. | | currency | String | [A-Z]{3} | Y | ISO 4217 standard currency code for the currency of this payment | | postalCode | String | [A-Z0-9] | N | The postal code for the payment's billing address. | | countryCode | String | [A-Z]{2} | N | ISO 3166-1 alpha-2 standard country code for the billing address. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v2+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": 1234,  \"currency\": \"GBP\",  \"postalCode\": \"CT21 4JF\",  \"countryCode\": \"GB\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/payment-gateway/v2/pay/"
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v1/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v1+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [A-Z] | Y | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | String | [0-9] | Y | The price (in pence) to be paid. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v1+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"paymentId\": \"testPaymentId\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": \"1234\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/payment-gateway/v1/pay/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "payment-gateway-v1-pay": {
                                                                                                                                                                                                                                                                                                                                                                                  +      "payment-gateway-v2-pay": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Payment Gateway: Pay",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v1/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v1+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [A-Z] | Y | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | String | [0-9] | Y | The price (in pence) to be paid. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v1+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"paymentId\": \"testPaymentId\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": \"1234\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/payment-gateway/v1/pay/"
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v2/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.**Note**: We have added postalCode and countryCode as NatWest have started refusing payments without this information.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v2+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [0-9A-Z]{16} | N | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. If this is not supplied, then one will be generated for this payment and returned as part of the result. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | Integer | [0-9] | Y | The price (in pence) to be paid. | | currency | String | [A-Z]{3} | Y | ISO 4217 standard currency code for the currency of this payment | | postalCode | String | [A-Z0-9] | N | The postal code for the payment's billing address. | | countryCode | String | [A-Z]{2} | N | ISO 3166-1 alpha-2 standard country code for the billing address. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v2+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": 1234,  \"currency\": \"GBP\",  \"postalCode\": \"CT21 4JF\",  \"countryCode\": \"GB\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/payment-gateway/v2/pay/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  @@ -421,13 +421,6 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-hotel-pricecheck": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Hotel Price Check",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Hotel Price CheckThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.## MethodGET## EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck```For example, for _Mercure at London Heathrow_ the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck```## Request ParametersNB: All parameter names are case sensitive.| Name                   | Data Type | Format             | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       ||------------------------|-----------|--------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber             | String    | [A-Z0-9] 5 chars   | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                              || Password               | String    | [A-Z0-9] 5 chars   | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                              || Initials               | String    | [A-Z] 3 chars      | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        || key                    | String    | [A-Z]              | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                          || token                  | String    | [0-9] 9 chars      | Y          | This is the same token used in the availability request.                                                                                                                                                                                                                                                                                                                                                                                                                                                     || ArrivalDate            | Date      | YYYY-MM-DD         | Y          | Date customer arrives at hotel.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              || Nights                 | Integer   | 1, 2, 3, etc       | Y          | Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays.                                                                                                                                                                                                                                                                                                                                                                             || RoomCode               | String    | [A-Z0-9] 3 chars   | Y          | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes.                                                                                                                                                                                                                                                                                                                                                                                                                                            || Adults                 | Integer   | [1-5] 1 char       | Y          | The number of adults occupying the room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     || Children               | Integer   | [0-4] 1 char       | Y          | The number of children occupying the room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || ParkingDays            | Integer   | [0-9] 2 chars      | Y          | NB: The maximum duration accepted for ParkingDays is 30.                                                                                                                                                                                                                                                                                                                                                                                                                                                     || CustomerRef            | String    | [A-Z0-9] 20 chars  | N          | Enter your Customer Reference to help match bookings for accounting purposes.                                                                                                                                                                                                                                                                                                                                                                                                                                || Remarks                | String    | [A-Z0-9] 60 chars  | N          | Pass in Remarks for notification such as COT REQUESTED in ROOM                                                                                                                                                                                                                                                                                                                                                                                                                                               || Waiver                 | Boolean   | [0,1]              | Y          | Defaults to 0 if not supplied.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               || DataProtection         | String    | [Y,N]              | N          | Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied.                                                                                                                                                                                                                                                                                                                                         || System                 | String    | [A-Z] 3 chars      | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                                                                                                                                                                               || lang                   | String    | [A-Z] 2 chars      | Y*         | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.)                                                                                                                                                                                                                                                                                                                                                                                                   |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/hotel/bkg).## Multiple rooms on same bookingThe additional parameters for including a second room are:| Name               | Data Type | Format                              | Mandatory? | Additional Information                                                                                                                                ||--------------------|-----------|-------------------------------------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|| SecondRoomType     | String    | [A-Z0-9] 2 chars                    | N*         | This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per [Room Codes](/hxapi/types/roomcode). || SecondRoomCode     | String    | [Room Codes](/hxapi/types/roomcode) | N          | NB: Please note that the room codes differ between availability and booking requests.                                                                 || SecondRoomAdults   | Integer   | [1-5] 1 char                        | N          | The number of adults occupying the second room.                                                                                                       || SecondRoomChildren | Integer   | [0-4] 1 char                        | N          | The number of children occupying the second room.                                                                                                     |## UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are:| Name           | Data Type | Format            | Mandatory? ||----------------|-----------|-------------------|------------|| CarDropoffDate | Date      | YYYY-MM-DD        | Y          || CarDropoffTime | Time      | HHMM              | Y          || CarPickupDate  | Date      | YYYY-MM-DD        | Y          || CarPickupTime  | Time      | HHMM              | Y          |# Hotel Price Check Response| Field                   | Additional Information                                                                                                                                                                                        ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice      | This is the total price for the booking including all upgrades || API_Header/Request | A list of parameters that were sent in the booking request.                                                                                                                                               |# Worked ExamplesBelow are worked examples of both the request and response for the price check for hotels.## UK Hotel price check### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0```### Response```xml{% include_relative examples/_uk_room_only_price_check_response.xml %}```## UK Hotel price check with Upgrades### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-10&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0&Supplements[0][Code]=LGWSOE&Supplements[0][Date]=2025-07-10&Supplements[0][Quantity]=1&Supplements[0][TotalPrice]=40.00&Supplements[1][Code]=LGWASC&Supplements[1][Date]=2025-07-11&Supplements[1][Adults]=2&Supplements[1][Children]=0&Supplements[1][TotalPrice]=82.00```### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```## Error example: no availability### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=0&Nights=1&ArrivalDate=2024-10-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_no_availability_response.xml %}```## Error example: validation error### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=2&Nights=1&ArrivalDate=2024-11-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_validation_error_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/hotel/priceCheck/"
                                                                                                                                                                                                                                                                                                                                                                                  -      }
                                                                                                                                                                                                                                                                                                                                                                                  -      ,
                                                                                                                                                                                                                                                                                                                                                                                  -    
                                                                                                                                                                                                                                                                                                                                                                                         "hxapi-parking-pricecheck": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Car Park Price Check",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "# Car Park Price Check[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av) > [Price Check](/hxapi/parking/priceCheck)## Car Park Pre-booking Price Check RequestThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck```For example, for _Maple Manor Meet and Greet at London Gatwick North terminal_ the endpoint is:```https://api.holidayextras.com/v1/carpark/LGW4/priceCheck```### Request ParametersNB: All parameter names are case sensitive.| Name                   | Data Type | Format            | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           ||------------------------|-----------|-------------------|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber             | String    | [A-Z0-9] 5 chars  | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                  || Password               | String    | [A-Z0-9] 5 chars  | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                  || Initials               | String    | [A-Z] 3 chars     | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            || key                    | String    | [A-Z]             | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                              || token                  | String    | [0-9] 9 chars     | Y          | This is the same token used in the availability request.                                                                                                                                                                                                                                                                                                                                                                                                                                                         || ArrivalDate            | Date      | YYYY-MM-DD        | Y          | Date customer drops vehicle at car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || ArrivalTime            | Time      | HHMM              | Y          | Time customer drops vehicle at car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || DepartDate             | Date      | YYYY-MM-DD        | Y          | Date customer picks up vehicle from car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || DepartTime             | Time      | HHMM              | Y          | Time customer picks up vehicle from car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || NumberOfPax            | Integer   | [0-9] 2 chars     | Y          | Number of passengers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            || System                 | String    | [A-Z] 3 chars     | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                                                                                                                                                                                   |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/parking/bkg).## Car Park Price Check Response| Field                   | Additional Information                                                                                                                                                                                        ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice      | This is the total price for the booking including all upgrades || API_Header/Request      | A list of parameters that were sent in the booking request.                                                                                                                                                   |## Worked ExamplesBelow are worked examples of both the request and response for the price check for parking.### UK Parking price check#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1200&DepartDate=2025-07-08&DepartTime=1200&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_response.xml %}```### UK Parking price check with Upgrades#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1230&DepartDate=2025-07-08&DepartTime=1345&NumberOfPax=1&Supplements[0][Code]=HXOST1&Supplements[0][Date]=2025-07-01&Supplements[0][Quantity]=1&Supplements[1][Code]=LHRSFS&Supplements[1][Date]=2025-07-01&Supplements[1][Adults]=2&Supplements[1][Children]=1```#### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```### Error example: no availability#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-09-15&ArrivalTime=1300&DepartDate=2024-09-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_no_availability_response.xml %}```### Error example: request which is incorrect or can't be actioned#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-11-15&ArrivalTime=2500&DepartDate=2024-11-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_incorrect_request_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                  @@ -435,10 +428,10 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "payment-gateway-v2-refund": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "Payment Gateway: Refund",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# Payment Gateway: Refund[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Refund](/payment-gateway/v2/refund)## Refund RequestThis endpoint will make a refund based on existing payments.### MethodPOST### EndpointTo make a refund, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/refund```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v2+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | payments | Array | [String, String] | Y | An array listing all payments made for this booking. | | amount | Integer | [0-9] | Y | The price (in pence) to be refunded. |## Refund ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been refunded | | status | The status of the refund | | error | The error if the refund fails |## ExamplesBelow are examples of both the request and response for a refund.### Refund Request**POST**  `https://payment-gateway.holidayextras.co.uk/refund`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v2+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"payments\": [\"testPaymentId1\", \"testPaymentId2\"],  \"amount\": 1234}```### Refund Response#### Successful Refund```{    \"amount\": 12.34,    \"id\": \"REFUND-testPaymentId1\",    \"status\": \"SUCCESS\"}```#### Failed Refund```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed making refund\"}```",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/payment-gateway/v2/refund/"
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-hotel-pricecheck": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Hotel Price Check",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Hotel Price CheckThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.## MethodGET## EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck```For example, for _Mercure at London Heathrow_ the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck```## Request ParametersNB: All parameter names are case sensitive.| Name                   | Data Type | Format             | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       ||------------------------|-----------|--------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber             | String    | [A-Z0-9] 5 chars   | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                              || Password               | String    | [A-Z0-9] 5 chars   | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                              || Initials               | String    | [A-Z] 3 chars      | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        || key                    | String    | [A-Z]              | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                          || token                  | String    | [0-9] 9 chars      | Y          | This is the same token used in the availability request.                                                                                                                                                                                                                                                                                                                                                                                                                                                     || ArrivalDate            | Date      | YYYY-MM-DD         | Y          | Date customer arrives at hotel.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              || Nights                 | Integer   | 1, 2, 3, etc       | Y          | Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays.                                                                                                                                                                                                                                                                                                                                                                             || RoomCode               | String    | [A-Z0-9] 3 chars   | Y          | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes.                                                                                                                                                                                                                                                                                                                                                                                                                                            || Adults                 | Integer   | [1-5] 1 char       | Y          | The number of adults occupying the room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     || Children               | Integer   | [0-4] 1 char       | Y          | The number of children occupying the room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || ParkingDays            | Integer   | [0-9] 2 chars      | Y          | NB: The maximum duration accepted for ParkingDays is 30.                                                                                                                                                                                                                                                                                                                                                                                                                                                     || CustomerRef            | String    | [A-Z0-9] 20 chars  | N          | Enter your Customer Reference to help match bookings for accounting purposes.                                                                                                                                                                                                                                                                                                                                                                                                                                || Remarks                | String    | [A-Z0-9] 60 chars  | N          | Pass in Remarks for notification such as COT REQUESTED in ROOM                                                                                                                                                                                                                                                                                                                                                                                                                                               || Waiver                 | Boolean   | [0,1]              | Y          | Defaults to 0 if not supplied.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               || DataProtection         | String    | [Y,N]              | N          | Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied.                                                                                                                                                                                                                                                                                                                                         || System                 | String    | [A-Z] 3 chars      | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                                                                                                                                                                               || lang                   | String    | [A-Z] 2 chars      | Y*         | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.)                                                                                                                                                                                                                                                                                                                                                                                                   |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/hotel/bkg).## Multiple rooms on same bookingThe additional parameters for including a second room are:| Name               | Data Type | Format                              | Mandatory? | Additional Information                                                                                                                                ||--------------------|-----------|-------------------------------------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|| SecondRoomType     | String    | [A-Z0-9] 2 chars                    | N*         | This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per [Room Codes](/hxapi/types/roomcode). || SecondRoomCode     | String    | [Room Codes](/hxapi/types/roomcode) | N          | NB: Please note that the room codes differ between availability and booking requests.                                                                 || SecondRoomAdults   | Integer   | [1-5] 1 char                        | N          | The number of adults occupying the second room.                                                                                                       || SecondRoomChildren | Integer   | [0-4] 1 char                        | N          | The number of children occupying the second room.                                                                                                     |## UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are:| Name           | Data Type | Format            | Mandatory? ||----------------|-----------|-------------------|------------|| CarDropoffDate | Date      | YYYY-MM-DD        | Y          || CarDropoffTime | Time      | HHMM              | Y          || CarPickupDate  | Date      | YYYY-MM-DD        | Y          || CarPickupTime  | Time      | HHMM              | Y          |# Hotel Price Check Response| Field                   | Additional Information                                                                                                                                                                                        ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice      | This is the total price for the booking including all upgrades || API_Header/Request | A list of parameters that were sent in the booking request.                                                                                                                                               |# Worked ExamplesBelow are worked examples of both the request and response for the price check for hotels.## UK Hotel price check### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0```### Response```xml{% include_relative examples/_uk_room_only_price_check_response.xml %}```## UK Hotel price check with Upgrades### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-10&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0&Supplements[0][Code]=LGWSOE&Supplements[0][Date]=2025-07-10&Supplements[0][Quantity]=1&Supplements[0][TotalPrice]=40.00&Supplements[1][Code]=LGWASC&Supplements[1][Date]=2025-07-11&Supplements[1][Adults]=2&Supplements[1][Children]=0&Supplements[1][TotalPrice]=82.00```### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```## Error example: no availability### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=0&Nights=1&ArrivalDate=2024-10-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_no_availability_response.xml %}```## Error example: validation error### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=2&Nights=1&ArrivalDate=2024-11-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_validation_error_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/hotel/priceCheck/"
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  @@ -449,6 +442,13 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  +      "payment-gateway-v2-refund": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "Payment Gateway: Refund",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# Payment Gateway: Refund[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Refund](/payment-gateway/v2/refund)## Refund RequestThis endpoint will make a refund based on existing payments.### MethodPOST### EndpointTo make a refund, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/refund```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v2+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | payments | Array | [String, String] | Y | An array listing all payments made for this booking. | | amount | Integer | [0-9] | Y | The price (in pence) to be refunded. |## Refund ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been refunded | | status | The status of the refund | | error | The error if the refund fails |## ExamplesBelow are examples of both the request and response for a refund.### Refund Request**POST**  `https://payment-gateway.holidayextras.co.uk/refund`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v2+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"payments\": [\"testPaymentId1\", \"testPaymentId2\"],  \"amount\": 1234}```### Refund Response#### Successful Refund```{    \"amount\": 12.34,    \"id\": \"REFUND-testPaymentId1\",    \"status\": \"SUCCESS\"}```#### Failed Refund```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed making refund\"}```",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/payment-gateway/v2/refund/"
                                                                                                                                                                                                                                                                                                                                                                                  +      }
                                                                                                                                                                                                                                                                                                                                                                                  +      ,
                                                                                                                                                                                                                                                                                                                                                                                  +    
                                                                                                                                                                                                                                                                                                                                                                                         "hxapi-request24": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Amend-no-reprice",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "# Amend-no-repriceThis must be a POST, as you are amending a booking. It must be made over HTTPS, you must enforce this.Unlike the normal amend process, you will not be asked for confirmation before completing this. There is only one request to send for amend-no-reprice## /booking/YourBookingRef### MethodPOST### Parameters | Name           | Data Type | Format     | Required | | ----           | --------- | ------     | -------- | | StartCustomer  | String    | [0-9]{6}   | Y        | | BusinessUnit   | String    | [0-9]{3}   | Y        | | Operator       | String    | [A-Z]{3}   | Y        | | BookingRef     | String    | [A-Z0-9] {5,12} | Y        | | ReturnFlight   |           | [A-Z0-9] {10} | N        | | Remarks        | String    | [A-Z0-9] {60} | N        | | Pax            | Number    | [0-9] {2} | N        | | Registration   | String    | [A-Z0-9] {20} | Y        | | CarMake        | String    | [A-Z0-9] {20} | N        | | CarModel       | String    | [A-Z0-9] {20} | N        | | CarColour      | String    | [A-Z0-9] {20} | N        | | OutFltNo       | String    | [A-Z0-9] {10} | N        | | InFltNo        | String    | [A-Z0-9] {10} | N        | | OutFltTime     | Number    | HHMM       | N        | | InFltTime      | Number    | HHMM       | N        | | OutTerminal    |           | [A-Z0-9] {4} | N        | | RetTerminal    |           | [A-Z0-9] {4} | N        | | ShipName       |           | [A-Z0-9] {20} | N        | | PierName       |           | [A-Z0-9] {20} | N        | | ChildSeat      | Boolean   | [Y/N] | N        | | AddlServices   | Boolean   | [Y/N]| N        | | MobileNum      |           | [A-Z0-9] {15} | N        | | CarDropoffTime | Number    | HHMM       | N        | | CarPickupTime  | Number    | HHMM       | N        | | Title          | String    | [A-Z] {4}| Y        | | Initial        | String    | [A-Z] {1} | Y        | | Surname        | String    | [A-Z] {15} | Y        | | Address        | Striing   | [A-Z0-9] {25} | N        | | Town           | String    | [A-Z0-9] {20} | N        | | County         | String    | [A-Z0-9] {20} | N        | | PostCode       | String    | [A-Z0-9] {10} | N        | | DayPhone       |           | [A-Z0-9] {20} | N        | | EvePhone       |           | [A-Z0-9] {20} | N        | | Confirmation   | Boolean   | [Y/N]      | Y        | | DataProtection | Boolean   | [Y/N] | N        | | Email          | String    | [A-Z0-9] {50}| N        | | InvoiceReqd    | Boolean   | [Y/N]| N        | | TaxType        | String    | [A-Z0-9] {2} | N        | | TaxLocation    | String    | [A-Z0-9] {3} | N        | | InvLanguage    | String    | [A-Z0-9] {2} | N        | | InvHouseNo     | Integer   | [0-9] {4}    | N        | | InvCountry     | String    | [A-Z0-9] {20} | N        | | InvStreet      | String    | [A-Z0-9] {20} | N        | | InvTown        | String    | [A-Z0-9] {20} | N        | | InvPostcode    | String    | [A-Z0-9] {10} | N        | | InvCompany     | String    | [A-Z0-9] {40} | N        | | CustVATNo      | String    | [A-Z0-9] {10} | N        | | SupplierVATId  | String    | [A-Z0-9] {15} | N        | | InvTitle      | String    | [A-Z0-9] {4} | N        | | InvFirstName      | String    | [A-Z0-9] {20} | N        | | InvSurname      | String    | [A-Z0-9] {15} | N        | | InvEmail      | String    | [A-Z0-9] {50} | N        |### Requestsznt -> api```https://api.holidayextras.com/de-start/sandbox/v1/booking/10524994/?BookingRef=FBKM6&BusinessUnit=001&CarDropoffTime=1200&CarPickupTime=1300&Confirmation=Y&County=testcountyaenderung&Email=test.email&Initial=T&Operator=BJT&Remarks=test&Surname=Testnameaenderung&Title=Herr&TraveltainmentCustomer=111111&holidayextras.com=&key=YourKey```api -> chauntry```xml            111111        001        BJT        Y                FBKM6                        test                                                                                                                                                1200        1300                Herr        T        Testnameaenderung                testcountyaenderung                                Y                test.email                                                Herr        T        Testnameaenderung                                                                test.email    ```chauntry -> api```xml            111111        001        BJT        Y                FBKM6                        TEST                                                                                                                                                1200        1300                HERR        T        TESTNAMEAENDERUNG                TESTCOUNTYAENDERUNG                                Y                test.email                                                HERR        T        TESTNAMEAENDERUNG                                                                TOM.PRICE                            FBKM6            001            1200            1300            Y            testcountyaenderung            test.email            T            BJT            test            Testnameaenderung            Herr            111111                        YourKey            de            ABG            ```api -> zntNote this is the same as request chauntry -> api```xml            111111        001        BJT        Y                FBKM6                        TEST                                                                                                                                                1200        1300                HERR        T        TESTNAMEAENDERUNG                TESTCOUNTYAENDERUNG                                Y                test.email                                                HERR        T        TESTNAMEAENDERUNG                                                                TOM.PRICE                            FBKM6            001            1200            1300            Y            testcountyaenderung            test.email            T            BJT            test            Testnameaenderung            Herr            111111                        YourKey            de            ABG            ```### Request Fields ExplainedAny fields sent through in the level 24 request will amend what is saved to chipsFields include:BookingRef - Reference of the booking which is to be amendedAddress - An array of address lines to replace the current addressPax - Number of passengers#### Invoice Only Fieldslang - Language for the invoiceHouseNumberCountryCompanyCustomerVAT",
                                                                                                                                                                                                                                                                                                                                                                                  @@ -505,13 +505,6 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  -      "hxapi-viewamendcancel-view": {
                                                                                                                                                                                                                                                                                                                                                                                  -        "title": "View Booking",
                                                                                                                                                                                                                                                                                                                                                                                  -        "content": "# View Booking[API Docs](/hxapi/) > product:[view](/hxapi/viewamendcancel/view)## View Booking RequestThis method works for bookings made for any product type using our API.### MethodGET### EndpointThe endpoint to use is (where `YourBookingRef` is the Holiday Extras booking reference):{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}### Request ParametersNB: All parameter names are case sensitive.| Name       | Data Type | Format            | Mandatory? | Additional Information                                                                                                                                          ||------------|-----------|-------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String    | [A-Z0-9] 5 chars  | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                 || Password   | String    | [A-Z0-9] 5 chars  | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials   | String    | [A-Z] 3 chars     | N          | The initials of the Operator / Agent.                                                                                                                           || key        | String    | [A-Z]             | Y          | This will be assigned to you by your Account Manager during set up.                                                                                             || Email      | String    | [A-Z0-9] 50 chars | Y          | Email address used to make the booking (i.e. the email address of the lead passenger)                                                                           || System     | String    | [A-Z] 3 chars     | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                  |## View Booking ResponseThe view booking response will return all of the details against that booking record in our system.For a detailed explanation of the fields returned, please see below:| Field                                          | Additional Information                                                                                                                                                                                        ||------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                             | This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). || Booking/Amendable                              | This will return one of the following: `Y` = booking can be amended; `N` = booking cannot be amended; `C` = booking has been cancelled; `S` = booking is same day so cannot be amended or cancelled.          || Booking/CanxDate                               | If the booking has been cancelled, the date on which it was will return here.                                                                                                                                 || Booking/AgentComm                              | Commission you have earned from this booking.                                                                                                                                                                 || Booking/BookingDate                            | The date the booking was originally made on.                                                                                                                                                                  || Booking/PdfURL                                 | ⚠ Deprecated: This feature provided a link to generate a PDF version of the booking confirmation. It is no longer supported and will be removed in future releases.                                           || Itinerary                                      | This block will return details of the original booking, as per the booking response for each product type. Please see the respective booking guides for further details on the fields.                        || ClientDetails                                  | This block will return details of the lead passenger.                                                                                                                                                         || Pricing                                        | This block will return details of the price paid by the customer.                                                                                                                                             || VAT                                            | Please ignore this block.                                                                                                                                                                                     || CustRef                                        | If you have passed in a Customer Reference with your original booking request, it will return here.                                                                                                           || BarCode                                        | A link to generate a bar code for the booking confirmation.                                                                                                                                                   || QRCodeValue                                    | (EU only) Value of the QR code that comes with email confirmation. [More details about QR Code](/hxapi/barcode#qr_code)                                                                                       || QRCodeValueStr                                 | (EU only) Value of the QR code that comes with email confirmation. [More details about QR Code](/hxapi/barcode#qr_code)                                                                                       || SupplierRef                                    | (EU only) External booking id booking                                                                                                                                                                         || CurrentSupplements[]                           | Array of upgrades on the booking                                                                                                                                                                              || CurrentSupplements/Supplement/Code             | Upgrade product code                                                                                                                                                                                          || CurrentSupplements/Supplement/Price            | The price paid for the upgrade                                                                                                                                                                                || CurrentSupplements/Supplement/NonDiscPrice     | The price of the upgrade before any discounts                                                                                                                                                                 || CurrentSupplements/Supplement/DiscAmt          | The value of any discount applied                                                                                                                                                                             || CurrentSupplements/Supplement/Supplier         | Code for the supplier of the upgrade                                                                                                                                                                          || CurrentSupplements/Supplement/Rule             | Internal field                                                                                                                                                                                                || CurrentSupplements/Supplement/Req              | The purchased quantity of the upgrade                                                                                                                                                                         || CurrentSupplements/Supplement/Per              | The pricing basis of the upgrade                                                                                                                                                                              || CurrentSupplements/Supplement/Adults           | The number of adult passes purchased                                                                                                                                                                          || CurrentSupplements/Supplement/Children         | The number of chlid passes purchased                                                                                                                                                                          || CurrentSupplements/Supplement/Date             | The date of use for the upgrade                                                                                                                                                                               || CurrentSupplements/Supplement/Canx             | Whether the upgrade is cancellable                                                                                                                                                                            || CurrentSupplements/Supplement/Remarks          | Notes field. Used to store arrival time for lounge upgrades                                                                                                                                                   || AvailableSupplements[]                         | Array of upgrades available to purchase post booking                                                                                                                                                          || AvailableSupplements/Supplement/Code           | Upgrade product code                                                                                                                                                                                          || AvailableSupplements/Supplement/Supplier       | Code for the supplier of the upgrade                                                                                                                                                                          || AvailableSupplements/Supplement/Per            | The pricing basis of the upgrade                                                                                                                                                                              || AvailableSupplements/Supplement/Canx           | Whether the upgrade is cancellable                                                                                                                                                                            || AvailableSupplements/Supplement/Name           | The name of the upgrade product                                                                                                                                                                               || AvailableSupplements/Supplement/Price          | The price of the upgrade                                                                                                                                                                                      || AvailableSupplements/Supplement/NonDiscPrice   | The price of the upgrade before any discounts                                                                                                                                                                 || AvailableSupplements/Supplement/DiscAmt        | The value of any discount applied                                                                                                                                                                             || AvailableSupplements/Supplement/AdPrice        | The per adult price minus any discounts. Only present for per person upgrades                                                                                                                                 || AvailableSupplements/Supplement/NonDiscAdPrice | The per adult price before any discounts. Only present for per person upgrades                                                                                                                                || AvailableSupplements/Supplement/AdDiscAmt      | The amount of discount applied to the per adult price. Only present for per person upgrades                                                                                                                   || AvailableSupplements/Supplement/ChPrice        | The per child price minus any discounts. Only present for per person upgrades                                                                                                                                 || AvailableSupplements/Supplement/NonDiscChPrice | The per child price before any discounts. Only present for per person upgrades                                                                                                                                || AvailableSupplements/Supplement/ChDiscAmt      | The amount of discount applied to the child price. Only present for per person upgrades                                                                                                                       || AvailableSupplements/Supplement/PerNight       | Whether the upgrade is charged per night of a stay                                                                                                                                                            || API_Header/Request                             | A list of parameters that were sent in the view booking request.                                                                                                                                              || Booking/Status  (Future)                       | Indicates the current status of the booking (`Pending`, `Confirmed`, `Cancelled`, or `Error`).                                                                                                                |#### /Booking/AmendablePossible values*  Y - booking can be amended or cancelled*  N - booking cannot be amended or cancelled (advance purchase product etc)*  C - booking has been cancelled## Worked ExamplesBelow are worked examples of both the request and response for view a booking.### UK Products View Booking (for a car park)#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_view_uk_booking_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_view_uk_booking_response.json %}```{% endcodetab %}{% endcodetabs %}---### UK Products View Booking (for a transfer)#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_view_uk_transfers_booking_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_view_uk_transfers_booking_response.json %}```{% endcodetab %}{% endcodetabs %}---### European Products View Booking (for a hotel room only)#### Request```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com&System=ABG```#### Response```xml{% include_relative examples/_view_eu_booking_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                  -        "url": "/hxapi/viewamendcancel/view/"
                                                                                                                                                                                                                                                                                                                                                                                  -      }
                                                                                                                                                                                                                                                                                                                                                                                  -      ,
                                                                                                                                                                                                                                                                                                                                                                                  -    
                                                                                                                                                                                                                                                                                                                                                                                         "hxapi-transfers-view": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "Transfers View Booking",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "# Transfers View Booking## Important Notes- This endpoint provides comprehensive booking details including journey information, contact numbers, and cancellation policies- Use this endpoint to retrieve up-to-date booking status and transfer details- The response includes both outbound and return transfer information (if applicable)## View Booking Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/booking/[BookingRef]```Where ```[BookingRef]``` is the booking reference you received when making the original booking.For example:```https://api.holidayextras.com/v1/transfers/booking/TBBGNHMT```### Request ParametersNB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                       ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                  || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                            || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                          || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                   |## View Booking ResponseIf the booking is found, the response will contain detailed information about the transfer booking including journey details, cancellation policy, and contact information.For a detailed explanation of the fields returned, please see below:| Field                                     | Additional Information                                                                                                                                     ||-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                        | The reference for the booking.                                                                                                                             || Booking/SupplierRef                       | Reference number provided by the transfer supplier (for the overall booking).                                                                              || Booking/Status                            | Current status of the booking (e.g., Confirmed, Pending, Cancelled).                                                                                      || Booking/DateBooked                        | Date and time when the booking was made (ISO 8601 format, UTC timezone).                                                                                  || Booking/DateCancelled                     | Date and time when the booking was cancelled, if applicable (ISO 8601 format, UTC timezone).                                                              || Booking/Email                             | Email address associated with the booking.                                                                                                                 || Booking/Product/Price                     | Total price for the transfer booking.                                                                                                                      || Booking/Product/Currency                  | Currency in which the price is denominated.                                                                                                                || Booking/Product/Category                  | Category of the transfer product. See [Transfer Categories](/hxapi/transfers/av/#transfer-categories) for available options.                              || Booking/Product/TransferCode              | Unique code for the transfer product.                                                                                                                      || Booking/Product/Cancellation             | Cancellation policy details including period (in hours), percentage, and fee. For full cancellation details including refund calculations, use the [Cancellation Policy](/hxapi/transfers/cancellation-policy/) endpoint. || Booking/Product/VehicleDetails           | Details about the vehicle including capacity, stops, bags allowed, and whether it's private.                                                               || Booking/Product/OutboundTransfer         | Details of the outbound transfer journey including origin, destination, journey time, and pickup/arrival times.                                           || Booking/Product/ReturnTransfer           | Details of the return transfer journey (only present if the booking includes a return transfer).                                                           |### Transfer Details FieldsBoth `OutboundTransfer` and `ReturnTransfer` contain the following detailed information:| Field                | Additional Information                                                        ||----------------------|-------------------------------------------------------------------------------|| JourneyId            | Unique identifier for the transfer journey.                                  || SupplierRef          | Reference provided by the transfer supplier (specific to this journey leg). || Origin               | Starting point of the transfer.                                              || OriginAddress        | Address of the origin location.                                               || OriginIata           | IATA code of the origin location.                                             || Destination          | Destination point of the transfer.                                            || DestinationAddress   | Address of the destination location.                                          || DestinationIata      | IATA code of the destination location.                                        || JourneyTime          | Duration of the journey in minutes.                                           || FlightDetails        | Flight information associated with the transfer.                              || Pickup               | Pickup time for the transfer vehicle as an ISO 8601 timestamp in UTC (Zulu time). || InformationUrl       | URL with additional transfer information (when available from supplier).     || JoiningInstruction   | Instructions on where and how to join the transfer.                          || ContactNumbers       | Contact information including UkEmergencyTel, ReconfirmationTel, and EmergencyTel phone numbers. |### FlightDetails FieldsThe `FlightDetails` object contains flight information when the transfer is associated with a flight:| Field                                | Additional Information                                                        ||--------------------------------------|-------------------------------------------------------------------------------|| FlightDetails/Code                   | Flight number/code (e.g., \"U28605\").                                         || FlightDetails/Origin                 | Origin airport IATA code (e.g., \"LGW\").                                      || FlightDetails/Destination            | Destination airport IATA code (e.g., \"AGP\").                                 || FlightDetails/Departure              | Flight departure time as ISO 8601 timestamp in UTC (Zulu time).              || FlightDetails/Arrival                | Flight arrival time as ISO 8601 timestamp in UTC (Zulu time).                |**Important Notes:**- All timestamps use UTC timezone and are formatted as ISO 8601 with 'Z' suffix (e.g., \"2025-08-01T10:00:00Z\")- For airport pickup transfers, the `Arrival` time represents when passengers land and need pickup- For airport drop-off transfers, the `Departure` time represents the flight departure time, and the pickup time is automatically calculated to ensure passengers arrive at the airport with adequate time before their flight- The `FlightDetails` object and its individual fields can be null when flight information is not available or unknown### Example{% codetabs %}{% codetab XML %}```xml  TBBGNHMT  123456  Confirmed  2025-01-15T10:30:00Z    customer@example.com      103.52    GBP    private_car    TBHT1169922          24      100      0              1      4                  4      1      true      Transfer Company Ltd      Mercedes              OUT123456      ABC123      Málaga Airport      Málaga Airport, Málaga      AGP      Hotel Sol Marbella      Av. del Mar, 29600, Marbella            60              U28605        LGW        AGP                2025-08-01T10:00:00Z            2025-08-01T10:30:00Z      https://example.com/transfer-info      Meet at Terminal 3 Arrivals Hall              +44 20 7123 4567        +34 952 123 456        +34 952 999 888                    RET123456      DEF456      Hotel Sol Marbella      Av. del Mar, 29600, Marbella            Málaga Airport      Málaga Airport, Málaga      AGP      60              U28602        AGP        LGW        2025-08-07T13:30:00Z                    2025-08-07T10:00:00Z      https://example.com/transfer-info      Meet in hotel lobby 10 minutes before pickup              +44 20 7123 4567        +34 952 123 456        +34 952 999 888            ```{% endcodetab %}{% codetab JSON %}```json{  \"Booking\": {    \"BookingRef\": \"TBBGNHMT\",    \"SupplierRef\": 123456,    \"Status\": \"Confirmed\",    \"DateBooked\": \"2025-01-15T10:30:00Z\",    \"DateCancelled\": null,    \"Email\": \"customer@example.com\",    \"Product\": {      \"Price\": 103.52,      \"Currency\": \"GBP\",      \"Category\": \"private_car\",      \"TransferCode\": \"TBHT1169922\",      \"Cancellation\": {        \"Period\": 24,        \"Percentage\": 100,        \"Fee\": 0      },      \"VehicleDetails\": {        \"MinCapacity\": 1,        \"MaxCapacity\": 4,        \"MinStops\": \"\",        \"MaxStops\": \"\",        \"Bags\": 4,        \"NumberOfVehicles\": 1,        \"IsPrivate\": true,        \"Supplier\": \"Transfer Company Ltd\",        \"Make\": \"Mercedes\"      },      \"OutboundTransfer\": {        \"JourneyId\": \"OUT123456\",        \"SupplierRef\": \"ABC123\",        \"Origin\": \"Málaga Airport\",        \"OriginAddress\": \"Málaga Airport, Málaga\",        \"OriginIata\": \"AGP\",        \"Destination\": \"Hotel Sol Marbella\",        \"DestinationAddress\": \"Av. del Mar, 29600, Marbella\",        \"DestinationIata\": \"\",        \"JourneyTime\": 60,        \"FlightDetails\": {          \"Code\": \"U28605\",          \"Origin\": \"LGW\",          \"Destination\": \"AGP\",          \"Departure\": null,          \"Arrival\": \"2025-08-01T10:00:00Z\"        },        \"Pickup\": \"2025-08-01T10:30:00Z\",        \"InformationUrl\": \"https://example.com/transfer-info\",        \"JoiningInstruction\": \"Meet at Terminal 3 Arrivals Hall\",        \"ContactNumbers\": {          \"UkEmergencyTel\": \"+44 20 7123 4567\",          \"ReconfirmationTel\": \"+34 952 123 456\",          \"EmergencyTel\": \"+34 952 999 888\"        }      },      \"ReturnTransfer\": {        \"JourneyId\": \"RET123456\",        \"SupplierRef\": \"DEF456\",        \"Origin\": \"Hotel Sol Marbella\",        \"OriginAddress\": \"Av. del Mar, 29600, Marbella\",        \"OriginIata\": \"\",        \"Destination\": \"Málaga Airport\",        \"DestinationAddress\": \"Málaga Airport, Málaga\",        \"DestinationIata\": \"AGP\",        \"JourneyTime\": 60,        \"FlightDetails\": {          \"Code\": \"U28602\",          \"Origin\": \"AGP\",          \"Destination\": \"LGW\",          \"Departure\": \"2025-08-07T13:30:00Z\",          \"Arrival\": null        },        \"Pickup\": \"2025-08-07T10:00:00Z\",        \"InformationUrl\": \"https://example.com/transfer-info\",        \"JoiningInstruction\": \"Meet in hotel lobby 10 minutes before pickup\",        \"ContactNumbers\": {          \"UkEmergencyTel\": \"+44 20 7123 4567\",          \"ReconfirmationTel\": \"+34 952 123 456\",          \"EmergencyTel\": \"+34 952 999 888\"        }      }    }  }}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                  @@ -519,6 +512,13 @@
                                                                                                                                                                                                                                                                                                                                                                                         }
                                                                                                                                                                                                                                                                                                                                                                                         ,
                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                  +      "hxapi-viewamendcancel-view": {
                                                                                                                                                                                                                                                                                                                                                                                  +        "title": "View Booking",
                                                                                                                                                                                                                                                                                                                                                                                  +        "content": "# View Booking[API Docs](/hxapi/) > product:[view](/hxapi/viewamendcancel/view)## View Booking RequestThis method works for bookings made for any product type using our API.### MethodGET### EndpointThe endpoint to use is (where `YourBookingRef` is the Holiday Extras booking reference):{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}### Request ParametersNB: All parameter names are case sensitive.| Name       | Data Type | Format            | Mandatory? | Additional Information                                                                                                                                          ||------------|-----------|-------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String    | [A-Z0-9] 5 chars  | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                 || Password   | String    | [A-Z0-9] 5 chars  | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials   | String    | [A-Z] 3 chars     | N          | The initials of the Operator / Agent.                                                                                                                           || key        | String    | [A-Z]             | Y          | This will be assigned to you by your Account Manager during set up.                                                                                             || Email      | String    | [A-Z0-9] 50 chars | Y          | Email address used to make the booking (i.e. the email address of the lead passenger)                                                                           || System     | String    | [A-Z] 3 chars     | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                  |## View Booking ResponseThe view booking response will return all of the details against that booking record in our system.For a detailed explanation of the fields returned, please see below:| Field                                          | Additional Information                                                                                                                                                                                        ||------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                             | This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). || Booking/Amendable                              | This will return one of the following: `Y` = booking can be amended; `N` = booking cannot be amended; `C` = booking has been cancelled; `S` = booking is same day so cannot be amended or cancelled.          || Booking/CanxDate                               | If the booking has been cancelled, the date on which it was will return here.                                                                                                                                 || Booking/AgentComm                              | Commission you have earned from this booking.                                                                                                                                                                 || Booking/BookingDate                            | The date the booking was originally made on.                                                                                                                                                                  || Booking/PdfURL                                 | ⚠ Deprecated: This feature provided a link to generate a PDF version of the booking confirmation. It is no longer supported and will be removed in future releases.                                           || Itinerary                                      | This block will return details of the original booking, as per the booking response for each product type. Please see the respective booking guides for further details on the fields.                        || ClientDetails                                  | This block will return details of the lead passenger.                                                                                                                                                         || Pricing                                        | This block will return details of the price paid by the customer.                                                                                                                                             || VAT                                            | Please ignore this block.                                                                                                                                                                                     || CustRef                                        | If you have passed in a Customer Reference with your original booking request, it will return here.                                                                                                           || BarCode                                        | A link to generate a bar code for the booking confirmation.                                                                                                                                                   || QRCodeValue                                    | (EU only) Value of the QR code that comes with email confirmation. [More details about QR Code](/hxapi/barcode#qr_code)                                                                                       || QRCodeValueStr                                 | (EU only) Value of the QR code that comes with email confirmation. [More details about QR Code](/hxapi/barcode#qr_code)                                                                                       || SupplierRef                                    | (EU only) External booking id booking                                                                                                                                                                         || CurrentSupplements[]                           | Array of upgrades on the booking                                                                                                                                                                              || CurrentSupplements/Supplement/Code             | Upgrade product code                                                                                                                                                                                          || CurrentSupplements/Supplement/Price            | The price paid for the upgrade                                                                                                                                                                                || CurrentSupplements/Supplement/NonDiscPrice     | The price of the upgrade before any discounts                                                                                                                                                                 || CurrentSupplements/Supplement/DiscAmt          | The value of any discount applied                                                                                                                                                                             || CurrentSupplements/Supplement/Supplier         | Code for the supplier of the upgrade                                                                                                                                                                          || CurrentSupplements/Supplement/Rule             | Internal field                                                                                                                                                                                                || CurrentSupplements/Supplement/Req              | The purchased quantity of the upgrade                                                                                                                                                                         || CurrentSupplements/Supplement/Per              | The pricing basis of the upgrade                                                                                                                                                                              || CurrentSupplements/Supplement/Adults           | The number of adult passes purchased                                                                                                                                                                          || CurrentSupplements/Supplement/Children         | The number of chlid passes purchased                                                                                                                                                                          || CurrentSupplements/Supplement/Date             | The date of use for the upgrade                                                                                                                                                                               || CurrentSupplements/Supplement/Canx             | Whether the upgrade is cancellable                                                                                                                                                                            || CurrentSupplements/Supplement/Remarks          | Notes field. Used to store arrival time for lounge upgrades                                                                                                                                                   || AvailableSupplements[]                         | Array of upgrades available to purchase post booking                                                                                                                                                          || AvailableSupplements/Supplement/Code           | Upgrade product code                                                                                                                                                                                          || AvailableSupplements/Supplement/Supplier       | Code for the supplier of the upgrade                                                                                                                                                                          || AvailableSupplements/Supplement/Per            | The pricing basis of the upgrade                                                                                                                                                                              || AvailableSupplements/Supplement/Canx           | Whether the upgrade is cancellable                                                                                                                                                                            || AvailableSupplements/Supplement/Name           | The name of the upgrade product                                                                                                                                                                               || AvailableSupplements/Supplement/Price          | The price of the upgrade                                                                                                                                                                                      || AvailableSupplements/Supplement/NonDiscPrice   | The price of the upgrade before any discounts                                                                                                                                                                 || AvailableSupplements/Supplement/DiscAmt        | The value of any discount applied                                                                                                                                                                             || AvailableSupplements/Supplement/AdPrice        | The per adult price minus any discounts. Only present for per person upgrades                                                                                                                                 || AvailableSupplements/Supplement/NonDiscAdPrice | The per adult price before any discounts. Only present for per person upgrades                                                                                                                                || AvailableSupplements/Supplement/AdDiscAmt      | The amount of discount applied to the per adult price. Only present for per person upgrades                                                                                                                   || AvailableSupplements/Supplement/ChPrice        | The per child price minus any discounts. Only present for per person upgrades                                                                                                                                 || AvailableSupplements/Supplement/NonDiscChPrice | The per child price before any discounts. Only present for per person upgrades                                                                                                                                || AvailableSupplements/Supplement/ChDiscAmt      | The amount of discount applied to the child price. Only present for per person upgrades                                                                                                                       || AvailableSupplements/Supplement/PerNight       | Whether the upgrade is charged per night of a stay                                                                                                                                                            || API_Header/Request                             | A list of parameters that were sent in the view booking request.                                                                                                                                              || Booking/Status  (Future)                       | Indicates the current status of the booking (`Pending`, `Confirmed`, `Cancelled`, or `Error`).                                                                                                                |#### /Booking/AmendablePossible values*  Y - booking can be amended or cancelled*  N - booking cannot be amended or cancelled (advance purchase product etc)*  C - booking has been cancelled## Worked ExamplesBelow are worked examples of both the request and response for view a booking.### UK Products View Booking (for a car park)#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_view_uk_booking_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_view_uk_booking_response.json %}```{% endcodetab %}{% endcodetabs %}---### UK Products View Booking (for a transfer)#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_view_uk_transfers_booking_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_view_uk_transfers_booking_response.json %}```{% endcodetab %}{% endcodetabs %}---### European Products View Booking (for a hotel room only)#### Request```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com&System=ABG```#### Response```xml{% include_relative examples/_view_eu_booking_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                  +        "url": "/hxapi/viewamendcancel/view/"
                                                                                                                                                                                                                                                                                                                                                                                  +      }
                                                                                                                                                                                                                                                                                                                                                                                  +      ,
                                                                                                                                                                                                                                                                                                                                                                                  +    
                                                                                                                                                                                                                                                                                                                                                                                         "assets-main-css": {
                                                                                                                                                                                                                                                                                                                                                                                           "title": "",
                                                                                                                                                                                                                                                                                                                                                                                           "content": "@import \"minima\";",
                                                                                                                                                                                                                                                                                                                                                                                  
                                                                                                                                                                                                                                                                                                                                                                                  From 2ebd49e1326afaa7b5cab2032afec0625194aed4 Mon Sep 17 00:00:00 2001
                                                                                                                                                                                                                                                                                                                                                                                  From: "github-actions[bot]"
                                                                                                                                                                                                                                                                                                                                                                                   <41898282+github-actions[bot]@users.noreply.github.com>
                                                                                                                                                                                                                                                                                                                                                                                  Date: Thu, 3 Sep 2026 11:34:49 +0000
                                                                                                                                                                                                                                                                                                                                                                                  Subject: [PATCH 4/4] Update dist
                                                                                                                                                                                                                                                                                                                                                                                  
                                                                                                                                                                                                                                                                                                                                                                                  ---
                                                                                                                                                                                                                                                                                                                                                                                   docs/feed.xml                                 |   2 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/asynchronous-bookings/index.html   |   8 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/carhire/availability/index.html    |   4 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/parking/av/airport/index.html      |  20 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/productlibrary/index.html          |  28 +--
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/transfers/av/index.html            |  24 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/transfers/cancel/index.html        |   4 +-
                                                                                                                                                                                                                                                                                                                                                                                   .../transfers/cancellation-policy/index.html  |   8 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/transfers/view/index.html          |   4 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/upgrade/index.html                 |  16 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/hxapi/viewamendcancel/view/index.html    |  20 +-
                                                                                                                                                                                                                                                                                                                                                                                   docs/search/index.html                        | 210 +++++++++---------
                                                                                                                                                                                                                                                                                                                                                                                   12 files changed, 174 insertions(+), 174 deletions(-)
                                                                                                                                                                                                                                                                                                                                                                                  
                                                                                                                                                                                                                                                                                                                                                                                  diff --git a/docs/feed.xml b/docs/feed.xml
                                                                                                                                                                                                                                                                                                                                                                                  index 8cc53840..63771450 100644
                                                                                                                                                                                                                                                                                                                                                                                  --- a/docs/feed.xml
                                                                                                                                                                                                                                                                                                                                                                                  +++ b/docs/feed.xml
                                                                                                                                                                                                                                                                                                                                                                                  @@ -1,2 +1,2 @@
                                                                                                                                                                                                                                                                                                                                                                                  -Jekyll2026-09-03T10:50:55+00:00/feed.xmlHoliday Extras APIDocumentation to give to partners who would like to integrate with our API.
                                                                                                                                                                                                                                                                                                                                                                                  +Jekyll2026-09-03T11:34:46+00:00/feed.xmlHoliday Extras APIDocumentation to give to partners who would like to integrate with our API.
                                                                                                                                                                                                                                                                                                                                                                                   
                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file
                                                                                                                                                                                                                                                                                                                                                                                  diff --git a/docs/hxapi/asynchronous-bookings/index.html b/docs/hxapi/asynchronous-bookings/index.html
                                                                                                                                                                                                                                                                                                                                                                                  index dd066c59..44170015 100644
                                                                                                                                                                                                                                                                                                                                                                                  --- a/docs/hxapi/asynchronous-bookings/index.html
                                                                                                                                                                                                                                                                                                                                                                                  +++ b/docs/hxapi/asynchronous-bookings/index.html
                                                                                                                                                                                                                                                                                                                                                                                  @@ -77,7 +77,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                  Availability Request

                                                                                                                                                                                                                                                                                                                                                                                  UK Products Availability Request

                                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                    • XML
                                                                                                                                                                                                                                                                                                                                                                                    • @@ -85,7 +85,7 @@

                                                                                                                                                                                                                                                                                                                                                                                      UK Products Availability Request

                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                      • https://api.holidayextras.com/v1/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-01-07&ArrivalTime=1200&DepartDate=2025-01-08&DepartTime=1200&NumberOfPax=1&includeAsyncOnlyProducts=true
                                                                                                                                                                                                                                                                                                                                                                                        @@ -102,7 +102,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                        UK Products Availability Request

                                                                                                                                                                                                                                                                                                                                                                                        European Products Availability Request

                                                                                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                                                                                                                                                          • @@ -110,7 +110,7 @@

                                                                                                                                                                                                                                                                                                                                                                                            European Products Availability R

                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                            • https://api.holidayextras.com/v1/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-12-01&ArrivalTime=1200&DepartDate=2025-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en&includeAsyncOnlyProducts=true
                                                                                                                                                                                                                                                                                                                                                                                              diff --git a/docs/hxapi/carhire/availability/index.html b/docs/hxapi/carhire/availability/index.html
                                                                                                                                                                                                                                                                                                                                                                                              index 699892d5..9ce41b7b 100644
                                                                                                                                                                                                                                                                                                                                                                                              --- a/docs/hxapi/carhire/availability/index.html
                                                                                                                                                                                                                                                                                                                                                                                              +++ b/docs/hxapi/carhire/availability/index.html
                                                                                                                                                                                                                                                                                                                                                                                              @@ -53,7 +53,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                              Request

                                                                                                                                                                                                                                                                                                                                                                                              Example request:

                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                                                                                                                                                • @@ -61,7 +61,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                  Request

                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                  • https://api.holidayextras.com/v1/sandbox/carHire/products?key=1&From=06NOV16&ArrivalTime=1200&To=13NOV&DepartTime=1600&PickupLocation=FL965&DropoffLocation=FL965&DateOfBirth=1990-10-13
                                                                                                                                                                                                                                                                                                                                                                                                    diff --git a/docs/hxapi/parking/av/airport/index.html b/docs/hxapi/parking/av/airport/index.html
                                                                                                                                                                                                                                                                                                                                                                                                    index 02b66343..e1d55995 100644
                                                                                                                                                                                                                                                                                                                                                                                                    --- a/docs/hxapi/parking/av/airport/index.html
                                                                                                                                                                                                                                                                                                                                                                                                    +++ b/docs/hxapi/parking/av/airport/index.html
                                                                                                                                                                                                                                                                                                                                                                                                    @@ -49,7 +49,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                    Endpoint

                                                                                                                                                                                                                                                                                                                                                                                                    For example, for London Gatwick the endpoint is:

                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                      • XML
                                                                                                                                                                                                                                                                                                                                                                                                      • @@ -57,7 +57,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                        Endpoint

                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                        • https://api.holidayextras.com/v1/carpark/LGW
                                                                                                                                                                                                                                                                                                                                                                                                          @@ -444,7 +444,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                          Worked Examples

                                                                                                                                                                                                                                                                                                                                                                                                          UK Products Availability Request

                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                                            • XML
                                                                                                                                                                                                                                                                                                                                                                                                            • @@ -452,7 +452,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                              UK Products Availability Request

                                                                                                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                                                              • https://api.holidayextras.com/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1
                                                                                                                                                                                                                                                                                                                                                                                                                @@ -471,7 +471,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                UK Products Availability Response

                                                                                                                                                                                                                                                                                                                                                                                                                NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                                                                                                                                                                                                  • @@ -479,7 +479,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                    UK Products Availability Response

                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                      • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                        @@ -707,7 +707,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                        UK Products Availability Response

                                                                                                                                                                                                                                                                                                                                                                                                                        European Products Availability Request -
                                                                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                                                                                                                                                                                          • @@ -715,7 +715,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                            European Products Availability R

                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                                                            • https://api.holidayextras.com/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en
                                                                                                                                                                                                                                                                                                                                                                                                                              @@ -734,7 +734,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                              European Products Availability

                                                                                                                                                                                                                                                                                                                                                                                                                              NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                • @@ -742,7 +742,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                  European Products Availability

                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                  • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                    diff --git a/docs/hxapi/productlibrary/index.html b/docs/hxapi/productlibrary/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                    index a25087c3..733712fd 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                    --- a/docs/hxapi/productlibrary/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                    +++ b/docs/hxapi/productlibrary/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                    @@ -83,7 +83,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                    Available Fields

                                                                                                                                                                                                                                                                                                                                                                                                                                    The available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.

                                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                                      • Parking
                                                                                                                                                                                                                                                                                                                                                                                                                                      • @@ -97,7 +97,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                        Available Fields

                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                        • @@ -968,7 +968,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                          Example 1 - Default Response

                                                                                                                                                                                                                                                                                                                                                                                                                                          Request

                                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                                            + -
                                                                                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                                                                                              • https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey
                                                                                                                                                                                                                                                                                                                                                                                                                                                @@ -1008,7 +1008,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                  • @@ -1016,7 +1016,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                    Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                                                                                    • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                                      @@ -1403,7 +1403,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                      Example 2 - Restricted field list

                                                                                                                                                                                                                                                                                                                                                                                                                                                      Request

                                                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                                                + -
                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                  • https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude
                                                                                                                                                                                                                                                                                                                                                                                                                                    @@ -1443,7 +1443,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                    Request

                                                                                                                                                                                                                                                                                                                                                                                                                                    Response

                                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                                      • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                      • @@ -1451,7 +1451,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                        Response

                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                        • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -1512,7 +1512,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                          Request

                                                                                                                                                                                                                                                                                                                                                                                                                                          Requests for German products return a different set of fields. Explanation of fields not currently available.

                                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                                            + -
                                                                                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                                                                                              • https://api.holidayextras.com/v1/product/FRA0?key=mytestkey
                                                                                                                                                                                                                                                                                                                                                                                                                                                @@ -1552,7 +1552,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                  • @@ -1560,7 +1560,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                    Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                                                                                    • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                                      diff --git a/docs/hxapi/transfers/av/index.html b/docs/hxapi/transfers/av/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                      index c92d3643..4f6f6719 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                                      --- a/docs/hxapi/transfers/av/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                      +++ b/docs/hxapi/transfers/av/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                      @@ -856,7 +856,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                      Worked Examples

                                                                                                                                                                                                                                                                                                                                                                                                                                                      Airport to GIATA

                                                                                                                                                                                                                                                                                                                                                                                                                                                      Request
                                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                        • @@ -864,7 +864,7 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                          Request
                                                                                                                                                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                                                                                                          • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602
                                                                                                                                                                                                                                                                                                                                                                                                                                                            @@ -882,7 +882,7 @@ 
                                                                                                                                                                                                                                                                                                                                                                                                                                                            Request
                                                                                                                                                                                                                                                                                                                                                                                                                                                            Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                            NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                                                                                                              • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                              • @@ -890,7 +890,7 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                Response
                                                                                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 13:06:41">
                                                                                                                                                                                                                                                                                                                                                                                                                                                                  @@ -1128,7 +1128,7 @@ 
                                                                                                                                                                                                                                                                                                                                                                                                                                                                  Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                  Airport to TTI

                                                                                                                                                                                                                                                                                                                                                                                                                                                                  Request
                                                                                                                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • @@ -1136,7 +1136,7 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                      Request
                                                                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602
                                                                                                                                                                                                                                                                                                                                                                                                                                                                        @@ -1155,7 +1155,7 @@ 
                                                                                                                                                                                                                                                                                                                                                                                                                                                                        Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                        NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                          • @@ -1163,7 +1163,7 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                            Response
                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 13:06:41">
                                                                                                                                                                                                                                                                                                                                                                                                                                                                              @@ -1400,7 +1400,7 @@ 
                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Airport to Postal Address

                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Request
                                                                                                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                • @@ -1408,7 +1408,7 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  Request
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    @@ -1427,7 +1427,7 @@ 
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    NB: This is a shortened example compiled from a full availability response.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • @@ -1435,7 +1435,7 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        Response
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • <API_Reply Product="Transfers" RequestCode="1" Result="OK" cached="1" expires="2021-12-07 16:31:35">
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          diff --git a/docs/hxapi/transfers/cancel/index.html b/docs/hxapi/transfers/cancel/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          index 8e09e684..18626dc3 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          --- a/docs/hxapi/transfers/cancel/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +++ b/docs/hxapi/transfers/cancel/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -160,7 +160,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Cancel Booking Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • @@ -168,7 +168,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • <Booking>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                diff --git a/docs/hxapi/transfers/cancellation-policy/index.html b/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                index cff54ad6..7e2c7f70 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                --- a/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                +++ b/docs/hxapi/transfers/cancellation-policy/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                @@ -145,7 +145,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Cancellation Policy Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • @@ -153,7 +153,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • <BookingRef>TB12345</BookingRef>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      @@ -179,7 +179,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      Example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      Example - Non-Cancellable Booking

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • @@ -187,7 +187,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Example - Non-Cancellable Booking

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • <BookingRef>TB12345</BookingRef>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              diff --git a/docs/hxapi/transfers/view/index.html b/docs/hxapi/transfers/view/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              index 3a4a1c37..8ce7b809 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              --- a/docs/hxapi/transfers/view/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              +++ b/docs/hxapi/transfers/view/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              @@ -295,7 +295,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              FlightDetails Fields

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                • @@ -303,7 +303,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  Example

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • <Booking>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    diff --git a/docs/hxapi/upgrade/index.html b/docs/hxapi/upgrade/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    index c4c0cc48..7dc2757d 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    --- a/docs/hxapi/upgrade/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    +++ b/docs/hxapi/upgrade/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    @@ -239,7 +239,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Example 1 - Carpark Upgrades

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • @@ -247,7 +247,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -265,7 +265,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • @@ -273,7 +273,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                @@ -610,7 +610,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Example 1 - Hotel Upgrades

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • @@ -618,7 +618,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      @@ -634,7 +634,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • @@ -642,7 +642,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            diff --git a/docs/hxapi/viewamendcancel/view/index.html b/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            index 3fa86f2a..d84d9d3a 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            --- a/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            +++ b/docs/hxapi/viewamendcancel/view/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            @@ -46,7 +46,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            Endpoint

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            The endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              • @@ -54,7 +54,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Endpoint

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                • https://api.holidayextras.com/v1/booking/YourBookingRef
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  @@ -358,7 +358,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  UK Products View Booking (for a

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    • @@ -366,7 +366,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        @@ -383,7 +383,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          • @@ -391,7 +391,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              @@ -917,7 +917,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              UK Products View Booking (for a transfer)

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                • @@ -925,7 +925,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  • https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    @@ -942,7 +942,7 @@ 

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Request

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • XML
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      • @@ -950,7 +950,7 @@

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        Response

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      -
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        +
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        • <?xml version="1.0"?>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          diff --git a/docs/search/index.html b/docs/search/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          index 6698b9f6..66efd16e 100644
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          --- a/docs/search/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +++ b/docs/search/index.html
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -43,6 +43,13 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-lounge-av-airport": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Availability At Lounge",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "Availability At LoungeLounge Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/AirportCodeFor example, for lounge availability at Gatwick the endpoint is:https://api.holidayextras.com/v1/lounge/LGWTo find the airport locations available for lounges, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer enters the lounge.              ArrivalTime      Time      HHMM      Y      Time customer enters the lounge.              Adults      Integer      [0-4] 1 char      Y      Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Children      Integer      [0-3] 1 char      N      Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Infants      Integer      1 char      N      Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              OutFlight      String      [A-Z0-9] 9 chars      N      This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal.              Terminal      String      [A-Z1-9] 1 char      N      An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ).              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      Required for requests for European products. (Values available are en, de, it, es, pt and nl.)              fields      String      [A-Z] a csv list of product info fields      N      A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint.      Lounge Availability ResponseThe lounge availability response will return the specific product requested, so long as it has availability on the specific dates and times. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Lounge/Name      The name of the lounge.              Lounge/Code      The product code for the lounge, which must be used in the booking request.              Lounge/BookingURL      The URL to POST the booking request to for this particular product.              Lounge/MoreInfoURL      The link to more information about this product, sourced from the Product Library.              Lounge/NonDiscPrice      The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.              Lounge/Price      The price of product without any surcharges/fees added.              Lounge/terminal      The terminal the lounge is in              API_Header/Request      The API returns every parameter and value you sent in the previous request.      Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Requesthttps://api.holidayextras.com/v1/lounge/LHR?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0UK Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:24:54\">    <Lounge>        <Name>Plaza Premium T5 lounge - 3 hours</Name>        <Code>LHRPA5</Code>        <BookingURL>/v1/lounge/HPLHRPA5</BookingURL>        <MoreInfoURL>/v1/product/LHRPA5</MoreInfoURL>        <NonDiscPrice>80.00</NonDiscPrice>        <Price>80.00</Price>        <terminal>5</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>No1 Lounge, Terminal 3, Heathrow</Name>        <Code>LHRNN3</Code>        <BookingURL>/v1/lounge/HPLHRNN3</BookingURL>        <MoreInfoURL>/v1/product/LHRNN3</MoreInfoURL>        <NonDiscPrice>64.00</NonDiscPrice>        <Price>64.00</Price>        <terminal>3</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>SkyTeam Lounge T4</Name>        <Code>LHRSTE</Code>        <BookingURL>/v1/lounge/HPLHRSTE</BookingURL>        <MoreInfoURL>/v1/product/LHRSTE</MoreInfoURL>        <NonDiscPrice>60.00</NonDiscPrice>        <Price>60.00</Price>        <terminal>4</terminal>        <option_count>14</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>2.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>4.00</CCardSurchargeMax>        <DCardSurchargePercent>0.00</DCardSurchargePercent>        <DCardSurchargeMin>0.00</DCardSurchargeMin>        <DCardSurchargeMax>0.00</DCardSurchargeMax>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <v>1</v>        </Request>    </API_Header></API_Reply>European Products Availability Requesthttps://api.holidayextras.com/v1/lounge/HAM?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0&System=ABG&lang=deEuropean Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:30:25\">    <Lounge>        <Name>Hamburg Airport Lounge</Name>        <Code>HAMLHL</Code>        <BookingURL>/v1/lounge/FRHAMLHL</BookingURL>        <MoreInfoURL>/v1/product/HAMLHL</MoreInfoURL>        <NonDiscPrice>74.00</NonDiscPrice>        <Price>74.00</Price>        <terminal>Z</terminal>        <option_count>1</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>0.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>0.00</CCardSurchargeMax>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <System>ABG</System>            <lang>de</lang>            <v>1</v>        </Request>    </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/lounge/av/airport/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "hxapi-parking-av-airport": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Availability At Airport",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "Availability At AirportAPI Docs > product:Parking > endpoint:carpark > request:Availability by AirportAirport Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/AirportCodeFor example, for London Gatwick the endpoint is:\tXML\tJSON\thttps://api.holidayextras.com/v1/carpark/LGW\thttps://api.holidayextras.com/v1/carpark/LGW.jsNote the .js extension.To find the airport locations available for car parking, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              NumberOfPax      Integer      [0-9] 2 chars      N      Number of passengers.              OutFlight      String      [A-Z0-9] 9 chars      N      This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal.              Terminal      String      [A-Z1-9] 1 char      N      An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ).              filter      String      [A-Z]      N      Pass in values filter=on_airport, filter=recommended or filter=meet_and_greet to only show car parks meeting those criteria. You can filter by any field that comes back in the filter section of the API. Only a single filter can be used at once.              fields      String      [A-Z] a csv list of product info fields      N      A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint.              top3      Boolean      [0,1]      N      ⚠ Deprecated: This feature limited the search results to only 3 products, one onsite, one park and ride and one meet and greet. It is no longer supported and will be removed in future releases. Your account manager will work with you to ensure the best products are always returned first instead.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      Required for requests for European products. (Values available are en, de, it, es, pt and nl.)      Airport Availability ResponseThe airport availability response will return all the products that have availability at the requested location on specific dates and durations. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  CarPark/Name      The name of the product              CarPark/Code      The product code              CarPark/BookingURL      The URL to POST the booking request to for this particular product. Note: The product code includes prefix.              CarPark/MoreInfoURL      The link to more information about this product, sourced from the Product Library. Note: The product code doesn’t include prefix.              CarPark/RequestFlags      _NB. In Europe this will be replaced with <CarDetFlags>, see below for more info on these.These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request.Flags are only returned when required. The flags which can be returned are: Registration, CarMake, CarModel, CarColour, OutFlight, ReturnFlight, OutTerminal, ReturnTerminal, Destination, MobileNum.              CarPark/NonDiscPrice      The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.              CarPark/TotalPrice      The price of product without any surcharges/fees added.              CarPark/GatePrice      If available, the price of product if you were to turn up on the day.              CarPark/CanAmendCantCancel      Whether the product can be amend but not cancelled.              CarPark/CancellationFeeExceptions      If the carpark has non-standard cancellation fees.              CarPark/AmendmentFeeExceptions      If the carpark has non-standard amendment fees.              CarPark/Filter      We have a filter mechanism on our site, to show particular types of product, such as Meet and Greet. The filters that apply to a product are returned here. Possible values are: meet_and_greet, recommended, terminal, on_airport, valet_included, car_parked_for_you, park_and_stroll and park_and_ride.              Pricing/CreditCardSurcharge      NB: This is only relevant for Intermediary Agents in Europe, where Holiday Extras is responsible for processing the payment, not the Agent. The first step in the calculation is to determine the credit card surcharge payable (x), based on the value of the booking, using this formula: x = (TotalPrice + the CanxWaiver) / 100 x CCardSurchargePercent Second, to prevent the surcharge from exceeding certain boundaries we have min and max thresholds, which can be calculated as follows: if x < CCardSurchargeMin; x = CCardSurchargeMin else if x > CCardSurchargeMax; x = CCardSurchargeMax              Pricing/CancellationWaiver/Waiver      We provide an optional cancellation waiver. If this is not added then cancellation will incur a fee. This returns the cancellation fee cost.              API_Header/Request      The API returns every parameter and value you sent in the previous request.      CarDetFlags (Europe Only)For European products only, the availability response will return a field called <CarDetFlags>, which identifies the fields required when making a booking. (This is instead of the <RequestFlags> field which is returned for UK products only).For example: <CarDetFlags> NNNNNNNNNNNNNNNNNN </CarDetFlags>The order of the flags is always the same, and refers to these parameters respectively:            Position      Parameter      Data Type      Format      Additional Information                  1      Registration      String      See Expanded Formats      Vehicle registration number  NB: This field is not validated through the API.              2      CarMake      String      [A-Z0-9] 25 chars      Make of vehicle, e.g. Audi.              3      CarModel      String      [A-Z0-9] 25 chars      Model of vehicle, e.g. A6.              4      CarColour      String      [A-Z0-9] 25 chars      Colour of vehicle, e.g. White.              5      NumberOfPax      Integer      [0-9]      Number of passengers in the vehicle.              6      CarDropoffTime      Time      HHMM      Arrival time when you drop the vehicle off at the car park e.g 1000.              7      CarPickupTime      Time      HHMM      Return time, when you pick the vehicle up from the car park, e.g. 1600.              8      OutTerminal      String      [A-Z0-9] 2 chars      Single letter or number representation of the terminal e.g N or S or 4              9      OutFltNo      String      [A-Z0-9] 10 chars      Outbound flight number e.g. EZY123.              10      InFltNo      String      [A-Z0-9] 10 chars      Return flight number e.g. EZY124.              11      OutFltTime      Time      HHMM      Departure time of the outbound flight e.g. 1200.              12      InFltTime      Time      HHMM      Arrival time of the inbound flight e.g. 1500.              13      MobileNum      String      [A-Z0-9] 15 chars      Customer’s mobile number.              14      ShipName      String      [A-Z0-9] 20 chars      Name of the ship, e.g. AIDA              15      PierName      String      [A-Z0-9] 20 chars      Name of the pier or port where the ship is departing from              16      ChildSeat      String      Y/N      Is a child car seat needed?              17      AddlServices      String      [A-Z0-9] 50 chars      In this parameter you may add additional remarks regarding the booking.              18      RetTerminal      String      [A-Z0-9] 2 chars      Single letter or number representation of the terminal e.g N or S or 4      NB: Where length restrictions have been noted in the above formats, any additional characters present in a field will be ignored.Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Request\tXML\tJSON\thttps://api.holidayextras.com/carpark/LGW?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1\thttps://api.holidayextras.com/carpark/LGW.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-01-07&ArrivalTime=1200&DepartDate=2020-01-08&DepartTime=1200&NumberOfPax=1Note the .js extension.UK Products Availability ResponseNB: This is a shortened example compiled from a full availability response.\tXML\tJSON\t<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2019-12-06 17:31:56\">  <CarPark>    <Name>Purple Parking - all terminals</Name>    <Code>LGV9</Code>    <BookingURL>/carpark/HPLGV9</BookingURL>    <MoreInfoURL>/product/LGV9</MoreInfoURL>    <RequestFlags>      <CarColour>1</CarColour>      <CarMake>1</CarMake>      <CarModel>1</CarModel>      <Registration>1</Registration>      <ReturnFlight>1</ReturnFlight>    </RequestFlags>    <NonDiscPrice>20.99</NonDiscPrice>    <TotalPrice>19.94</TotalPrice>    <GatePrice>0.00</GatePrice>    <CanAmendCantCancel>0</CanAmendCantCancel>    <Filter>      <meet_and_greet>0</meet_and_greet>      <park_and_ride>1</park_and_ride>      <car_parked_for_you>1</car_parked_for_you>    </Filter>    <advance_purchase>1</advance_purchase>  </CarPark>  <CarPark>    <Name>Purple Parking Flexible - all terminals</Name>    <Code>LGV4</Code>    <BookingURL>/carpark/HPLGV4</BookingURL>    <MoreInfoURL>/product/LGV4</MoreInfoURL>    <RequestFlags>      <CarColour>1</CarColour>      <CarMake>1</CarMake>      <CarModel>1</CarModel>      <Registration>1</Registration>      <ReturnFlight>1</ReturnFlight>    </RequestFlags>    <NonDiscPrice>23.99</NonDiscPrice>    <TotalPrice>22.79</TotalPrice>    <GatePrice>0.00</GatePrice>    <CanAmendCantCancel>0</CanAmendCantCancel>    <Filter>      <meet_and_greet>0</meet_and_greet>      <park_and_ride>1</park_and_ride>      <car_parked_for_you>1</car_parked_for_you>    </Filter>  </CarPark>  <CarPark>    <Name>Purple Parking Winter Special</Name>    <Code>LGB3</Code>    <BookingURL>/carpark/HPLGB3</BookingURL>    <MoreInfoURL>/product/LGB3</MoreInfoURL>    <RequestFlags>      <CarColour>1</CarColour>      <CarMake>1</CarMake>      <CarModel>1</CarModel>      <Registration>1</Registration>      <ReturnFlight>1</ReturnFlight>    </RequestFlags>    <NonDiscPrice>21.59</NonDiscPrice>    <TotalPrice>20.94</TotalPrice>    <GatePrice>0.00</GatePrice>    <CanAmendCantCancel>0</CanAmendCantCancel>    <Filter>      <meet_and_greet>0</meet_and_greet>      <park_and_ride>1</park_and_ride>      <car_parked_for_you>1</car_parked_for_you>    </Filter>  </CarPark>  <Pricing>    <CCardSurchargePercent>0.00</CCardSurchargePercent>    <CCardSurchargeMin>0.00</CCardSurchargeMin>    <CCardSurchargeMax>0.00</CCardSurchargeMax>    <DCardSurchargePercent>0.00</DCardSurchargePercent>    <DCardSurchargeMin>0.00</DCardSurchargeMin>    <DCardSurchargeMax>0.00</DCardSurchargeMax>    <CancellationWaiver>      <Waiver>1.69</Waiver>    </CancellationWaiver>  </Pricing>  <SepaID/>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-01-07</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2020-01-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>    </Request>  </API_Header></API_Reply>\t{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"CarPark\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2019-12-06 17:33:10\"    },    \"CarPark\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Purple Parking - all terminals\",        \"Code\": \"LGV9\",        \"BookingURL\": \"/carpark/HPLGV9.js\",        \"MoreInfoURL\": \"/product/LGV9.js\",        \"_latitude\": 51.142779,        \"_longitude\": -0.211795,        \"RequestFlags\": {          \"CarColour\": 1,          \"CarMake\": 1,          \"CarModel\": 1,          \"Registration\": 1,          \"ReturnFlight\": 1        },        \"NonDiscPrice\": 20.99,        \"TotalPrice\": 19.94,        \"GatePrice\": \"0.00\",        \"CanAmendCantCancel\": \"\",        \"Filter\": {          \"meet_and_greet\": \"0\",          \"park_and_ride\": 1,          \"car_parked_for_you\": 1        },        \"advance_purchase\": true      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Purple Parking Flexible - all terminals\",        \"Code\": \"LGV4\",        \"BookingURL\": \"/carpark/HPLGV4.js\",        \"MoreInfoURL\": \"/product/LGV4.js\",        \"_latitude\": 51.142957,        \"_longitude\": -0.211055,        \"RequestFlags\": {          \"CarColour\": 1,          \"CarMake\": 1,          \"CarModel\": 1,          \"Registration\": 1,          \"ReturnFlight\": 1        },        \"NonDiscPrice\": 23.99,        \"TotalPrice\": 22.79,        \"GatePrice\": \"0.00\",        \"CanAmendCantCancel\": \"\",        \"Filter\": {          \"meet_and_greet\": \"0\",          \"park_and_ride\": 1,          \"car_parked_for_you\": 1        }      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Purple Parking Winter Special\",        \"Code\": \"LGB3\",        \"BookingURL\": \"/carpark/HPLGB3.js\",        \"MoreInfoURL\": \"/product/LGB3.js\",        \"_latitude\": 51.142557,        \"_longitude\": -0.210561,        \"RequestFlags\": {          \"CarColour\": 1,          \"CarMake\": 1,          \"CarModel\": 1,          \"Registration\": 1,          \"ReturnFlight\": 1        },        \"NonDiscPrice\": 21.59,        \"TotalPrice\": 20.94,        \"GatePrice\": \"0.00\",        \"CanAmendCantCancel\": \"\",        \"Filter\": {          \"meet_and_greet\": \"0\",          \"park_and_ride\": 1,          \"car_parked_for_you\": 1        }      }    ],    \"Pricing\": {      \"CCardSurchargePercent\": \"0.00\",      \"CCardSurchargeMin\": \"0.00\",      \"CCardSurchargeMax\": \"0.00\",      \"DCardSurchargePercent\": \"0.00\",      \"DCardSurchargeMin\": \"0.00\",      \"DCardSurchargeMax\": \"0.00\",      \"CancellationWaiver\": [        {          \"Waiver\": 1.69        }      ]    },    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"ArrivalDate\": \"2020-01-07\",        \"ArrivalTime\": 1200,        \"DepartDate\": \"2020-01-08\",        \"DepartTime\": 1200,        \"NumberOfPax\": 1,        \"format\": \"js\"      }    }  }}European Products Availability Request\tXML\tJSON\thttps://api.holidayextras.com/carpark/MUC?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=en\thttps://api.holidayextras.com/carpark/MUC.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&ArrivalTime=1200&DepartDate=2017-12-08&DepartTime=1200&NumberOfPax=1&System=ABG&lang=enNote the .js extension.European Products Availability ResponseNB: This is a shortened example compiled from a full availability response.\tXML\tJSON\t<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2019-12-06 18:07:40\">  <CarPark>    <Name>Airparks Parkplatz München Frühbucher</Name>    <Code>MUCC</Code>    <BookingURL>/carpark/FRMUCC</BookingURL>    <MoreInfoURL>/product/MUCC</MoreInfoURL>    <RequestFlags/>    <NonDiscPrice>46.00</NonDiscPrice>    <TotalPrice>46.00</TotalPrice>    <GatePrice>0.00</GatePrice>    <CancellationRule>0</CancellationRule>    <CarDetFlags>NNNNNNNNNNNNNNNNNN</CarDetFlags>    <CarDetails>Y</CarDetails>    <DiscDates/>    <Filter>      <car_parked_for_you>1</car_parked_for_you>      <meet_and_greet>0</meet_and_greet>      <park_and_stroll/>      <on_airport/>      <recommended/>      <special_offer_text>1</special_offer_text>      <valet_included>0</valet_included>      <park_and_ride>1</park_and_ride>    </Filter>  </CarPark>  <CarPark>    <Name>Parkservice Sky München</Name>    <Code>MU01</Code>    <BookingURL>/carpark/FRMU01</BookingURL>    <MoreInfoURL>/product/MU01</MoreInfoURL>    <RequestFlags/>    <NonDiscPrice>28.00</NonDiscPrice>    <TotalPrice>28.00</TotalPrice>    <GatePrice>0.00</GatePrice>    <CancellationRule>0</CancellationRule>    <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags>    <CarDetails>Y</CarDetails>    <DiscDates/>    <Filter>      <car_parked_for_you>0</car_parked_for_you>      <meet_and_greet>0</meet_and_greet>      <park_and_stroll/>      <on_airport/>      <recommended/>      <special_offer_text>0</special_offer_text>      <valet_included>0</valet_included>      <park_and_ride>1</park_and_ride>    </Filter>  </CarPark>  <CarPark>    <Name>Parkservice Sky München Winteraktion</Name>    <Code>MU03</Code>    <BookingURL>/carpark/FRMU03</BookingURL>    <MoreInfoURL>/product/MU03</MoreInfoURL>    <RequestFlags/>    <NonDiscPrice>39.99</NonDiscPrice>    <TotalPrice>39.99</TotalPrice>    <GatePrice>0.00</GatePrice>    <CancellationRule>0</CancellationRule>    <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags>    <CarDetails>Y</CarDetails>    <DiscDates/>    <Filter>      <car_parked_for_you>0</car_parked_for_you>      <meet_and_greet>0</meet_and_greet>      <park_and_stroll/>      <on_airport/>      <recommended/>      <special_offer_text>1</special_offer_text>      <valet_included>0</valet_included>      <park_and_ride>1</park_and_ride>    </Filter>  </CarPark>  <Pricing>    <CCardSurchargePercent>0.00</CCardSurchargePercent>    <CCardSurchargeMin>0.00</CCardSurchargeMin>    <CCardSurchargeMax>0.00</CCardSurchargeMax>  </Pricing>  <SepaID>DE11ZZZ00000633860</SepaID>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-01-07</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2020-01-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <System>ABG</System>      <lang>en</lang>    </Request>  </API_Header></API_Reply>\t{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"CarPark\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2019-12-06 18:26:33\"    },    \"CarPark\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Airparks Parkplatz München Frühbucher\",        \"Code\": \"MUCC\",        \"BookingURL\": \"/carpark/FRMUCC.js\",        \"MoreInfoURL\": \"/product/MUCC.js\",        \"_latitude\": 48.35101,        \"_longitude\": 11.8348,        \"RequestFlags\": {},        \"NonDiscPrice\": 46,        \"TotalPrice\": 46,        \"GatePrice\": \"0.00\",        \"CancellationRule\": \"0\",        \"CarDetFlags\": \"NNNNNNNNNNNNNNNNNN\",        \"CarDetails\": \"Y\",        \"DiscDates\": \"\",        \"Filter\": {          \"car_parked_for_you\": 1,          \"meet_and_greet\": \"0\",          \"park_and_stroll\": \"\",          \"on_airport\": null,          \"recommended\": null,          \"special_offer_text\": 1,          \"valet_included\": \"0\",          \"park_and_ride\": 1        }      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Parkservice Sky München\",        \"Code\": \"MU01\",        \"BookingURL\": \"/carpark/FRMU01.js\",        \"MoreInfoURL\": \"/product/MU01.js\",        \"_latitude\": 48.384242,        \"_longitude\": 11.778148,        \"RequestFlags\": {},        \"NonDiscPrice\": 28,        \"TotalPrice\": 28,        \"GatePrice\": \"0.00\",        \"CancellationRule\": \"0\",        \"CarDetFlags\": \"NNNNNNNNYYNYNNNNNN\",        \"CarDetails\": \"Y\",        \"DiscDates\": \"\",        \"Filter\": {          \"car_parked_for_you\": \"0\",          \"meet_and_greet\": \"0\",          \"park_and_stroll\": \"\",          \"on_airport\": null,          \"recommended\": null,          \"special_offer_text\": \"0\",          \"valet_included\": \"0\",          \"park_and_ride\": 1        }      },      {        \"ATTRIBUTES\": [],        \"Name\": \"Parkservice Sky München Winteraktion\",        \"Code\": \"MU03\",        \"BookingURL\": \"/carpark/FRMU03.js\",        \"MoreInfoURL\": \"/product/MU03.js\",        \"_latitude\": 48.384242,        \"_longitude\": 11.778148,        \"RequestFlags\": {},        \"NonDiscPrice\": 39.99,        \"TotalPrice\": 39.99,        \"GatePrice\": \"0.00\",        \"CancellationRule\": \"0\",        \"CarDetFlags\": \"NNNNNNNNYYNYNNNNNN\",        \"CarDetails\": \"Y\",        \"DiscDates\": \"\",        \"Filter\": {          \"car_parked_for_you\": \"0\",          \"meet_and_greet\": \"0\",          \"park_and_stroll\": \"\",          \"on_airport\": null,          \"recommended\": null,          \"special_offer_text\": 1,          \"valet_included\": \"0\",          \"park_and_ride\": 1        }      }    ],    \"Pricing\": {      \"CCardSurchargePercent\": \"0.00\",      \"CCardSurchargeMin\": \"0.00\",      \"CCardSurchargeMax\": \"0.00\"    },    \"SepaID\": \"DE11ZZZ00000633860\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"ArrivalDate\": \"2020-01-07\",        \"ArrivalTime\": 1200,        \"DepartDate\": \"2020-01-08\",        \"DepartTime\": 1200,        \"NumberOfPax\": 1,        \"System\": \"ABG\",        \"lang\": \"en\",        \"format\": \"js\"      }    }  }}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -57,13 +64,6 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-lounge-av-airport": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Availability At Lounge",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "Availability At LoungeLounge Availability RequestMethodGETEndpointThe endpoint to use is:https://api.holidayextras.com/v1/lounge/AirportCodeFor example, for lounge availability at Gatwick the endpoint is:https://api.holidayextras.com/v1/lounge/LGWTo find the airport locations available for lounges, please refer to the locations endpoint.Request ParametersNB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer enters the lounge.              ArrivalTime      Time      HHMM      Y      Time customer enters the lounge.              Adults      Integer      [0-4] 1 char      Y      Number of adults requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Children      Integer      [0-3] 1 char      N      Number of children requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              Infants      Integer      1 char      N      Number of infants requiring entry to the lounge. Please note: a maximum of 6 passengers is permitted on any one booking.              OutFlight      String      [A-Z0-9] 9 chars      N      This is also known as an ‘flight number’. Used to establish which terminal the customer is flying from using our look up tool and return products specific to that terminal.              Terminal      String      [A-Z1-9] 1 char      N      An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the Terminal request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ).              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      Required for requests for European products. (Values available are en, de, it, es, pt and nl.)              fields      String      [A-Z] a csv list of product info fields      N      A list of product info fields can be passed in to return configurable product information e.g. fields=name,address,latitude,sellingpoint.      Lounge Availability ResponseThe lounge availability response will return the specific product requested, so long as it has availability on the specific dates and times. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Lounge/Name      The name of the lounge.              Lounge/Code      The product code for the lounge, which must be used in the booking request.              Lounge/BookingURL      The URL to POST the booking request to for this particular product.              Lounge/MoreInfoURL      The link to more information about this product, sourced from the Product Library.              Lounge/NonDiscPrice      The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.              Lounge/Price      The price of product without any surcharges/fees added.              Lounge/terminal      The terminal the lounge is in              API_Header/Request      The API returns every parameter and value you sent in the previous request.      Worked ExamplesBelow are worked examples of both the request and response for availability at an airport.UK Products Availability Requesthttps://api.holidayextras.com/v1/lounge/LHR?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0UK Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:24:54\">    <Lounge>        <Name>Plaza Premium T5 lounge - 3 hours</Name>        <Code>LHRPA5</Code>        <BookingURL>/v1/lounge/HPLHRPA5</BookingURL>        <MoreInfoURL>/v1/product/LHRPA5</MoreInfoURL>        <NonDiscPrice>80.00</NonDiscPrice>        <Price>80.00</Price>        <terminal>5</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>No1 Lounge, Terminal 3, Heathrow</Name>        <Code>LHRNN3</Code>        <BookingURL>/v1/lounge/HPLHRNN3</BookingURL>        <MoreInfoURL>/v1/product/LHRNN3</MoreInfoURL>        <NonDiscPrice>64.00</NonDiscPrice>        <Price>64.00</Price>        <terminal>3</terminal>        <Filter>            <landside>0</landside>        </Filter>        <option_count>14</option_count>    </Lounge>    <Lounge>        <Name>SkyTeam Lounge T4</Name>        <Code>LHRSTE</Code>        <BookingURL>/v1/lounge/HPLHRSTE</BookingURL>        <MoreInfoURL>/v1/product/LHRSTE</MoreInfoURL>        <NonDiscPrice>60.00</NonDiscPrice>        <Price>60.00</Price>        <terminal>4</terminal>        <option_count>14</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>2.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>4.00</CCardSurchargeMax>        <DCardSurchargePercent>0.00</DCardSurchargePercent>        <DCardSurchargeMin>0.00</DCardSurchargeMin>        <DCardSurchargeMax>0.00</DCardSurchargeMax>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <CancellationWaiver>            <Waiver>1.99</Waiver>        </CancellationWaiver>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <v>1</v>        </Request>    </API_Header></API_Reply>European Products Availability Requesthttps://api.holidayextras.com/v1/lounge/HAM?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2018-12-01&ArrivalTime=1200&Adults=2&Children=0&System=ABG&lang=deEuropean Products Availability Response<?xml version=\"1.0\"?><API_Reply Product=\"Lounge\" RequestCode=\"1\" Result=\"OK\" cached=\"1\" expires=\"2018-01-11 12:30:25\">    <Lounge>        <Name>Hamburg Airport Lounge</Name>        <Code>HAMLHL</Code>        <BookingURL>/v1/lounge/FRHAMLHL</BookingURL>        <MoreInfoURL>/v1/product/HAMLHL</MoreInfoURL>        <NonDiscPrice>74.00</NonDiscPrice>        <Price>74.00</Price>        <terminal>Z</terminal>        <option_count>1</option_count>    </Lounge>    <Pricing>        <CCardSurchargePercent>0.00</CCardSurchargePercent>        <CCardSurchargeMin>0.00</CCardSurchargeMin>        <CCardSurchargeMax>0.00</CCardSurchargeMax>        <Rates>            <GBP>1</GBP>            <EUR>1.1045</EUR>            <USD>1.319</USD>        </Rates>    </Pricing>    <SepaID/>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <Initials>YourInitials</Initials>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2018-12-01</ArrivalDate>            <ArrivalTime>1200</ArrivalTime>            <Adults>2</Adults>            <Children>0</Children>            <System>ABG</System>            <lang>de</lang>            <v>1</v>        </Request>    </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/lounge/av/airport/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "hxapi-viewamendcancel-amend-complex": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Amend Booking - complex (with reprice)",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "Amend Booking - complex (with reprice)API Docs > product:amendThe booking details that can be changed for a complex amend are as follows:  Arrival date or time;  Depart date or time.Amend Booking RequestWe recommend using the view booking method first, to ensure that you have all the details required from the most up to date record of the booking.You can then run a GET booking request using the amend endpoint and methodology detailed here to check the new amount (increase / decrease in price from original booking).The recommended process for amending a booking is as follows.  Call the view booking method to ensure that you have all the details required from the most up to date record of the booking.  Compose the amendment request as per the details below i.e. include the date change details. Then send this request as a GET rather than a POST. This will return the details of the pricing change.  If the client is happy with the pricing change then resend the request as a POST this will confirm and commit the changes.MethodPOSTEndpointThe endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):https://api.holidayextras.com/v1/booking/YourBookingRefRequest ParametersNB: All parameter names are case sensitive.For all amend booking requests, you will need to send these parameters:            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              Email      String      [A-Z0-9] 50 chars      Y      Email address used to make the booking (i.e. the email address of the lead passenger)              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).      In order to amend the booking with the new details, you only need to pass in the specific parameters you want to amend. For a complex amend these are as follows:            Name      Data Type      Format      Mandatory?      Additional Information                  ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              Supplements[]      -      -      N      Amend supplement details by sending the parameters to amend. See below for more details      Upgrade AmendmentsAs with booking upgrades it is possible to supply an array of Supplements to the amendment request to change the details of booked upgrades.To make amendments you need to specify the code of the upgrade to be changed and the fields you wish to change. The available fields are as below.            Name      Data Type      Format      Mandatory?      Additional Information                  Adults      Integer      [0-9]      N      When specified the Children parameter must also be specified otherwise it will be assumed to be 0              Children      Integer      [0-9]      N      When specified the Adults parameter must also be specified otherwise it will be assumed to be 0              Quantity      Integer      [0-9]      N      Change the required quantity of per booking or per room upgrades              Remove      -      -      N      The presence of this field will cause the upgrade to be removed from the booking      To add new upgrades you just need to include the upgrade details in the same fashion as when booking an upgrade.Get Amendment Price ResponseThis response will be given when a GET version of this request is sent. This should be used to retrieve the new price before committing to amendments.            Name      Additional Information                  Pricing/OriginalPrice      The price paid for the booking before any amendments              Pricing/NewPrice      The price to be paid if the amendments are confirmed              Pricing/CanxWaiver      The cost of any cancellation waiver that may be on the booking              Pricing/Duration      The new duration of the stay              Pricing/MinPricingDuration      The smallest duration of stay that the price can be increased by. For example if only increasing by 1 day but the MinPricingDuration is 3 days you will be charged for 3 days.              Pricing/PriceDifference      The difference between the originally paid price and the new price              Carpark/Code      Code of the booked product              Carpark/Name      Name of the booked product              Carpark/MoreInfoURL                     Carpark/BookingURL                     BarCode                     QRCode                     API_Header/Request      Copy of the original request params      *NOTE* If the Pricing/PriceDifference is negative the minus sign will be a suffix e.g. <PriceDifference>7.00-</PriceDifference>Amend Booking ResponseThe amend booking response will return the booking record with all of the updated details.For a detailed explanation of the fields returned, please see the respective booking requests for hotels, parking and lounges.Worked ExamplesBelow are worked examples of both the request and response for amending (complex) a booking.Amend Booking (complex for a hotel)RequestThe original booking was made for a hotel staying on 1st December 2018 with 8 days parking.https://api.holidayextras.com/booking/YourBookingRef<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <ArrivalDate>2018-12-02</ArrivalDate>  <ParkingDays>15</ParkingDays></Request>Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"Hotel\" Customer=\"A\" Session=\"999999999\" RequestCode=\"14\" Result=\"OK\">  <CarDetails>    <Registration>TEST123</Registration>    <CarMake/>    <CarModel/>    <CarColour/>    <OutFlight>TBC</OutFlight>  </CarDetails>  <ClientDetails>    <Title>MRS</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Address/>    <DataProtection>Y</DataProtection>    <Email>test@test.com</Email>  </ClientDetails>  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>931</AgentComm>    <VATonComm/>  </Booking>  <Pricing>    <OriginalPrice>93.10</OriginalPrice>    <NewPrice>93.10</NewPrice>    <CCardSurchargeAmount>0.00</CCardSurchargeAmount>    <CanxWaiver>0.00</CanxWaiver>    <AmendmentFee>N/A</AmendmentFee>    <PriceDifference>N/A</PriceDifference>  </Pricing>  <Itinerary>    <ArrivalDate>2018-12-02</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>RO</BoardBasis>    <Code>LHRMEP</Code>    <CarDropoffTime>0000</CarDropoffTime>    <CarPickupTime>0000</CarPickupTime>    <CarPickupDate>2018-12-17</CarPickupDate>    <ReturnFlight/>    <TerminalCode/>    <ParkingDays>15</ParkingDays>    <ParkingSpaces>1</ParkingSpaces>    <NonSmoking>Y</NonSmoking>  </Itinerary>  <Room>    <Rooms>1</Rooms>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Price>93.10</Price>    <Code>DBL</Code>  </Room>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <ArrivalDate>2018-12-02</ArrivalDate>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>15</ParkingDays>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>93.10</PriceCheckPrice>      <v>1</v>    </Request>  </API_Header></API_Reply>Amend Parking Booking With UpgradesOriginal booking made for 11th November 2020 with Fast track upgrade for 2 adults and 1 childRequesthttps://api.holidayextras.com/booking/YourBookingRef<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <Supplements>    <Code>STNSFS</Code>    <Adults>2</Adults>    <Children>2</Children>  </Supplements></Request>Get Amendment Price Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"CarPark\" Customer=\"A\" Session=\"999999999\" RequestCode=\"13\" Result=\"OK\">    <Pricing>        <OriginalPrice>72.98</OriginalPrice>        <NewPrice>79.98</NewPrice>        <CCardSurchargeAmount>0.00</CCardSurchargeAmount>        <CanxWaiver>0.00</CanxWaiver>        <Duration>8</Duration>        <MinPricingDuration>1</MinPricingDuration>        <PriceDifference>7.00</PriceDifference>    </Pricing>    <CarPark>        <Code>STN5</Code>        <Name>Long Stay</Name>        <MoreInfoURL>/v1/product/STN5</MoreInfoURL>        <BookingURL>/v1/carpark/STN5</BookingURL>        <Filter>            <meet_and_greet>0</meet_and_greet>        </Filter>    </CarPark>    <BarCode>/v1/barcode/YourBookingRef.png?key=YourKey</BarCode>    <QRCode>/v1/qrcode/YourBookingRef.png?key=YourKey</QRCode>    <API_Header>        <Request>            <v>1</v>        </Request>    </API_Header></API_Reply>Confirm Response<?xml version=\"1.0\"?><API_Reply System=\"ABC\" Version=\"1\" Product=\"CarPark\" Customer=\"A\" Session=\"999999999\" RequestCode=\"14\" Result=\"OK\">  <CarDetails>    <CarColour>White</CarColour>    <CarMake>Range Rover</CarMake>    <CarModel>Evoque</CarModel>    <Registration>TE17 STS</Registration>    <OutFlight/>  </CarDetails>  <ClientDetails>    <Title>MRS</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Address/>    <DataProtection>Y</DataProtection>    <Email>test@test.com</Email>  </ClientDetails>  <Booking>    <BookingRef>YourBookingRef</BookingRef>  </Booking>  <Pricing>    <OriginalPrice>72.98</OriginalPrice>    <NewPrice>79.98</NewPrice>    <PriceDiff>7.00</PriceDiff>    <CCardSurchargeAmount>0.00</CCardSurchargeAmount>    <CanxWaiver>0.00</CanxWaiver>  </Pricing>  <CarPark>    <ArrivalDate>2020-11-11</ArrivalDate>    <DepartDate>2020-11-19</DepartDate>    <ArrivalTime>1230</ArrivalTime>    <DepartTime>1345</DepartTime>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>VIR19</ReturnFlight>    <Duration>8</Duration>    <Remarks/>    <Code>STN5</Code>    <Name>Long Stay</Name>    <MoreInfoURL>/v1/product/STN5</MoreInfoURL>    <distance_to_airport>On airport</distance_to_airport>    <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction>    <logo>/imageLibrary/Images/85730-official-stansted-airport-parking-long-stay.png</logo>    <BookingURL>/v1/carpark/STN5</BookingURL>    <Filter>      <meet_and_greet>0</meet_and_greet>    </Filter>  </CarPark>  <BarCode>/v1/barcode/YourBookingRef.png?key=YourKey</BarCode>  <QRCode>/v1/qrcode/YourBookingRef.png?key=YourKey</QRCode>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <Email>test@test.com</Email>      <Supplements>        <Code>STNSFS</Code>        <Adults>2</Adults>        <Children>2</Children>      </Supplements>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -106,20 +106,6 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-parking-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Book Car Park",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "Book Car ParkAPI Docs > product:Parking > endpoint:carpark > Make BookingCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/CarParkCodeFor example, for Maple Manor Meet and Greet at London Gatwick North terminal the endpoint is:https://api.holidayextras.com/v1/carpark/LGW4Request ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.NB: This field can be set to NA              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              County      String      [A-Z] 20 chars      Y      County of address NB: This field can be set to NA              CustomerRef      String      [A-Z0-9] 20 chars      N      A unique reference code associated with the customer’s booking for tracking and reference purposes.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              Email      String      [A-Z0-9] 50 chars      Y      Email of lead passenger              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              NumberOfPax      Integer      [0-9] 2 chars      Y      Number of passengers.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address NB: This field can be set to NA              PriceCheckFlag      String      Y      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9]      Y      Price of the product, received from the availability request or price check.              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              Town      String      [A-Z] 20 chars      Y      Town of address NB: This field can be set to NA              lang      String      [A-Z] 2 chars      Y*      For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/carpark/STN5 HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.UK ProductsThe <RequestFlags> field dictates which fields need to be sent as part of the booking request.European ProductsThe availability response will return a list of 18 flags in the <CarDetFlags> field with a yes/no response to indicate if required. The order of the flags is always the same.PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              CarDetails      Confirmation of the vehicle details that were sent in the booking request.              CarDetails/Registration                     CarDetails/CarMake                     CarDetails/CarModel                     CarDetails/CarColour                     CarDetails/OutFlight                     CarDetails/Destination                     CarDetails/MobileNum                     ClientDetails      Confirmation of the lead passenger’s details that were sent in the booking request.              ClientDetails/Title                     ClientDetails/Initials                     ClientDetails/Surname                     ClientDetails/Email                     HandlingFee      Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero.              MoreInfoURL      The URL for viewing the booking. See view booking for more details.              CarPark      Details of the car park that were sent in the booking request.              CarPark/ArrivalDate                     CarPark/DepartDate                     CarPark/ArrivalTime                     CarPark/DepartTime                     CarPark/Duration                     CarPark/NumberOfPax                     CarPark/ReturnFlight                     CarPark/Code                     CarPark/TotalPrice                     CarPark/Name                     CarPark/introduction      Production description text              CarPark/logo      Product logo. Prepend with https:              CarPark/RequiresQRCode      Whether the QR Code needs to be used for this carpark, instead of the barcode              CarPark/BookingUrl      Prepend with https://api.holidayextras.com/              CarPark/MoreInfoUrl      Prepend with https://api.holidayextras.com/              BarCode      URL to the barcode for the booking. Prepend with https://api.holidayextras.com/              QRCode      URL to the QR code for the booking. Prepend with https://api.holidayextras.com/              QRCodeValue      (EU only) Value of the QR code that comes with email confirmation. More details about QR Code              QRCodeValueStr      (EU only) Value of the QR code that comes with email confirmation, when returning as part of a JSON resposne this value will be a string. More details about QR Code              FastTrackVouchers/Name      Only present if Fast track products have been purchased - Name used to separate multiple voucher products              FastTrackVouchers/Source      Link to the voucher document to be embeded in the client email              FastTrackVouchers/type      Content type qualifier for the Source              Booking/Status  (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking car parking.UK Products BookingRequesthttps://api.holidayextras.com/carpark/LGW4<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <DepartDate>2017-12-08</DepartDate>  <DepartTime>1200</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>57.99</PriceCheckPrice>  <CarColour>White</CarColour>  <CarMake>Range Rover</CarMake>  <CarModel>Evoque</CarModel>  <Destination>Munich</Destination>  <OutFlight>EZY8985</OutFlight>  <OutTerminal>N</OutTerminal>  <Registration>TE17 STS</Registration>  <ReturnFlight>EZY8982</ReturnFlight>  <ReturnTerminal>N</ReturnTerminal>  <MobileNum>01234567890</MobileNum></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>7.25</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>    <CarMake>RANGE ROVER</CarMake>    <CarModel>EVOQUE</CarModel>    <CarColour>WHITE</CarColour>    <OutFlight>EZY8985</OutFlight>    <Destination>MUNICH</Destination>    <MobileNum/>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>test@test.com</Email>  </ClientDetails>  <HandlingFee>0.00</HandlingFee>  <MoreInfoURL>/booking/YourBookingRef</MoreInfoURL>  <CarPark>    <ArrivalDate>2017-12-01</ArrivalDate>    <DepartDate>2017-12-08</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>7</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>EZY8982</ReturnFlight>    <Code>LGW4</Code>    <TotalPrice>57.99</TotalPrice>    <Name>Maple Manor Meet and Greet North</Name>    <introduction>With 20 years' experience in providing a great service, Maple Manor Meet and Greet parking is a firm favourite with our customers and it's easy to see why. One of their professional, insured chauffeurs will meet you at the North terminal and park your car for you in a secured car park while you catch your flight. It couldn't be simpler and all for this low price. We only sell airport-approved Meet and Greet services and Maple Manor is no exception.</introduction>    <advance_purchase>1</advance_purchase>    <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/LGW4_LGV0_LGT9_LGY8_thumbnail_logo.png</logo>    <BookingURL>/carpark/LGW4</BookingURL>    <MoreInfoURL>/product/LGW4</MoreInfoURL>  </CarPark>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>57.99</PriceCheckPrice>      <CarColour>White</CarColour>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <Registration>TE17 STS</Registration>      <Destination>Munich</Destination>      <OutFlight>EZY8985</OutFlight>      <OutTerminal>N</OutTerminal>      <ReturnFlight>EZY8982</ReturnFlight>      <ReturnTerminal>N</ReturnTerminal>      <MobileNum>01234567890</MobileNum>    </Request>  </API_Header></API_Reply>European Products BookingRequesthttps://api.holidayextras.com/carpark/MU01<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <DepartDate>2017-12-08</DepartDate>  <DepartTime>1200</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>HERR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>35.00</PriceCheckPrice>  <System>ABG</System>  <OutFltNo>EZY8982</OutFltNo>  <InFltNo>EZY8985</InFltNo>  <InFltTime>1130</InFltTime></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"4\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>3.75</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <MoreInfoURL>/carpark/YourBookingRef.de</MoreInfoURL>  <CarPark>    <ArrivalDate>2017-12-01</ArrivalDate>    <DepartDate>2017-12-08</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>7</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight/>    <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags>    <Code>MU01</Code>    <Name>Parkservice Sky München</Name>    <BookingURL>/carpark/MU01.de</BookingURL>    <MoreInfoURL>/product/MU01.de</MoreInfoURL>    <TotalPrice>35.00</TotalPrice>    <GatePrice>0.00</GatePrice>  </CarPark>  <BarCode>/barcode/YourBookingRef.png?key=YourKey</BarCode>  <ClientDetails>    <Title>HERR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>TEST@TEST.COM</Email>    <Town>TESTVILLE</Town>    <Postcode>TE12 3ST</Postcode>    <DayPhone>TBC</DayPhone>    <Remarks/>    <Address0>123 TEST STREET</Address0>    <DataProtection>Y</DataProtection>    <County>TESTSHIRE</County>    <Confirmation>Y</Confirmation>  </ClientDetails>  <Pricing>    <TotalPrice>35.00</TotalPrice>  </Pricing>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Title>HERR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>35.00</PriceCheckPrice>      <System>ABG</System>      <OutFltNo>EZY8982</OutFltNo>      <InFltNo>EZY8985</InFltNo>      <InFltTime>1130</InFltTime>    </Request>  </API_Header></API_Reply>UK Product booking With UpgradesRequesthttps://api.holidayextras.com/carpark/STN5<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-08</ArrivalDate>  <ArrivalTime>1230</ArrivalTime>  <ArrivalDate>2020-11-06</ArrivalDate>  <DepartTime>1345</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>57.99</PriceCheckPrice>  <CarColour>White</CarColour>  <CarMake>Range Rover</CarMake>  <CarModel>Evoque</CarModel>  <Destination>Munich</Destination>  <OutFlight>EZY8985</OutFlight>  <OutTerminal>N</OutTerminal>  <Registration>TE17 STS</Registration>  <ReturnFlight>EZY8982</ReturnFlight>  <ReturnTerminal>N</ReturnTerminal>  <MobileNum>01234567890</MobileNum>  <Supplements>    <Code>HXOST1</Code>    <Date>2020-11-08</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>1.99</TotalPrice>  </Supplements>  <Supplements>    <Code>STNSFS</Code>    <Date>2020-11-08</Date>    </Quantity>    <Adults>2</Adults>    <Children>1</Children>    <TotalPrice>15.00</TotalPrice>  </Supplements></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>3.75</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>    <CarMake>RANGE ROVER</CarMake>    <CarModel>EVOQUE</CarModel>    <CarColour>WHITE</CarColour>    <OutFlight/>    <Destination>-</Destination>    <MobileNum>01234567890</MobileNum>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>Test</Surname>    <Email>test@test.com</Email>  </ClientDetails>  <HandlingFee>0.00</HandlingFee>  <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  <CarPark>    <ArrivalDate>2020-11-08</ArrivalDate>    <DepartDate>2020-11-16</DepartDate>    <ArrivalTime>1230</ArrivalTime>    <DepartTime>1345</DepartTime>    <Duration>8</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>VIR19</ReturnFlight>    <Code>STN5</Code>    <TotalPrice>49.99</TotalPrice>    <Name>Long Stay</Name>    <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction>    <advance_purchase>1</advance_purchase>    <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/85730-official-stansted-airport-parking-long-stay.png</logo>    <RequiresQRCode>0</RequiresQRCode>    <BookingURL>/v1/carpark/STN5</BookingURL>    <MoreInfoURL>/v1/product/STN5</MoreInfoURL>  </CarPark>  <BarCode>/v1/barcode/YourBookingRef.png?key=ONLIN</BarCode>  <QRCode>/v1/qrcode/YourBookingRef.png?key=ONLIN</QRCode>  <FastTrackVouchers>    <name>Fast Track Voucher</name>    <source>https://voucher.holidayextras.co.uk/voucher/fastTrack?email=YourEmail&amp;booking_ref=YourBookingRef&amp;agent=YourABTANumber&amp;productType=carparks&amp;productCode=STNSFS</source>    <type>text/html</type>  </FastTrackVouchers>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-11-08</ArrivalDate>      <ArrivalTime>12:30</ArrivalTime>      <DepartDate>2020-11-16</DepartDate>      <DepartTime>13:45</DepartTime>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>50.05</PriceCheckPrice>      <CarColour>White</CarColour>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <Registration>TE17 STS</Registration>      <ReturnFlight>VIR19</ReturnFlight>      <Supplement>        <Code>HXOST1</Code>        <Date>2017-12-01</Date>        <Quantity>1</Quantity>      </Supplement>      <Supplement>        <Code>STNSFS</Code>        <Date>2017-12-01</Date>        <Adults>2</Adults>        <Children>1</Children>      </Supplement>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/parking/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-de-start-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Book Car Park - DE-Start method",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "Book Car Park - DE-Start methodCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://payment.holidayextras.com/legacy/carpark/CarParkCodeRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  StartCustomer      String      [0-9] 6 chars      Y      This will be assigned to you by your Account Manager during set up.              BusinessUnit      String      [0-9] 3 chars      Y      This will be assigned to you by your Account Manager during set up.              Operator      String      [A-Z] 3 chars      Y      This always defaults to BJT.              key      String      [A-Z] 10 chars      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              Registration      String      [A-Z0-9] 15 chars      N §      Vehicle registration number.              CarMake      String      [A-Z0-9] 25 chars      N §      The make of the car, e.g Audi.              CarModel      String      [A-Z0-9] 25 chars      N §      The model of the car, e.g. A6.              CarColour      String      [A-Z] 25 chars      N §      The colour of the car, e.g. black.              Title      String      [0-9] 4 chars      Y      Title of lead passenger.              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger.              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger.              NumberOfPax      Integer      [0-9] 2 chars      Y      Number of passengers.              Remarks      String      [A-Z0-9] 60 chars      N      Any remarks the agent wishes to add to the booking. Please note, these are not passed through to the supplier.      NB: The fields required by the carpark are returned in the availability request, in the <RequestFlags> element.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.PaymentThis existing integration does support direct encashment from retail customers. For more information please see the section on Payment.Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              CarDetails      Confirmation of the vehicle details that were sent in the booking request.              ClientDetails      Confirmation of the lead passenger’s details that were sent in the booking request.              HandlingFee      Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero.              MoreInfoURL      The URL for viewing the booking.              CarPark      Details of the car park that were sent in the booking request.              API_Header/Request      A list of parameters that were sent in the booking request.      Worked ExamplesBelow are worked examples of both the request and response for booking car parking using the DE-Start method.Car Park Booking Request - DE-Start methodhttps://payment.holidayextras.com/legacy/carpark/FRA8    <Request>        <StartCustomer>YourStartCustomer</StartCustomer>        <BusinessUnit>YourBusinessUnit</BusinessUnit>        <Operator>BJT</Operator>        <Initials>YourInitials</Initials>        <key>YourKey</key>        <token>YourToken</token>        <ArrivalDate>2017-12-01</ArrivalDate>        <ArrivalTime>1200</ArrivalTime>        <DepartDate>2017-12-08</DepartDate>        <DepartTime>1200</DepartTime>        <NumberOfPax>1</NumberOfPax>        <Registration>TE17 STS</Registration>        <CarMake>Range Rover</CarMake>        <CarModel>Evoque</CarModel>        <CarColour>White</CarColour>        <Title>MR</Title>        <Initial>T</Initial>        <Surname>TEST</Surname>        <Remarks>Car Park Test</Remarks>    </Request>Car Park Booking Response - DE-Start method<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>5.47-</AgentComm>    <VATonComm>0.87-</VATonComm>    <StartRef>YourStartRef</StartRef>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <CustomerRef>N/A</CustomerRef>    <Remarks>Car Park Test</Remarks>  </ClientDetails>  <API_Header>    <Request>      <StartCustomer>YourStartCustomer</StartCustomer>      <BusinessUnit>YourBusinessUnit</BusinessUnit>      <Operator>BJT</Operator>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Registration>TE17 STS</Registration>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <CarColour>White</CarColour>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Remarks>Car Park Test</Remarks>      <debug>1</debug>      <system>de</system>      <System>ABG</System>    </Request>  </API_Header>  <CarPark>    <ArrivalDate>01DEC18</ArrivalDate>    <DepartDate>08DEC18</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>8</Duration>    <NumberOfPax>1</NumberOfPax>    <Code>FRA8</Code>    <BookingURL>/api/carpark/FRA8/debug</BookingURL>    <MoreInfoURL>/api/product/FRA8/debug</MoreInfoURL>  </CarPark></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/de-start/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "hxapi-hotel-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Hotel Booking Request",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "Hotel Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/hotel/LocationCodeFor example, for Mercure at London Heathrow the endpoint is:https://api.holidayextras.com/v1/hotel/LHRMEARequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer arrives at hotel.              Nights      Integer      1, 2, 3, etc      Y      Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays.              RoomCode      String      [A-Z0-9] 3 chars      Y      See RoomCodes for a list of valid codes.              Adults      Integer      [1-5] 1 char      Y      The number of adults occupying the room.              Children      Integer      [0-4] 1 char      Y      The number of children occupying the room.              ParkingDays      Integer      [0-9] 2 chars      Y      NB: The maximum duration accepted for ParkingDays is 30.              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger. If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on. NB: This field can be set to NA              Town      String      [A-Z] 20 chars      Y      Town of address. NB: This field can be set to NA              County      String      [A-Z] 20 chars      Y      County of address. NB: This field can be set to NA              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address. NB: This field can be set to NA              DayPhone      Integer      [0-9] 20 chars max      N      The customer’s telephone number.              Email      String      [A-Z0-9] 50 chars      Y      The email address of customer.              CustomerRef      String      [A-Z0-9] 20 chars      N      Enter your Customer Reference to help match bookings for accounting purposes.              Remarks      String      [A-Z0-9] 60 chars      N      Pass in Remarks for notification such as COT REQUESTED in ROOM              Waiver      Boolean      [0,1]      Y      Defaults to 0 if not supplied.              DataProtection      String      [Y,N]      N      Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied.              PriceCheckFlag      String      [Y]      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9]      Y      Price of the product, received from the availability request or price check.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              lang      String      [A-Z] 2 chars      Y*      For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/hotel/LGWSOF HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Multiple rooms on same bookingCurrently, we can only accept a maximum of 2 rooms per booking. If the customer needs more, you will need to make multiple requests. If an intermediary account, you should note that this would lead to multiple transactions on the credit card, and multiple charges, and therefore we advise against it.The additional parameters for including a second room are:            Name      Data Type      Format      Mandatory?      Additional Information                  SecondRoomType      String      [A-Z0-9] 2 chars      N*      This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per Room Codes.              SecondRoomCode      String      Room Codes      N      NB: Please note that the room codes differ between availability and booking requests.              SecondRoomAdults      Integer      [1-5] 1 char      N      The number of adults occupying the second room.              SecondRoomChildren      Integer      [0-4] 1 char      N      The number of children occupying the second room.      UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are:            Name      Data Type      Format      Mandatory?                  CarDropoffDate      Date      YYYY-MM-DD      Y              CarDropoffTime      Time      HHMM      Y              CarPickupDate      Date      YYYY-MM-DD      Y              CarPickupTime      Time      HHMM      Y              ReturnFlight      String      [A-Z0-9] 10 chars      N              TerminalCode      String      [A-Z0-9] 2 chars      N              Registration      String      [A-Z0-9] 20 chars      N              CarMake      String      [A-Z0-9] 20 chars      N              CarModel      String      [A-Z0-9] 20 chars      N              CarColour      String      [A-Z0-9] 20 chars      N      PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Hotel Booking ResponseThe hotel booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              Itinerary      This section confirms details of the hotel on the booking.              Room      This section confirms details of the room booked at the hotel.              ClientDetails      Confirmation of the customer’s details that were sent in the booking request.              Pricing      Confirmation of the price paid by the customer for the hotel room.              Booking/Status    (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval  (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking hotels.UK Hotel Booking - Room OnlyRequesthttps://api.holidayextras.com/v1/hotel/LHRMEA<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DBL</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>55.00</PriceCheckPrice>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>        <AgentComm>6.53</AgentComm>        <VATonComm>0.00</VATonComm>        <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>    </Booking>    <Hotel/>    <Itinerary>        <TotalPrice>55.00</TotalPrice>        <ArrivalDate>2017-12-01</ArrivalDate>        <Nights>1</Nights>        <BoardBasis>RO</BoardBasis>        <NonSmoking>N</NonSmoking>        <ReturnFlight/>        <TerminalCode/>        <Code>LHRMEA</Code>        <Name>Mercure</Name>        <ParkingDays>0</ParkingDays>        <ParkingSpaces>0</ParkingSpaces>    </Itinerary>    <Room>        <Adults>2</Adults>        <Children>0</Children>        <Infants>0</Infants>        <Code>DBL</Code>    </Room>    <CarDetails>        <Registration/>        <CarMake/>        <CarModel/>        <CarColour/>    </CarDetails>    <ClientDetails>        <Title>MR</Title>        <Initial>T</Initial>        <Surname>TEST</Surname>        <Email>test@test.com</Email>        <Address/>        <Town/>        <County/>        <Postcode/>        <EvePhone/>    </ClientDetails>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <token>YourToken</token>            <ArrivalDate>2017-12-01</ArrivalDate>            <Nights>1</Nights>            <RoomCode>DBL</RoomCode>            <ParkingDays>0</ParkingDays>            <Adults>2</Adults>            <Children>0</Children>            <Title>Mr</Title>            <Initial>T</Initial>            <Surname>TEST</Surname>            <Address >1 Test Street</Address >            <Town>Testville</Town>            <County>Testshire</County>            <Postcode>TE1 STS</Postcode>            <DayPhone>01234567890</DayPhone>            <Email>test@test.com</Email>            <DataProtection>N</DataProtection>            <PriceCheckFlag>Y</PriceCheckFlag>            <PriceCheckPrice>55.00</PriceCheckPrice>            <v>1</v>        </Request>    </API_Header></API_Reply>European Hotel BookingRequesthttps://api.holidayextras.com/v1/hotel/MUCLAN<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DZ</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>120.00</PriceCheckPrice>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"4\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <MoreInfoURL>/v1/booking/YourBookingRef.de</MoreInfoURL>  </Booking>  <Hotel/>  <Itinerary>    <ArrivalDate>2017-12-01</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>F</BoardBasis>    <NonSmoking>N</NonSmoking>    <ParkingDays>0</ParkingDays>    <ParkingSpaces>0</ParkingSpaces>    <Code>MUCLAN</Code>    <Name>Schweigers Landgasthof</Name>  </Itinerary>  <Room>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Code>DZ</Code>  </Room>  <ClientDetails>    <Title>Herr</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>TEST@TEST.COM</Email>    <Town>TESTVILLE</Town>    <Postcode>TE1 STS</Postcode>    <DayPhone>01234567890</DayPhone>    <Remarks/>    <Address0>1 Test Street</Address0>    <Address1>TBC</Address1>    <DataProtection>N</DataProtection>    <County>TESTSHIRE</County>  </ClientDetails>  <Pricing>    <Price>120.00</Price>  </Pricing>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>0</ParkingDays>      <Adults>2</Adults>      <Children>0</Children>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address0>1 Test Street</Address0>      <Town>Testville</Town>      <County>Testshire</County>      <Postcode>TE1 STS</Postcode>      <DayPhone>01234567890</DayPhone>      <Email>test@test.com</Email>      <DataProtection>N</DataProtection>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>120.00</PriceCheckPrice>      <System>ABG</System>      <lang>de</lang>      <v>1</v>    </Request>  </API_Header></API_Reply>UK Hotel booking with UpgradesRequesthttps://api.holidayextras.com/v1/hotel/LGWSOF<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-10</ArrivalDate>  <Nights>1</Nights>  <RoomCode>DBL</RoomCode>  <ParkingDays>0</ParkingDays>  <Adults>2</Adults>  <Children>0</Children>  <Title>Mr</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address >1 Test Street</Address >  <Town>Testville</Town>  <County>Testshire</County>  <Postcode>TE1 STS</Postcode>  <DayPhone>01234567890</DayPhone>  <Email>test@test.com</Email>  <DataProtection>N</DataProtection>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>135.00</PriceCheckPrice>  <Supplements>    <Code>LGWSOE</Code>    <Date>2020-11-10</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>40.00</TotalPrice>  </Supplements>  <Supplements>    <Code>LGWASC</Code>    <Date>2020-11-11</Date>    <LoungeArrival>2020-11-11 12:30</LoungeArrival>    </Quantity>    <Adults>2</Adults>    <Children>0</Children>    <TotalPrice>56.00</TotalPrice>  </Supplements>  <v>1</v></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"HotelWithParking\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>13.45</AgentComm>    <VATonComm>0.00</VATonComm>    <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  </Booking>  <Hotel/>  <Itinerary>    <TotalPrice>255.55</TotalPrice>    <ArrivalDate>2020-11-10</ArrivalDate>    <Nights>1</Nights>    <BoardBasis>RO</BoardBasis>    <NonSmoking>N</NonSmoking>    <ReturnFlight/>    <TerminalCode/>    <Code>LGWSOF</Code>    <Name>Sofitel</Name>    <ParkingDays>0</ParkingDays>    <ParkingSpaces>0</ParkingSpaces>  </Itinerary>  <Room>    <Adults>2</Adults>    <Children>0</Children>    <Infants>0</Infants>    <Code>DBL</Code>  </Room>  <CarDetails>    <Registration/>    <CarMake/>    <CarModel/>    <CarColour/>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>test@test.com</Email>    <Address/>    <Town/>    <County/>    <Postcode/>    <EvePhone>01234567890</EvePhone>  </ClientDetails>  <CurrentSupplements>    <Code>LGWSOE</Code>    <Name>Luxury room upgrade</Name>    <Price>66.50</Price>    <NonDiscPrice>66.50</NonDiscPrice>    <Per>room</Per>    <Adults>0</Adults>    <Children>0</Children>    <Date>2020-11-10</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <CurrentSupplements>    <Code>LGWASC</Code>    <Name>Club Aspire North Lounge</Name>    <Price>47.50</Price>    <NonDiscPrice>47.50</NonDiscPrice>    <Per>person</Per>    <Adults>2</Adults>    <Children>0</Children>    <Date>2020-11-11</Date>    <Remarks/>    <Canx>Y</Canx>  </CurrentSupplements>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-11-10</ArrivalDate>      <ArrivalTime>12:30</ArrivalTime>      <Title>Mr</Title>      <Initial>T</Initial>      <Surname>Test</Surname>      <Address>Holiday Extras Ltd</Address>      <Address>Ashford Road</Address>      <Town>Hythe</Town>      <County>Kent</County>      <PostCode>CT214JF</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>135.00</PriceCheckPrice>      <Adults>2</Adults>      <Children>0</Children>      <Nights>1</Nights>      <RoomCode>DBL</RoomCode>      <ParkingDays>0</ParkingDays>      <Supplements>        <Code>LGWSOE</Code>        <Date>2020-11-10</Date>        <Quantity>1</Quantity>        <TotalPrice>70.00</TotalPrice>      </Supplements>      <Supplements>        <Code>LGWASC</Code>        <Date>2020-11-11</Date>        <Adults>2</Adults>        <Children>0</Children>        <TotalPrice>56.00</TotalPrice>      </Supplements>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -134,6 +120,20 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-parking-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Book Car Park",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "Book Car ParkAPI Docs > product:Parking > endpoint:carpark > Make BookingCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://api.holidayextras.com/v1/carpark/CarParkCodeFor example, for Maple Manor Meet and Greet at London Gatwick North terminal the endpoint is:https://api.holidayextras.com/v1/carpark/LGW4Request ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Address[]      String      [A-Z0-9] 25 chars      Y      First line of address (house name / number and road) of lead passenger If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.NB: This field can be set to NA              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              County      String      [A-Z] 20 chars      Y      County of address NB: This field can be set to NA              CustomerRef      String      [A-Z0-9] 20 chars      N      A unique reference code associated with the customer’s booking for tracking and reference purposes.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              Email      String      [A-Z0-9] 50 chars      Y      Email of lead passenger              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              NumberOfPax      Integer      [0-9] 2 chars      Y      Number of passengers.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              PostCode      String      [A-Z0-9] 10 chars      Y      Post code of address NB: This field can be set to NA              PriceCheckFlag      String      Y      Y      Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.              PriceCheckPrice      Float      [0-9]      Y      Price of the product, received from the availability request or price check.              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              Title      String      [A-Z] 4 chars      Y      Title of lead passenger, an option from the list of valid titles              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              Town      String      [A-Z] 20 chars      Y      Town of address NB: This field can be set to NA              lang      String      [A-Z] 2 chars      Y*      For European products, sets the language of the booking. (the default is de, other values available are en, fr, it, es, pt, pl and nl.)              Supplements/Code      String      [A-Z0-9] 5 chars      N      Product code of the upgrade to book. See below for more info on booking upgrades              Supplements/Date      String      YYYY-MM-DD      Y      The date to book the upgrade for. This should be brought forward from the upgrade availability request.              Supplements/Quantity      Integer      [0-9]1 char      Y*      For per room/booking upgrades, specify the required quantity              Supplements/Adults      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of adult passes              Supplements/Children      Integer      [0-9]1 char      Y*      For per person upgrades, specify the number of child passes              Supplements/TotalPrice      Float      [0-9]      Y      Mandatory for all upgrades. The total price of the upgrade, accounting for total quantity              Supplements/LoungeArrival      String      YYYY-MM-DD HH:mm      Y*      Mandatory for Lounge upgrades. Specifies the time the client wishes to enter the lounge      Booking UpgradesIt is possible to booking upgrade items at the same time as making a core product booking. Once the core product has been selected you must make an Upgrade availability request. Use the information in the response to pick the upgrades desired for the product. In the booking request any number of Supplements tags may be added but each must be for a unique upgrade. Multiple Supplements can be added in the request using the square bracket([]) notation e.g.POST /v1/carpark/STN5 HTTP/1.1Host: api.holidayextras.comContent-Type: application/x-www-form-urlencodedABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2020-11-09&ArrivalTime=12:30&DepartDate=2020-11-17&DepartTime=13:45&Title=Mr&Initial=T&Surname=Test&Address=Holiday Extras Ltd&Address=Ashford Road&Town=Hythe&County=Kent&PostCode=CT214JF&Email=test@test.com&PriceCheckFlag=Y&PriceCheckPrice=50.05&CarColour=White&CarMake=Range Rover&CarModel=Vogue&Registration=TE17 STS&ReturnFlight=VIR19&Supplements[0][Code]=HXOST1&Supplements[0][Quantity]=1&Supplements[0][Date]=2020-11-09&Supplements[0][TotalPrice]=1.99&Supplements[1][Code]=STNSFS&Supplements[1][Date]=2020-11-09&Supplements[1][Adults]=2&Supplements[1][Children]=1&Supplements[1][TotalPrice]=21.00For per Room or per Booking upgrades a Quantity must be supplied.For per Person upgrades the number of Adult and Children passes must be supplied. Depending on the upgrade it may also be necessary to supplier the number of Infants.PricingA TotalPrice must be included with each supplement node. This should be calculated as follows;  Per Room or per Booking - Quantity x Price  Per Person - (Adults x AdPrice) + (Children x ChPrice)*NOTE* When booking upgrades the cost of the upgrades should not be added to the PriceCheckPrice. This should only reflect the price of the core product.FastTrackWhen booking fast track passes you will receive links to the client’s fast track passes in the booking response. These can be added to your own confirmation emails and will be required by the client to use their passes.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.UK ProductsThe <RequestFlags> field dictates which fields need to be sent as part of the booking request.European ProductsThe availability response will return a list of 18 flags in the <CarDetFlags> field with a yes/no response to indicate if required. The order of the flags is always the same.PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.Please contact your Account Manager if you have any questions concerning payment.Booking Terms and ConditionsIt is important that the customer has access to the Terms and Conditions at the time of placing their booking and after. We highly recommend that these are made clear to the customer before booking.For European products, please use the following link:http://www.holidayextras.de/images/de-hx/pdf/agb.pdfIf you require translations of Terms and Conditions into other languages, you can simply change /de-hx/ (German) into nl-hx (Dutch), it-hex (Italian), pt-hx (Portuguese), fr-hx (French), es-hx (Spanish) or en-hx (English).Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              CarDetails      Confirmation of the vehicle details that were sent in the booking request.              CarDetails/Registration                     CarDetails/CarMake                     CarDetails/CarModel                     CarDetails/CarColour                     CarDetails/OutFlight                     CarDetails/Destination                     CarDetails/MobileNum                     ClientDetails      Confirmation of the lead passenger’s details that were sent in the booking request.              ClientDetails/Title                     ClientDetails/Initials                     ClientDetails/Surname                     ClientDetails/Email                     HandlingFee      Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero.              MoreInfoURL      The URL for viewing the booking. See view booking for more details.              CarPark      Details of the car park that were sent in the booking request.              CarPark/ArrivalDate                     CarPark/DepartDate                     CarPark/ArrivalTime                     CarPark/DepartTime                     CarPark/Duration                     CarPark/NumberOfPax                     CarPark/ReturnFlight                     CarPark/Code                     CarPark/TotalPrice                     CarPark/Name                     CarPark/introduction      Production description text              CarPark/logo      Product logo. Prepend with https:              CarPark/RequiresQRCode      Whether the QR Code needs to be used for this carpark, instead of the barcode              CarPark/BookingUrl      Prepend with https://api.holidayextras.com/              CarPark/MoreInfoUrl      Prepend with https://api.holidayextras.com/              BarCode      URL to the barcode for the booking. Prepend with https://api.holidayextras.com/              QRCode      URL to the QR code for the booking. Prepend with https://api.holidayextras.com/              QRCodeValue      (EU only) Value of the QR code that comes with email confirmation. More details about QR Code              QRCodeValueStr      (EU only) Value of the QR code that comes with email confirmation, when returning as part of a JSON resposne this value will be a string. More details about QR Code              FastTrackVouchers/Name      Only present if Fast track products have been purchased - Name used to separate multiple voucher products              FastTrackVouchers/Source      Link to the voucher document to be embeded in the client email              FastTrackVouchers/type      Content type qualifier for the Source              Booking/Status  (Future)      Indicates the current status of the booking (Pending, Confirmed, Cancelled, or Error).              Booking/SuggestedPollingInterval (Future)      Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier.)              CurrentSupplements/Code      Upgrade Code              CurrentSupplements/Name      Name of the upgrade              CurrentSupplements/Price      Price Paid for the upgrade              CurrentSupplements/NonDiscPrice      The original price of the upgrade before any discounts              CurrentSupplements/Per      The pricing basis for the product (booking/room/person)              CurrentSupplements/Adults      The number of adult passes purchased              CurrentSupplements/Children      The number of child passes purchased              CurrentSupplements/Date      The date the upgrade has been purchased for              CurrentSupplements/Remarks      Internal notes              CurrentSupplements/Canx      Whether the upgrade can be cancelled              API_Header/Request      A list of parameters that were sent in the booking request.      Booking ConfirmationWe expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response.However, we also have capability to send booking confirmation emails ourselves on behalf of partners. This feature is not available as standard, and so if you wish to enable this please speak to your Account Manager.Worked ExamplesBelow are worked examples of both the request and response for booking car parking.UK Products BookingRequesthttps://api.holidayextras.com/carpark/LGW4<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <DepartDate>2017-12-08</DepartDate>  <DepartTime>1200</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>57.99</PriceCheckPrice>  <CarColour>White</CarColour>  <CarMake>Range Rover</CarMake>  <CarModel>Evoque</CarModel>  <Destination>Munich</Destination>  <OutFlight>EZY8985</OutFlight>  <OutTerminal>N</OutTerminal>  <Registration>TE17 STS</Registration>  <ReturnFlight>EZY8982</ReturnFlight>  <ReturnTerminal>N</ReturnTerminal>  <MobileNum>01234567890</MobileNum></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>7.25</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>    <CarMake>RANGE ROVER</CarMake>    <CarModel>EVOQUE</CarModel>    <CarColour>WHITE</CarColour>    <OutFlight>EZY8985</OutFlight>    <Destination>MUNICH</Destination>    <MobileNum/>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>test@test.com</Email>  </ClientDetails>  <HandlingFee>0.00</HandlingFee>  <MoreInfoURL>/booking/YourBookingRef</MoreInfoURL>  <CarPark>    <ArrivalDate>2017-12-01</ArrivalDate>    <DepartDate>2017-12-08</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>7</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>EZY8982</ReturnFlight>    <Code>LGW4</Code>    <TotalPrice>57.99</TotalPrice>    <Name>Maple Manor Meet and Greet North</Name>    <introduction>With 20 years' experience in providing a great service, Maple Manor Meet and Greet parking is a firm favourite with our customers and it's easy to see why. One of their professional, insured chauffeurs will meet you at the North terminal and park your car for you in a secured car park while you catch your flight. It couldn't be simpler and all for this low price. We only sell airport-approved Meet and Greet services and Maple Manor is no exception.</introduction>    <advance_purchase>1</advance_purchase>    <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/LGW4_LGV0_LGT9_LGY8_thumbnail_logo.png</logo>    <BookingURL>/carpark/LGW4</BookingURL>    <MoreInfoURL>/product/LGW4</MoreInfoURL>  </CarPark>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>57.99</PriceCheckPrice>      <CarColour>White</CarColour>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <Registration>TE17 STS</Registration>      <Destination>Munich</Destination>      <OutFlight>EZY8985</OutFlight>      <OutTerminal>N</OutTerminal>      <ReturnFlight>EZY8982</ReturnFlight>      <ReturnTerminal>N</ReturnTerminal>      <MobileNum>01234567890</MobileNum>    </Request>  </API_Header></API_Reply>European Products BookingRequesthttps://api.holidayextras.com/carpark/MU01<Request>  <ABTANumber>YourABTANumber</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2017-12-01</ArrivalDate>  <ArrivalTime>1200</ArrivalTime>  <DepartDate>2017-12-08</DepartDate>  <DepartTime>1200</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>HERR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>35.00</PriceCheckPrice>  <System>ABG</System>  <OutFltNo>EZY8982</OutFltNo>  <InFltNo>EZY8985</InFltNo>  <InFltTime>1130</InFltTime></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"4\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>3.75</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <MoreInfoURL>/carpark/YourBookingRef.de</MoreInfoURL>  <CarPark>    <ArrivalDate>2017-12-01</ArrivalDate>    <DepartDate>2017-12-08</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>7</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight/>    <CarDetFlags>NNNNNNNNYYNYNNNNNN</CarDetFlags>    <Code>MU01</Code>    <Name>Parkservice Sky München</Name>    <BookingURL>/carpark/MU01.de</BookingURL>    <MoreInfoURL>/product/MU01.de</MoreInfoURL>    <TotalPrice>35.00</TotalPrice>    <GatePrice>0.00</GatePrice>  </CarPark>  <BarCode>/barcode/YourBookingRef.png?key=YourKey</BarCode>  <ClientDetails>    <Title>HERR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <Email>TEST@TEST.COM</Email>    <Town>TESTVILLE</Town>    <Postcode>TE12 3ST</Postcode>    <DayPhone>TBC</DayPhone>    <Remarks/>    <Address0>123 TEST STREET</Address0>    <DataProtection>Y</DataProtection>    <County>TESTSHIRE</County>    <Confirmation>Y</Confirmation>  </ClientDetails>  <Pricing>    <TotalPrice>35.00</TotalPrice>  </Pricing>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Title>HERR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>35.00</PriceCheckPrice>      <System>ABG</System>      <OutFltNo>EZY8982</OutFltNo>      <InFltNo>EZY8985</InFltNo>      <InFltTime>1130</InFltTime>    </Request>  </API_Header></API_Reply>UK Product booking With UpgradesRequesthttps://api.holidayextras.com/carpark/STN5<Request>  <ABTANumber>YourABTA</ABTANumber>  <Password>YourPassword</Password>  <Initials>YourInitials</Initials>  <key>YourKey</key>  <token>YourToken</token>  <ArrivalDate>2020-11-08</ArrivalDate>  <ArrivalTime>1230</ArrivalTime>  <ArrivalDate>2020-11-06</ArrivalDate>  <DepartTime>1345</DepartTime>  <NumberOfPax>1</NumberOfPax>  <Title>MR</Title>  <Initial>T</Initial>  <Surname>TEST</Surname>  <Address>123 Test Street</Address>  <Town>Testville</Town>  <County>Testshire</County>  <PostCode>TE12 3ST</PostCode>  <Email>test@test.com</Email>  <PriceCheckFlag>Y</PriceCheckFlag>  <PriceCheckPrice>57.99</PriceCheckPrice>  <CarColour>White</CarColour>  <CarMake>Range Rover</CarMake>  <CarModel>Evoque</CarModel>  <Destination>Munich</Destination>  <OutFlight>EZY8985</OutFlight>  <OutTerminal>N</OutTerminal>  <Registration>TE17 STS</Registration>  <ReturnFlight>EZY8982</ReturnFlight>  <ReturnTerminal>N</ReturnTerminal>  <MobileNum>01234567890</MobileNum>  <Supplements>    <Code>HXOST1</Code>    <Date>2020-11-08</Date>    <Quantity>1</Quantity>    </Adults>    </Children>    <TotalPrice>1.99</TotalPrice>  </Supplements>  <Supplements>    <Code>STNSFS</Code>    <Date>2020-11-08</Date>    </Quantity>    <Adults>2</Adults>    <Children>1</Children>    <TotalPrice>15.00</TotalPrice>  </Supplements></Request>Response<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>3.75</AgentComm>    <VATonComm>0.00</VATonComm>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>    <CarMake>RANGE ROVER</CarMake>    <CarModel>EVOQUE</CarModel>    <CarColour>WHITE</CarColour>    <OutFlight/>    <Destination>-</Destination>    <MobileNum>01234567890</MobileNum>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>Test</Surname>    <Email>test@test.com</Email>  </ClientDetails>  <HandlingFee>0.00</HandlingFee>  <MoreInfoURL>/v1/booking/YourBookingRef</MoreInfoURL>  <CarPark>    <ArrivalDate>2020-11-08</ArrivalDate>    <DepartDate>2020-11-16</DepartDate>    <ArrivalTime>1230</ArrivalTime>    <DepartTime>1345</DepartTime>    <Duration>8</Duration>    <NumberOfPax>1</NumberOfPax>    <ReturnFlight>VIR19</ReturnFlight>    <Code>STN5</Code>    <TotalPrice>49.99</TotalPrice>    <Name>Long Stay</Name>    <introduction>We didn't think people thought about their airport parking before booking their holiday. But Stansted Long Stay is so smooth, so efficient, so easy to use, that one customer actually told us she might fly from Stansted just to use it again. Maybe she loved the great prices - it's almost always our best value car park at Stansted - or maybe the award-winning security. Or maybe, like most of our Stansted Long Stay customers, she was just happy with everything.</introduction>    <advance_purchase>1</advance_purchase>    <logo>//d1xcii4rs5n6co.cloudfront.net/libraryimages/85730-official-stansted-airport-parking-long-stay.png</logo>    <RequiresQRCode>0</RequiresQRCode>    <BookingURL>/v1/carpark/STN5</BookingURL>    <MoreInfoURL>/v1/product/STN5</MoreInfoURL>  </CarPark>  <BarCode>/v1/barcode/YourBookingRef.png?key=ONLIN</BarCode>  <QRCode>/v1/qrcode/YourBookingRef.png?key=ONLIN</QRCode>  <FastTrackVouchers>    <name>Fast Track Voucher</name>    <source>https://voucher.holidayextras.co.uk/voucher/fastTrack?email=YourEmail&amp;booking_ref=YourBookingRef&amp;agent=YourABTANumber&amp;productType=carparks&amp;productCode=STNSFS</source>    <type>text/html</type>  </FastTrackVouchers>  <API_Header>    <Request>      <ABTANumber>YourABTANumber</ABTANumber>      <Password>YourPassword</Password>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2020-11-08</ArrivalDate>      <ArrivalTime>12:30</ArrivalTime>      <DepartDate>2020-11-16</DepartDate>      <DepartTime>13:45</DepartTime>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Address>123 Test Street</Address>      <Town>Testville</Town>      <County>Testshire</County>      <PostCode>TE12 3ST</PostCode>      <Email>test@test.com</Email>      <PriceCheckFlag>Y</PriceCheckFlag>      <PriceCheckPrice>50.05</PriceCheckPrice>      <CarColour>White</CarColour>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <Registration>TE17 STS</Registration>      <ReturnFlight>VIR19</ReturnFlight>      <Supplement>        <Code>HXOST1</Code>        <Date>2017-12-01</Date>        <Quantity>1</Quantity>      </Supplement>      <Supplement>        <Code>STNSFS</Code>        <Date>2017-12-01</Date>        <Adults>2</Adults>        <Children>1</Children>      </Supplement>      <v>1</v>    </Request>  </API_Header></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/parking/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-de-start-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Book Car Park - DE-Start method",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "Book Car Park - DE-Start methodCar Park Booking RequestMethodPOSTEndpointThe endpoint to use is:https://payment.holidayextras.com/legacy/carpark/CarParkCodeRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  StartCustomer      String      [0-9] 6 chars      Y      This will be assigned to you by your Account Manager during set up.              BusinessUnit      String      [0-9] 3 chars      Y      This will be assigned to you by your Account Manager during set up.              Operator      String      [A-Z] 3 chars      Y      This always defaults to BJT.              key      String      [A-Z] 10 chars      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      This is the same token used in the availability request.              ArrivalDate      Date      YYYY-MM-DD      Y      Date customer drops vehicle at car park.              ArrivalTime      Time      HHMM      Y      Time customer drops vehicle at car park.              DepartDate      Date      YYYY-MM-DD      Y      Date customer picks up vehicle from car park.              DepartTime      Time      HHMM      Y      Time customer picks up vehicle from car park.              Registration      String      [A-Z0-9] 15 chars      N §      Vehicle registration number.              CarMake      String      [A-Z0-9] 25 chars      N §      The make of the car, e.g Audi.              CarModel      String      [A-Z0-9] 25 chars      N §      The model of the car, e.g. A6.              CarColour      String      [A-Z] 25 chars      N §      The colour of the car, e.g. black.              Title      String      [0-9] 4 chars      Y      Title of lead passenger.              Initial      String      [A-Z] 1 chars      Y      Initial of lead passenger.              Surname      String      [A-Z] 20 chars      Y      Surname of lead passenger.              NumberOfPax      Integer      [0-9] 2 chars      Y      Number of passengers.              Remarks      String      [A-Z0-9] 60 chars      N      Any remarks the agent wishes to add to the booking. Please note, these are not passed through to the supplier.      NB: The fields required by the carpark are returned in the availability request, in the <RequestFlags> element.Request flagsWhen you receive the availability response, it will indicate which request flags are required to be sent as part of the booking request.The request flags differ depending on the product’s region and the supplier’s requirements. A summary is below, but please see the relevant sections in the availability endpoint documentation.PaymentThis existing integration does support direct encashment from retail customers. For more information please see the section on Payment.Car Park Booking ResponseThe car park booking response will confirm that a booking has been placed in our system.For a detailed explanation of the fields returned, please see below:            Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Booking/AgentComm      Commission you have earned from this booking.              CarDetails      Confirmation of the vehicle details that were sent in the booking request.              ClientDetails      Confirmation of the lead passenger’s details that were sent in the booking request.              HandlingFee      Any booking fees that are applicable for processing this transaction. Currently, we do not charge for processing bookings, so this figure will be zero.              MoreInfoURL      The URL for viewing the booking.              CarPark      Details of the car park that were sent in the booking request.              API_Header/Request      A list of parameters that were sent in the booking request.      Worked ExamplesBelow are worked examples of both the request and response for booking car parking using the DE-Start method.Car Park Booking Request - DE-Start methodhttps://payment.holidayextras.com/legacy/carpark/FRA8    <Request>        <StartCustomer>YourStartCustomer</StartCustomer>        <BusinessUnit>YourBusinessUnit</BusinessUnit>        <Operator>BJT</Operator>        <Initials>YourInitials</Initials>        <key>YourKey</key>        <token>YourToken</token>        <ArrivalDate>2017-12-01</ArrivalDate>        <ArrivalTime>1200</ArrivalTime>        <DepartDate>2017-12-08</DepartDate>        <DepartTime>1200</DepartTime>        <NumberOfPax>1</NumberOfPax>        <Registration>TE17 STS</Registration>        <CarMake>Range Rover</CarMake>        <CarModel>Evoque</CarModel>        <CarColour>White</CarColour>        <Title>MR</Title>        <Initial>T</Initial>        <Surname>TEST</Surname>        <Remarks>Car Park Test</Remarks>    </Request>Car Park Booking Response - DE-Start method<?xml version=\"1.0\"?><API_Reply Product=\"CarPark\" RequestCode=\"5\" Result=\"OK\">  <Booking>    <BookingRef>YourBookingRef</BookingRef>    <AgentComm>5.47-</AgentComm>    <VATonComm>0.87-</VATonComm>    <StartRef>YourStartRef</StartRef>  </Booking>  <CarDetails>    <Registration>TE17 STS</Registration>  </CarDetails>  <ClientDetails>    <Title>MR</Title>    <Initial>T</Initial>    <Surname>TEST</Surname>    <CustomerRef>N/A</CustomerRef>    <Remarks>Car Park Test</Remarks>  </ClientDetails>  <API_Header>    <Request>      <StartCustomer>YourStartCustomer</StartCustomer>      <BusinessUnit>YourBusinessUnit</BusinessUnit>      <Operator>BJT</Operator>      <Initials>YourInitials</Initials>      <key>YourKey</key>      <token>YourToken</token>      <ArrivalDate>2017-12-01</ArrivalDate>      <ArrivalTime>1200</ArrivalTime>      <DepartDate>2017-12-08</DepartDate>      <DepartTime>1200</DepartTime>      <NumberOfPax>1</NumberOfPax>      <Registration>TE17 STS</Registration>      <CarMake>Range Rover</CarMake>      <CarModel>Evoque</CarModel>      <CarColour>White</CarColour>      <Title>MR</Title>      <Initial>T</Initial>      <Surname>TEST</Surname>      <Remarks>Car Park Test</Remarks>      <debug>1</debug>      <system>de</system>      <System>ABG</System>    </Request>  </API_Header>  <CarPark>    <ArrivalDate>01DEC18</ArrivalDate>    <DepartDate>08DEC18</DepartDate>    <ArrivalTime>1200</ArrivalTime>    <DepartTime>1200</DepartTime>    <Duration>8</Duration>    <NumberOfPax>1</NumberOfPax>    <Code>FRA8</Code>    <BookingURL>/api/carpark/FRA8/debug</BookingURL>    <MoreInfoURL>/api/product/FRA8/debug</MoreInfoURL>  </CarPark></API_Reply>",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/de-start/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "hxapi-bundles": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Bundles",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "BundlesSome results that are returned from availability on the API will be what we call bundles, these consist of a main product, such as a hotel, bundled together with an additional supplement, like a dinner.Bundles are currently only available on hotel searches.AvailabilityBundles can be identified by their product code, which has an additional element preceding the main product code joined by a +.E.g...<Name>Cresta Court with 2-course dinner</Name><Code>MANCCT+B519</Code><BookingURL>/v1/hotel/HPMANCCT+B519</BookingURL><Price>110.65</Price>...The price given will be for the entire bundle including the supplement with the current passenger quantity ( determined by the given room code ).A product library request can be made with the complete bundle product code to get content related to the package as a whole instead of simply the main product. E.g /v1/product/MANCCT+B519BookingThe BookingURL element will contain the full product code, including prefix, that must be supplied when a bundle is to be booked, this will ensure that system books the main product as well as the appropriate supplement. When booking a bundle on a hotel search the quantity of the supplement will be determined by the given room occupancy in the Adults and Children fields.The booking response for a bundle booking will show the main product and the booked supplement as seperate elements. The TotalPrice field will contain the full price of the booking, but the supplement price will also be shown separately under the CurrentSupplements block.E.g...<Booking><BookingRef>XXXXX</BookingRef><AgentComm>12.41</AgentComm><VATonComm>2.07</VATonComm><MoreInfoURL>/v1/booking/XXXXX</MoreInfoURL></Booking><Hotel/><Itinerary><TotalPrice>110.65</TotalPrice><ArrivalDate>2019-03-10</ArrivalDate><Nights>1</Nights><BoardBasis>RO</BoardBasis><NonSmoking>N</NonSmoking><ReturnFlight/><TerminalCode/><Code>MANCCT</Code><Name/><ParkingDays>0</ParkingDays><ParkingSpaces>0</ParkingSpaces></Itinerary><Room><Adults>2</Adults><Children>1</Children><Infants>0</Infants><Code>TRL</Code></Room><CurrentSupplements><Code>MANCDI</Code><Name>2-course dinner</Name><Price>29.90</Price><NonDiscPrice>29.90</NonDiscPrice><Per>person</Per><Adults>2</Adults><Children>1</Children><Date>2019-03-10</Date><Canx>Y</Canx><Remarks/></CurrentSupplements>...The product code of the supplement will also be returned in the booking response which can be used to retrieve product specific content in the product library request that can be displayed on booking confirmations. When creating confirmation emails be sure to highlight that the supplement has been added as a part of this booking.Post BookingA bundle booking can be amended or cancelled following the same rules as a general product. The supplement has a Canx field in the booking response that will define if that particular add-on can be cancelled as part of the booking. It is not currently possible to amend the quantity of the supplement or remove it from the booking using the API.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -141,10 +141,10 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-transfers-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Transfers Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "Transfers Cancel BookingImportant Notes  Check cancellation fees first: Before cancelling, use the Cancellation Policy endpoint to check if the booking is cancellable and to see any applicable fees and refund amounts  This DELETE request will immediately cancel the booking - ensure you want to proceed before making the request  Cancellation fees and refund amounts will depend on the booking’s cancellation policy  Once cancelled, a booking cannot be uncancelled or modifiedCancel Booking RequestMethodDELETEEndpointThe endpoint to use is:https://api.holidayextras.com/v1/transfers/booking/[BookingRef]Where [BookingRef] is the booking reference you received when making the original booking.For example:https://api.holidayextras.com/v1/transfers/booking/TBBGNHMTRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              CancelRef      String      [A-Z0-9]      Y      Reference number for the cancellation provided by your system.      Cancel Booking ResponseIf the cancellation is successful, the response will contain booking and cancellation details including any fees and refund information.Note: The CancelFee in this response is a string formatted as currency (e.g., “10.50”), while the dedicated Cancellation Policy endpoint returns fee amounts as integers in pence/cents.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      Unique identifier for the transfer booking.              Booking/Status      Current status of the booking after cancellation (e.g., Cancelled).              Cancel/CancelFee      Fee charged for the cancellation, if applicable (string value in currency format, e.g., “10.50”).              Cancel/CancelRef      Reference number for the cancellation.              Cancel/CancelInfo      Information about the cancellation.              Cancel/RefundAmount      Amount refunded for the cancellation, if applicable (numeric value).      Example\tXML\tJSON\t<Booking>  <BookingRef>TBBGNHMT</BookingRef>  <Status>Cancelled</Status></Booking><Cancel>  <CancelFee>10.50</CancelFee>  <CancelRef>CANCEL123456</CancelRef>  <CancelInfo>Booking cancelled successfully</CancelInfo>  <RefundAmount>93.02</RefundAmount></Cancel>\t{  \"Booking\": {    \"BookingRef\": \"TBBGNHMT\",    \"Status\": \"Cancelled\"  },  \"Cancel\": {    \"CancelFee\": \"10.50\",    \"CancelRef\": \"CANCEL123456\",    \"CancelInfo\": \"Booking cancelled successfully\",    \"RefundAmount\": 93.02  }}Error ResponsesThe API will return error responses in the following scenarios:Already Cancelled Booking (409 Conflict)If the booking has already been cancelled and cannot be cancelled again:{  \"Code\": \"ConflictError\",  \"Message\": \"Booking has already been cancelled\"}Invalid Parameters (400 Bad Request)If required parameters are missing or malformed:{  \"Code\": \"ValidationError\",  \"Message\": \"Missing or invalid required parameter\"}Booking Not Found (404 Not Found)If no booking is found with the provided reference:{  \"Code\": \"NotFound\",  \"Message\": \"Booking not found with provided reference\"}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/transfers/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-viewamendcancel-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "Cancel BookingAPI Docs > product:cancelCancel Booking RequestCancelling a booking is a two-stage process:  Check if the booking is cancellable, and any charges for doing so, using the GET method outlined below;  Cancel the booking using the POST method outlined below.MethodGET / POSTEndpointThe endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):https://api.holidayextras.com/v1/booking/YourBookingRefRequest ParametersStep 1: Check if booking is cancellable (GET)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to N for this initial step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Step 2: Cancel booking (POST)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to Y for the cancellation step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Cancel Booking ResponseThe cancel booking response will confirm that a booking has been cancelled in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Cancel/RefundAmount      This shows the amount to be refunded to the customer.              API_Header/Request      A list of parameters that were sent in the booking request.      Credit Card FeesAs of 12th January 2018 we no longer charge credit card fees, in line with the Payment Services Directive (PSD2). This applies to both UK and EU products.Worked examplesBelow are worked examples of both the request and response for cancelling a booking.Cancel Booking Request - Step 1https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&ConfirmCancel=N&CancelRef=YourCancelRefCancel Booking Response - Step 1<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef/>        <CancelInfo>There is no charge for cancelling this booking</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>N</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancel Booking Request - Step 2https://api.holidayextras.com/v1/booking/YourBookingRef    <Request>        <ABTANumber>YourABTA</ABTANumber>        <Password>YourPassword</Password>        <Initials>YourInitials</Initials>        <key>YourKey</key>        <ConfirmCancel>Y</ConfirmCancel>        <CancelRef>YourCancelRef</CancelRef>    </Request>Cancel Booking Response - Step 2<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef>06684</CancelRef>        <CancelInfo>Please retrieve your client's copy of voucher as booking will be reinstated if used</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>Y</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancelling bookings made with a credit or debit cardA small number of agents in Europe pass through payment details in our API (for historic reasons). The method for cancelling these products differs slightly in that an extra parameter is required to authenticate against the booking. The extra parameter is identified below.            Name      Data Type      Format      Mandatory?      Additional Information              CreditCardLast4      Integer      [0-9] 4 chars      Y      These are the last 4 digits on the card that the customer used to make payment.      The cancellation request must be POSTed against the following endpoint:https://payment.holidayextras.com/legacy/",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/viewamendcancel/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -155,10 +155,10 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-viewamendcancel-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "Cancel BookingAPI Docs > product:cancelCancel Booking RequestCancelling a booking is a two-stage process:  Check if the booking is cancellable, and any charges for doing so, using the GET method outlined below;  Cancel the booking using the POST method outlined below.MethodGET / POSTEndpointThe endpoint to use is (where YourBookingRef is the Holiday Extras booking reference):https://api.holidayextras.com/v1/booking/YourBookingRefRequest ParametersStep 1: Check if booking is cancellable (GET)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to N for this initial step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Step 2: Cancel booking (POST)NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      N*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              Initials      String      [A-Z] 3 chars      N      The initials of the Operator / Agent.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              System      String      [A-Z] 3 chars      Y*      For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).              ConfirmCancel      String      1 chars      Y      Set this to Y for the cancellation step.              CancelRef      String      [A-Z0-9] 10 chars      Y      The reference for the cancellation, e.g. agent’s initials.      Cancel Booking ResponseThe cancel booking response will confirm that a booking has been cancelled in our system.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).              Cancel/RefundAmount      This shows the amount to be refunded to the customer.              API_Header/Request      A list of parameters that were sent in the booking request.      Credit Card FeesAs of 12th January 2018 we no longer charge credit card fees, in line with the Payment Services Directive (PSD2). This applies to both UK and EU products.Worked examplesBelow are worked examples of both the request and response for cancelling a booking.Cancel Booking Request - Step 1https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&ConfirmCancel=N&CancelRef=YourCancelRefCancel Booking Response - Step 1<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef/>        <CancelInfo>There is no charge for cancelling this booking</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>N</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancel Booking Request - Step 2https://api.holidayextras.com/v1/booking/YourBookingRef    <Request>        <ABTANumber>YourABTA</ABTANumber>        <Password>YourPassword</Password>        <Initials>YourInitials</Initials>        <key>YourKey</key>        <ConfirmCancel>Y</ConfirmCancel>        <CancelRef>YourCancelRef</CancelRef>    </Request>Cancel Booking Response - Step 2<?xml version=\"1.0\"?><API_Reply Result=\"OK\">    <Booking>        <BookingRef>YourBookingRef</BookingRef>    </Booking>    <Cancel>        <CancelFee>0.00</CancelFee>        <CancelRef>06684</CancelRef>        <CancelInfo>Please retrieve your client's copy of voucher as booking will be reinstated if used</CancelInfo>        <RefundAmount>35.92</RefundAmount>    </Cancel>    <API_Header>        <Request>            <ABTANumber>YourABTANumber</ABTANumber>            <Password>YourPassword</Password>            <key>YourKey</key>            <ConfirmCancel>Y</ConfirmCancel>            <CancelRef>YourCancelRef</CancelRef>            <v>1</v>        </Request>    </API_Header></API_Reply>Cancelling bookings made with a credit or debit cardA small number of agents in Europe pass through payment details in our API (for historic reasons). The method for cancelling these products differs slightly in that an extra parameter is required to authenticate against the booking. The extra parameter is identified below.            Name      Data Type      Format      Mandatory?      Additional Information              CreditCardLast4      Integer      [0-9] 4 chars      Y      These are the last 4 digits on the card that the customer used to make payment.      The cancellation request must be POSTed against the following endpoint:https://payment.holidayextras.com/legacy/",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/viewamendcancel/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-transfers-cancel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Transfers Cancel Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "Transfers Cancel BookingImportant Notes  Check cancellation fees first: Before cancelling, use the Cancellation Policy endpoint to check if the booking is cancellable and to see any applicable fees and refund amounts  This DELETE request will immediately cancel the booking - ensure you want to proceed before making the request  Cancellation fees and refund amounts will depend on the booking’s cancellation policy  Once cancelled, a booking cannot be uncancelled or modifiedCancel Booking RequestMethodDELETEEndpointThe endpoint to use is:https://api.holidayextras.com/v1/transfers/booking/[BookingRef]Where [BookingRef] is the booking reference you received when making the original booking.For example:https://api.holidayextras.com/v1/transfers/booking/TBBGNHMTRequest ParametersThe parameters must be sent in the body of the request, as x-www-form-urlencoded data.NB: All parameter names are case sensitive.            Name      Data Type      Format      Mandatory?      Additional Information                  ABTANumber      String      [A-Z0-9] 5 chars      Y      This is also known as an ‘agent code’. This will be confirmed to you by your Account Manager during set up.              Password      String      [A-Z0-9] 5 chars      Y*      Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.              key      String      [A-Z]      Y      This will be assigned to you by your Account Manager during set up.              token      String      [0-9] 9 chars      Y      Please see user token endpoint for details of how to generate a token.              CancelRef      String      [A-Z0-9]      Y      Reference number for the cancellation provided by your system.      Cancel Booking ResponseIf the cancellation is successful, the response will contain booking and cancellation details including any fees and refund information.Note: The CancelFee in this response is a string formatted as currency (e.g., “10.50”), while the dedicated Cancellation Policy endpoint returns fee amounts as integers in pence/cents.For a detailed explanation of the fields returned, please see below:            Field      Additional Information                  Booking/BookingRef      Unique identifier for the transfer booking.              Booking/Status      Current status of the booking after cancellation (e.g., Cancelled).              Cancel/CancelFee      Fee charged for the cancellation, if applicable (string value in currency format, e.g., “10.50”).              Cancel/CancelRef      Reference number for the cancellation.              Cancel/CancelInfo      Information about the cancellation.              Cancel/RefundAmount      Amount refunded for the cancellation, if applicable (numeric value).      Example\tXML\tJSON\t<Booking>  <BookingRef>TBBGNHMT</BookingRef>  <Status>Cancelled</Status></Booking><Cancel>  <CancelFee>10.50</CancelFee>  <CancelRef>CANCEL123456</CancelRef>  <CancelInfo>Booking cancelled successfully</CancelInfo>  <RefundAmount>93.02</RefundAmount></Cancel>\t{  \"Booking\": {    \"BookingRef\": \"TBBGNHMT\",    \"Status\": \"Cancelled\"  },  \"Cancel\": {    \"CancelFee\": \"10.50\",    \"CancelRef\": \"CANCEL123456\",    \"CancelInfo\": \"Booking cancelled successfully\",    \"RefundAmount\": 93.02  }}Error ResponsesThe API will return error responses in the following scenarios:Already Cancelled Booking (409 Conflict)If the booking has already been cancelled and cannot be cancelled again:{  \"Code\": \"ConflictError\",  \"Message\": \"Booking has already been cancelled\"}Invalid Parameters (400 Bad Request)If required parameters are missing or malformed:{  \"Code\": \"ValidationError\",  \"Message\": \"Missing or invalid required parameter\"}Booking Not Found (404 Not Found)If no booking is found with the provided reference:{  \"Code\": \"NotFound\",  \"Message\": \"Booking not found with provided reference\"}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/transfers/cancel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -225,94 +225,94 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-parking-av": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Carpark Endpoint",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Carpark Endpoint[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av)## /carpark/LocationOrCarParkCodeWhere `LocationOrCarParkCode` can be the location (Airport, Port etc) or a specific car park product code.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/parking/av/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-viewamendcancel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Manage A Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Manage A Booking[API Docs](/hxapi/) > product:[viewamendcancel](index)## Manage A Booking EndpointsHere are the endpoints for managing a booking:| View booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](view) | GET || Amend booking - Simple | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_simple) | POST || Amend booking - Complex | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_complex) | POST || Cancel booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](cancel) | POST |## Manage A Booking Top TipsThe three methods provided will enable your customers via your integration to manage their own booking online.### Amending a bookingWe allow both simple and complex amends:- A ***simple amend*** is where the booking details are updated, without affecting the price. This is also known as an \"amend no re-price\". For example, adding a car registration number to a parking booking.- A ***complex amend*** is where the booking details are updated and this does affect the price. This is also known as an \"amend re-price\". For example, changing the date of a booking.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/viewamendcancel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-parking": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Parking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Parking[API Docs](/hxapi/) > product:[Parking](index)## Parking EndpointsHere are the car parking specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/v1/carpark/AirportCode](av/airport)            | GET    | | Availability at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](av/carpark)            | GET    | | Make booking at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](bkg)                   | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck](priceCheck) | GET    |## Parking User JourneyBelow is a diagram detailing how the endpoints can be used to create a parking user journey. More information on each endpoint can be found in the detailed guides listed above. ![Image of Parking User Journey](/hxapi/parking/Parking_User_Journey.png)## Parking Top TipsWe have put together these top tips, which detail how to optimise your use of our API for providing parking to your customers.#### Merging Product Library data into availability responseTo save sending a separate `https` request for information from the Product Library, you can specify a comma-separated list of values to pull this information back with the availability request.Just specify a parameter named ``fields`` and include the Product Library field names there.For example:```&fields=field_a,field_b,field_c```Alternatively, the method for querying the product library as a separate request [is outlined here](/hxapi/productlibrary/index).#### Advance purchaseThere is a field in the Product Library for car parks, named ``advance_purchase``. Advance purchase products are non-refundable and non-cancellable. As a result, the Cancellation Waiver must not be sold to customers purchasing a product with ``advance_purchase`` set to 1.#### Request flagsThe request flags brought back from availability searches indicate the fields required in the booking by the car park. You *must* retrieve this information from the customer at the time of booking.There are occasions where your booking will go through without sending this information but can fail later when importing the bookings to car parks. This causes us considerable administrative difficulties and may result in your customer's booking being cancelled without notice.#### Good to go meet and greetNew product types which are amendable by dates and times but cannot be cancelled.  The response will return `CanAmendCantCancel` set to either 1 or 0.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/parking/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-hotel-av": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Hotel Availability Request",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "## Hotel Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/LocationCode```For example, for London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHR```If you know the specific hotel code, then you can request availability by entering that into the endpoint. For example, for the Hilton at London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRHIL```To find the airport locations available for hotels, please refer to the [locations endpoint.](/hxapi/locations)### Request ParametersNB: All parameter names are case sensitive.| Name           | Data Type | Format                                  | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                        ||----------------|-----------|-----------------------------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber     | String    | [A-Z0-9] 5 chars                        | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                               || Password       | String    | [A-Z0-9] 5 chars                        | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                               || Initials       | String    | [A-Z] 3 chars                           | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                         || key            | String    | [A-Z]                                   | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                           || token          | String    | [0-9] 9 chars                           | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                    || ArrivalDate    | Date      | YYYY-MM-DD                              | Y          | Date customer arrives at hotel.                                                                                                                                                                                                                                                                                                               || Nights         | Integer   | 1                                       | Y          | Number of nights the customer wants to stay in the hotel. NB: It is only possible to book one night stays.                                                                                                                                                                                                                                    || RoomType       | String    | [A-Z0-9] 3 chars                        | Y          | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes.                                                                                                                                                                                                                                                                             || SecondRoomType | String    | [A-Z0-9] 3 chars                        | N*         | NB: This feature is only available in the UK. This parameter is mandatory if the customer wishes to book two rooms at the same time. (Max 2 rooms) The room codes are as per RoomType.                                                                                                                                                || ParkingDays    | Integer   | [0-9] 2 chars                           | Y          | NB: The maximum duration accepted for ParkingDays is 30.                                                                                                                                                                                                                                                                                      || System         | String    | [A-Z] 3 chars                           | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                || lang           | String    | [A-Z] 2 chars                           | Y*         | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.)                                                                                                                                                                                                                                    || Terminal       | String    | [A-Z1-9] 1 char                         | N          | An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the [Terminal](/hxapi/terminal) request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). || fields         | String    | [A-Z] a csv list of product info fields | N          | A list of product info fields can be passed in to return configurable product information e.g. `fields=name,address,latitude,sellingpoint`.                                                                                                                                                                                                   |## Hotel Availability ResponseFor a detailed explanation of the fields returned, please see below:| Field                              | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                            ||------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Hotel/Name                         | The name of the product                                                                                                                                                                                                                                                                                                                                                                                                           || Hotel/Code                         | The product code                                                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/BookingURL                   | The URL to POST the booking request to for this particular product.                                                                                                                                                                                                                                                                                                                                                               || Hotel/MoreInfoURL                  | The link to more information about this product, sourced from the Product Library.                                                                                                                                                                                                                                                                                                                                                || Hotel/RequestFlags                 | These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request. Flags are only returned when required. The flags which can be returned are: `Registration`, `CarMake`, `CarModel`, `CarColour`, `OutFlight`, `ReturnFlight`, `OutTerminal`, `ReturnTerminal`, `Destination`, `MobileNum` || Hotel/Price                        | The price of product without any surcharges/fees added.                                                                                                                                                                                                                                                                                                                                                                           || Hotel/PriceWithSurcharge           | *NB: Please ignore this field - we no longer accept new agents sending payment details via our API.*                                                                                                                                                                                                                                                                                                                              || Hotel/Adults*                      | The maximum number of adults included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                      || Hotel/Children*                    | The maximum number of children included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                    || Hotel/RoomCode                     | *NB: Please ignore this field as it relates to internal systems.*                                                                                                                                                                                                                                                                                                                                                                 || Hotel/BoardBasis                   | *NB: Please ignore this field as it is no longer used and will be deprecated in future versions of the API.*                                                                                                                                                                                                                                                                                                                      || Hotel/ParkingDays                  | This returns the number of days parking available. NB: This may differ from the value requested, due to parking packages usually being set up in the system as either 4, 8 or 15 days.                                                                                                                                                                                                                                        || Hotel/NonDiscPrice                 | The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.                                                                                                                                                                                                                                                                                                                       || Hotel/CancellationFeeExceptions    | If the hotel has non-standard cancellation fees.                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/AmendmentFeeExceptions       | If the hotel has non-standard amendment fees.                                                                                                                                                                                                                                                                                                                                                                                     || Hotel/noncancellable_nonrefundable | Is this hotel noncancellable or non-refundable?                                                                                                                                                                                                                                                                                                                                                                                   || Hotel/parking_includes_arrival     | If parking during the customer's hotel stay included in their parking package                                                                                                                                                                                                                                                                                                                                                     || Hotel/CarPark                      | If your request included car parking, this is the car park code.                                                                                                                                                                                                                                                                                                                                                                  || Hotel/Filter                       | *NB: Please ignore this field as it is for internal use only.*                                                                                                                                                                                                                                                                                                                                                                    || Hotel/lead_time_cancellation       | This is the number of days before the booking starts that the product will switch from flexible to non-flexible.                                                                                                                                                                                                                                                                                                                  || API_Header/Request                 | The API returns every parameter and value you sent in the previous request.                                                                                                                                                                                                                                                                                                                                                       | \\* Where two rooms have been requested, these fields represent the total of adults and children across all rooms. Additional fields will show the individual room occupancy:  `FirstRoomAdults`, `FirstRoomChildren`, `SecondRoomAdults` and `SecondRoomChildren`.## Key Information on HotelsPlease read this section through carefully, as it contains useful information about restrictions on how hotels must be sold.### Advance purchaseAdvance purchase products are non-refundable and non-cancellable. As a result, Cancellation Waiver must *not* be sold to customers purchasing a product with `advance_purchase` set to 1.### Day Use OnlyThere is a field in the product library for hotels, named `day_use_only`. Day use products must not be sold to customers wishing to have an overnight stay where `day_use_only` is set to 1.### Parking Includes ArrivalIn order to establish whether the package includes parking for the night of the hotel stay the `parking_includes_arrival` field needs to be taken into account.Where this field is set to 0, this means the night of the hotel stay is not included as there is free overnight parking. Parking stay will start from the following day. Where it is set to 1, this means that parking starts from the date the customer checks into the hotel.### Mystery / Un-named ProductsThere are some hotels in which the name field will not provide the name of the hotel e.g `Mystery 4-star hotel`.  The name of these hotels should not be provided to the customer until the booking is made, along with other identifying details such as address, hotel images, restaurant names etc.### Lead time cancellationFlexible bookings become non flexible within a certain timeframe before the stay date ie booking turns non flexible within 30 days of stay.Scenario 1* Flexible booking made outside 60 days of stay.* Cancellation policy - only able to canx up to 30 days before stay date.* Booking is non flex within 30 days of stay date.Scenario 2* Flexible booking made inside 60 days of stay date.* Cancellation policy - only able to canx up to 3 days before stay date.* Booking is non flex within 3 days of stay date.## Worked ExamplesBelow are worked examples of both the requests and responses for hotel availability.### UK Hotel Availability Request - Room Only (zero days parking)```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=0```### UK Hotel Availability Response - Room Only (zero days parking)NB: This is a shortened example compiled from a full availability response.```xml            Mercure        LHRMEA        /v1/hotel/HPLHRMEA        /v1/product/LHRMEA                    1                45.00        45.90        2        1        TRL        RO        0        45.00        30        1        1        1                Thistle T5        LHRPAA        /v1/hotel/HPLHRPAA        /v1/product/LHRPAA                85.50        87.21        2        1        TRL        RO        0        85.50        30        1                    0                1                Hilton T5        LHRHLT        /v1/hotel/HPLHRHLT        /v1/product/LHRHLT                    1            1            1                99.00        100.98        2        1        TRL        RO        0        99.00                2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            0            1            ```### UK Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=8```### UK Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Mercure with Purple Parking Meet and Greet        LHRMPU        /v1/hotel/HPLHRMPU        /v1/product/LHRMPU                    1            1            1            1            1            1            1                129.00        131.58        2        1        TRL        RO        8        129.00        LHR5        LHR5                    1                        Thistle T5 with parking at the hotel and breakfast        LHRPAT        /v1/hotel/HPLHRPAT        /v1/product/LHRPAT                130.00        132.60        2        1        TRL        RO        8        130.00                    1            1            0                       Sheraton Skyline with parking at the hotel       LHRSKA       /v1/hotel/HPLHRSKA       /v1/product/LHRSKA              134.00       136.68       2       1       TRL       RO       8       134.00                  0                     2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            8            1            ```### European Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/MUC?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=D20&ParkingDays=8&System=ABG&lang=de```### European Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Schweigers Landgasthof        MUCLAN        /v1/hotel/FRMUCLAN        /v1/product/MUCLAN                120.00        NaN        2        0        DZ        F        15        120.00                Airporthotel Regent        MUCREG        /v1/hotel/FRMUCREG        /v1/product/MUCREG                97.00        NaN        2        0        DZ        F        15        97.00                  NH München Airport          MUCAST          /v1/hotel/FRMUCAST          /v1/product/MUCAST                    113.00          NaN          2          0          DZ          U          8          113.00                0.00        0.00        0.00                                TESTG            Redacted            mytestkey            generate            2017-12-01            1            D20            8            ABG            de            1            ```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/hotel/av/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-transfers-av": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Transfers Availability",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Transfers Availability## Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/search```Here is an example:```https://api.holidayextras.com/v1/transfers/search?token=[TOKEN]&key=[KEY]&ABTANumber=[ABTA]&FromDate=2020-08-01&FromTime=1000&ReturnDate=2020-08-07&ReturnTime=1730&PickUp=AGP&PickUpType=IATA&DropOff=85101062&DropOffType=TTI&OutFlight=U28605&ReturnFlight=U28602&Adults=2```### Request ParametersNB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                       ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                  || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                            || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                          || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                          || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                   || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                  || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                  || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                   || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.  || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                       || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                     || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                        || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                    || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                              || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                               || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                  || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                            || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                  || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines. || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                      || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                    || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                       || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                   || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                             || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                              || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                 || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                 || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                       || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                     || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                      || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                            || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                     |#### Dates and TimesIt's important to note that availability should be requested with accurate dates and times. A good scenario would be if an Airport Transfer is required, where the `PickUp` would be an Airport and the `DropOff` would be a Hotel. The `FromDate` and `FromTime` should be the flight arrival date and time. If a return transfer is requested, then the `ReturnDate` and `ReturnTime` should be the flight departure date and time, our system will calculate an estimated pickup time from the Hotel.## Availability ResponseIf availability has been found for the requested parameters, the response will contain a `Transfers` field with all the nested Transfers available. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                      | Additional Information                                                                                      ||----------------------------|-------------------------------------------------------------------------------------------------------------|| Transfers/Name             | The name of the Transfer.                                                                                   || Transfers/Code             | The product code for the transfer, which must be used in the booking request.                               || Transfers/BookingURL       | The URL to POST the booking request to for this particular product.                                         || Transfers/TotalPrice       | The total price of the Transfer/s.                                                                          || Transfers/NonDiscPrice     | If a discount has been applied, this is the total price before discount.                                    || Transfers/SalesCurrency    | Three character identifier for the sale currency to qualify the price.                                      || Transfers/Images/Src       | Link to a image for the product. Prefix with `https:`.                                                      || Transfers/Images/Alt       | The alt tag for the image.                                                                                  || Transfers/Category         | The category assigned to the Transfer/s, for the full list of categories [please see below](/hxapi/transfers/av/#transfer-categories). || Transfers/Disclaimer       | Depending on supplier and transfer type, the Disclaimer will contain pickup details.                        || Transfers/ProviderDetails  | Shows the providers name and rating (if applicable).                                                        || Transfers/Cancellation     | Shows the cancellation period before pickup date/time.                                                      || Transfers/VehicleDetails   | Details about the vehicle being used for the Transfer/s.                                                    || Transfers/OutboundTransfer | Details about the outbound transfer.                                                                        || Transfers/ReturnTransfer   | Details about the return transfer (This field will be `null` if no return was requested).                   || Transfers/PartnerOwnSupply | Product originates from partner’s own supply. Your account manager will confirm whether you should use this. || Transfers/SupplierCost     | Supplier cost for this transfer. Only available for selected products and requests.                     |#### [Transfer Categories](#transfer-categories)Here are the available categories which may be returned, there will only be one category assigned to each Transfer:- private_adapted_vehicle- private_car- private_coach- private_electric_car- private_excutive_car- private_executive_electric_car- private_helicopter- private_limousine- private_luxury_car- private_minibus- private_minivan- private_sea_plane- private_speed_boat- private_suv- private_water_taxi- shared_express_shuttle- shared_shuttle- shared_water_taxi### Example```json{    \"API_Reply\": {        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 1,            \"Result\": \"OK\",            \"cached\": true,            \"expires\": \"2020-07-21 15:20:14\"        },        \"Transfers\": [            {                \"ATTRIBUTES\": [],                \"Name\": \"Shuttle\",                \"Code\": \"TBHT39\",                \"BookingURL\": \"/v1/transfers/TBHT39.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 103.52,                \"NonDiscPrice\": 103.52,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"shared_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:30\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Speedy Shuttle\",                \"Code\": \"TBHT519\",                \"BookingURL\": \"/v1/transfers/TBHT519.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 134.8,                \"NonDiscPrice\": 134.8,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"speedy_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:45\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Car\",                \"Code\": \"TBHT43\",                \"BookingURL\": \"/v1/transfers/TBHT43.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 201.72,                \"NonDiscPrice\": 201.72,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_transfer\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Executive Car\",                \"Code\": \"TBHT18\",                \"BookingURL\": \"/v1/transfers/TBHT18.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 291.86,                \"NonDiscPrice\": 291.86,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_luxury.jpeg\",                        \"Alt\": \"private luxury\"                    }                ],                \"Category\": \"private_executive\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Minibus\",                \"Code\": \"TBHT2\",                \"BookingURL\": \"/v1/transfers/TBHT2.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 295.32,                \"NonDiscPrice\": 295.32,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_minibus\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 5,                    \"MaxCapacity\": 8,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 8,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            }        ],        \"Pricing\": {},        \"SepaID\": \"\",        \"API_Header\": {            \"Request\": {                \"ABTANumber\": \"YourABTANumber\",                \"Password\": \"YourPassword\",                \"Initials\": \"YourInitials\",                \"key\": \"YourKey\",                \"token\": \"YourToken\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1000,                \"ReturnDate\": \"2020-08-07\",                \"ReturnTime\": 1730,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"OutFlight\": \"U28605\",                \"ReturnFlight\": \"U28602\",                \"Adults\": 2,                \"v\": 1,                \"format\": \"js\"            }        }    }}```### Worked ExamplesBelow are some worked examples of both the request and response when requesting transfers availability.#### Airport to GIATA##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      GIATA      439771      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"GIATA\",        \"DropOff\": 439771,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to TTI##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      TTI      10147575      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"TTI\",        \"DropOff\": 10147575,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to Postal Address##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP          //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg      private standard        private_transfer                                                  72      100      0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      postal-address      Hotel Rural Castillo De Biar      Carretera de Banyeres      s/n      Biar      Alicante      03410      ES      -0.76832006      38.63852215      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 16:26:43\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [{          \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",          \"Alt\": \"private standard\"        }],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      }    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"postal-address\",        \"DropOffName\": \"Hotel Rural Castillo De Biar\",        \"DropOffAddress\": [          \"Carretera de Banyeres\",          \"s/n\"        ],        \"DropOffTown\": \" Biar\",        \"DropOffCounty\": \"Alicante\",        \"DropOffPostcode\": \"03410\",        \"DropOffCountryCode\": \"ES\",        \"DropOffLongitude\": -0.76832006,        \"DropOffLatitude\": 38.63852215,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/transfers/av/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-hotel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Hotels",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Hotels[API Docs](/hxapi/) > product:[Hotels](index)## Hotel EndpointsHere are the hotel specific endpoints: | Action                                     | Endpoint                                                                         | Method | | ------                                     | --------                                                                         | ------ | | Availability at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](av)            | GET    | | Make booking at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](bkg)           | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck](priceCheck) | GET    |Please note: All hotel requests include parking options of zero, 8 and 15 days parking. To make a request for a hotel only product, please select zero days parking.## Hotel User JourneyTo follow -",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/hotel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-transfers-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Transfers Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Transfers Booking## Booking Request### MethodPOST### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/[CODE]```Where ```[CODE]``` is the product code received in the availability request of the product you want to book.Here is an example for the following Availability response:```TBHT1169922/transfers/TBHT1169922...```Your Make Booking request will have the following URL: https://api.holidayextras.com/v1/transfers/TBHT1169922### Request ParametersThe parameters _must_ be sent in the body of the request, as `x-www-form-urlencoded` data.NB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   ||--------------------|-----------|------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                              || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                        || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                                      || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                                                                                                                                                                                                                                              || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                              || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                              || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                                || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                                                                                                                                                                                                                                              || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                        || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                             || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                               || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                                                                                                                                                                                                                                             || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                                                                                                                                                                                                                                             || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                        || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                 || Title              | String    | [A-Z]            | Y          | Title of lead passenger, an option from the [list of valid titles](/hxapi/reference/titles)                                                                                                                                                                                                                                                                                                                                                                                                                              || FirstName          | String    | [A-Z]            | Y          | The lead passenger's first name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || LastName           | String    | [A-Z]            | Y          | The lead passenger's last name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || Email              | String    | [A-Z] 50 chars   | Y          | The lead passenger's email address.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || DayPhone           | Integer   | [0-9] 20 chars   | Y          | The lead passenger's contact telephone number.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || Price              | Float     | [0-9]            | Y          | The total price of the Transfer/s (This will be the value of the `TotalPrice` property returned in the availability response).                                                                                                                                                                                                                                                                                                                                                                                           || PriceCheckFlag     | String    | Y/N              | N          | Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.         || PriceCheckPrice    | Float     | [0-9]            | N          | Price of the product, received from the availability request or price check.  Only required when `PriceCheckFlag` is `Y`                                                                                                                                                                                                                                                                                                                                                                                                 |#### PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers' payment details being passed to us via the API. Further details can be found in our section on [Payment](/hxapi/payment).Please contact your Account Manager if you have any questions concerning payment.## Booking ResponseIf the booking has been successful, the response will contain a `Booking` field which will have a `BookingRef` property. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                                     | Additional Information                                                                                                                                     ||-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                        | The reference for the booking, use this reference in all communication with us relating to this booking.                                                   || Booking/AgentComm                         | Commission earned from this booking.                                                                                                                       || Booking/MoreInfoURL                       | The URL to GET more information about the booking (view [View Booking Request](../view) for more information).                        || Booking/Status (Future)                   | Indicates the current status of the booking (`Pending`, `Confirmed`, `Cancelled`, or `Error`).                                                             || Booking/SuggestedPollingInterval (Future) | Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier. |### Example```json{    \"API_Reply\": {        \"Booking\": {            \"BookingRef\": \"TBBGNHMT\",            \"AgentComm\": \"0.17\",            \"VATonComm\": \"0.00\",            \"MoreInfoURL\": \"/v1/booking/TBBGNHMT.js\",            \"Status\": \"Pending\",            \"SuggestedPollingInterval\": 3600        },        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 5,            \"Result\": \"OK\"        },        \"API_Header\": {            \"Request\": {                \"key\": \"TEST\",                \"token\": \"d2d6dedd-606f-4f00-aa8c-526a358e927c\",                \"ABTANumber\": \"TESTL\",                \"Password\": \"Redacted\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1255,                \"ReturnDate\": \"2020-08-10\",                \"ReturnTime\": 1355,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"Adults\": 2,                \"Title\": \"MR\",                \"FirstName\": \"Test\",                \"LastName\": \"Test\",                \"Email\": \"test@holidayextras.com\",                \"DayPhone\": \"07123456789\",                \"Price\": 103.52,                \"OutFlight\": \"LS1405\",                \"ReturnFlight\": \"LS1406\",                \"v\": 1,                \"format\": \"js\"            }        }    }}```[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/transfers/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-lounge": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Lounge",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# LoungeHere are the lounge specific endpoints:| Request | Endpoint | Method || --- | --- | --- || Availability of lounges at airport | [https://api.holidayextras.com/v1/lounge/AirportCode](av/airport) | GET || Make booking for lounge | [https://api.holidayextras.com/v1/lounge/LoungeCode](bkg) | POST |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/lounge/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-transfers": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Transfers",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Transfers[API Docs](/hxapi/) > product:[Transfers](index)## Transfer EndpointsWhen using the Transfer endpoints below, you will be able to search using various types of location data which will represent the transfers pickup and dropoff points. Currently, the API will accept IATA Codes, TTI Codes and Postcodes (Postcodes can be used for UK Transfers).You will need a token to call the api. To get the user token use the existing endpoint: [Get Token](https://docs.holidayextras.co.uk/hxapi/usertoken/).For the complete API specification, see the [OpenAPI schema](https://api.holidayextras.com/v1/transfers/openapi.yml). | Action                     | Endpoint                                                                     | Method | | ------                     | --------                                                                     | ------ | | Availability               | [https://api.holidayextras.com/v1/transfers/search](av)                    | GET    | | Make Booking               | [https://api.holidayextras.com/v1/transfers/[TransferCode]](bkg)           | POST   | | View Booking               | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](view)    | GET    | | Cancel Booking             | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](cancel)  | DELETE | | Cancellation Policy        | [https://api.holidayextras.com/v1/transfers/[BookingRef]/cancellation-policy](cancellation-policy) | GET    | | Amend Booking              | not supported                                                                |   -    |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/transfers/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-carhire": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Car Hire",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Car Hire[API Docs](/hxapi/) > product:[Car Hire](index)These are the car hire requests.| Action | Endpoint | Method || --- | --- | --- || Lookup Locations | [https://api.holidayextras.com/v1/carHire/locations](locations) | GET || Availability | [https://api.holidayextras.com/v1/carHire/products](availability) | GET || Make Booking | [https://api.holidayextras.com/v1/carHire/](booking/make) | POST || Lookup Booking | [https://api.holidayextras.com/v1/carHire-booking/](booking/lookup) | GET |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/carhire/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-productlibrary": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Product Library",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Product LibraryThe data returned from a Product Library request depends on the type of product you ask for. A request for a car park returns different fields than a request for a hotel.By default, only fields that contain a value are returned.You can specify the fields you want returned. Simply add the parameter fields and specify the field names. An error/warning element will be returned for any fields which do not exist, but the request will still return those elements for which there is a value. If you request a valid field, but there is no value, it will not be returned.The purpose of most of the fields should be self-explanatory. If there is anything you do not understand, please email . There are no guarantees about the types of data returned, you should make no assumptions about a specific field being an integer etc.Data returned should not be cached locally for periods of time greater than one day (24 hours).### URL/product/{productCode}### MethodGET### Parameters| Name   | Format | Required ||--------|--------|----------|| token  | String | N        || key    | String | Y        || fields | String | N        |## Available FieldsThe available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.{% codetabs %}{% codetab Parking %}{% include_relative _parkingFields.md %}{% endcodetab %}{% codetab Hotel room only %}{% include_relative _hotelOnlyFields.md %}{% endcodetab %}{% codetab Hotel with parking %}{% include_relative _hotelParkingFields.md %}{% endcodetab %}{% codetab Lounge %}{% include_relative _loungeFields.md %}{% endcodetab %}{% codetab Fast track %}{% include_relative _fastTrackFields.md %}{% endcodetab %}{% endcodetabs %}---## Examples### Example 1 - Default Response#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_1.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_1.json %}```{% endcodetab %}{% endcodetabs %}---### Example 2 - Restricted field list#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_2.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_2.json %}```{% endcodetab %}{% endcodetabs %}---### Example 3 - German Parking Request#### RequestRequests for German products return a different set of fields. Explanation of fields not currently available.{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_3.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_3.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/productlibrary/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-parking-av": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Carpark Endpoint",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Carpark Endpoint[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av)## /carpark/LocationOrCarParkCodeWhere `LocationOrCarParkCode` can be the location (Airport, Port etc) or a specific car park product code.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/parking/av/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-de-start": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "DE-Start",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# DE-StartThis documentation relates to an existing partner integration - it is NOT to be used or considered for any new partner integrations. The documentation relates to parking products only.## DE-Start EndpointsHere are the DE-Start specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/de-start/v1/carpark/AirportCode](/hxapi/de-start/airport)| GET    | | Booking at car park | [https://api.holidayextras.com/de-start/v1/carpark/CarParkCode](/hxapi/de-start/bkg)| POST   | | Cancel booking | [https://api.holidayextras.com/de-start/v1/booking/YourBookingRef](/hxapi/de-start/cancel)| GET / POST   |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/de-start/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-parking": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Parking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Parking[API Docs](/hxapi/) > product:[Parking](index)## Parking EndpointsHere are the car parking specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/v1/carpark/AirportCode](av/airport)            | GET    | | Availability at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](av/carpark)            | GET    | | Make booking at car park | [https://api.holidayextras.com/v1/carpark/CarParkCode](bkg)                   | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck](priceCheck) | GET    |## Parking User JourneyBelow is a diagram detailing how the endpoints can be used to create a parking user journey. More information on each endpoint can be found in the detailed guides listed above. ![Image of Parking User Journey](/hxapi/parking/Parking_User_Journey.png)## Parking Top TipsWe have put together these top tips, which detail how to optimise your use of our API for providing parking to your customers.#### Merging Product Library data into availability responseTo save sending a separate `https` request for information from the Product Library, you can specify a comma-separated list of values to pull this information back with the availability request.Just specify a parameter named ``fields`` and include the Product Library field names there.For example:```&fields=field_a,field_b,field_c```Alternatively, the method for querying the product library as a separate request [is outlined here](/hxapi/productlibrary/index).#### Advance purchaseThere is a field in the Product Library for car parks, named ``advance_purchase``. Advance purchase products are non-refundable and non-cancellable. As a result, the Cancellation Waiver must not be sold to customers purchasing a product with ``advance_purchase`` set to 1.#### Request flagsThe request flags brought back from availability searches indicate the fields required in the booking by the car park. You *must* retrieve this information from the customer at the time of booking.There are occasions where your booking will go through without sending this information but can fail later when importing the bookings to car parks. This causes us considerable administrative difficulties and may result in your customer's booking being cancelled without notice.#### Good to go meet and greetNew product types which are amendable by dates and times but cannot be cancelled.  The response will return `CanAmendCantCancel` set to either 1 or 0.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/parking/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-hotel-av": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Hotel Availability Request",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "## Hotel Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/LocationCode```For example, for London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHR```If you know the specific hotel code, then you can request availability by entering that into the endpoint. For example, for the Hilton at London Heathrow the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRHIL```To find the airport locations available for hotels, please refer to the [locations endpoint.](/hxapi/locations)### Request ParametersNB: All parameter names are case sensitive.| Name           | Data Type | Format                                  | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                        ||----------------|-----------|-----------------------------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber     | String    | [A-Z0-9] 5 chars                        | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                               || Password       | String    | [A-Z0-9] 5 chars                        | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                               || Initials       | String    | [A-Z] 3 chars                           | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                         || key            | String    | [A-Z]                                   | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                           || token          | String    | [0-9] 9 chars                           | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                    || ArrivalDate    | Date      | YYYY-MM-DD                              | Y          | Date customer arrives at hotel.                                                                                                                                                                                                                                                                                                               || Nights         | Integer   | 1                                       | Y          | Number of nights the customer wants to stay in the hotel. NB: It is only possible to book one night stays.                                                                                                                                                                                                                                    || RoomType       | String    | [A-Z0-9] 3 chars                        | Y          | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes.                                                                                                                                                                                                                                                                             || SecondRoomType | String    | [A-Z0-9] 3 chars                        | N*         | NB: This feature is only available in the UK. This parameter is mandatory if the customer wishes to book two rooms at the same time. (Max 2 rooms) The room codes are as per RoomType.                                                                                                                                                || ParkingDays    | Integer   | [0-9] 2 chars                           | Y          | NB: The maximum duration accepted for ParkingDays is 30.                                                                                                                                                                                                                                                                                      || System         | String    | [A-Z] 3 chars                           | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                || lang           | String    | [A-Z] 2 chars                           | Y*         | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.)                                                                                                                                                                                                                                    || Terminal       | String    | [A-Z1-9] 1 char                         | N          | An optional field when requesting hotel and parking that will filter the availble results to those that serve the given terminal. Terminal options can be found using the [Terminal](/hxapi/terminal) request, where the name of the terminal is a word only the first character is needed for this request ( eg. N for the North terminal ). || fields         | String    | [A-Z] a csv list of product info fields | N          | A list of product info fields can be passed in to return configurable product information e.g. `fields=name,address,latitude,sellingpoint`.                                                                                                                                                                                                   |## Hotel Availability ResponseFor a detailed explanation of the fields returned, please see below:| Field                              | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                            ||------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Hotel/Name                         | The name of the product                                                                                                                                                                                                                                                                                                                                                                                                           || Hotel/Code                         | The product code                                                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/BookingURL                   | The URL to POST the booking request to for this particular product.                                                                                                                                                                                                                                                                                                                                                               || Hotel/MoreInfoURL                  | The link to more information about this product, sourced from the Product Library.                                                                                                                                                                                                                                                                                                                                                || Hotel/RequestFlags                 | These flags list which details the car park operator requires from the customer. If a flag is returned with a ‘Y’ your application should send the corresponding field/value in the booking request. Flags are only returned when required. The flags which can be returned are: `Registration`, `CarMake`, `CarModel`, `CarColour`, `OutFlight`, `ReturnFlight`, `OutTerminal`, `ReturnTerminal`, `Destination`, `MobileNum` || Hotel/Price                        | The price of product without any surcharges/fees added.                                                                                                                                                                                                                                                                                                                                                                           || Hotel/PriceWithSurcharge           | *NB: Please ignore this field - we no longer accept new agents sending payment details via our API.*                                                                                                                                                                                                                                                                                                                              || Hotel/Adults*                      | The maximum number of adults included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                      || Hotel/Children*                    | The maximum number of children included in the room occupancy.                                                                                                                                                                                                                                                                                                                                                                    || Hotel/RoomCode                     | *NB: Please ignore this field as it relates to internal systems.*                                                                                                                                                                                                                                                                                                                                                                 || Hotel/BoardBasis                   | *NB: Please ignore this field as it is no longer used and will be deprecated in future versions of the API.*                                                                                                                                                                                                                                                                                                                      || Hotel/ParkingDays                  | This returns the number of days parking available. NB: This may differ from the value requested, due to parking packages usually being set up in the system as either 4, 8 or 15 days.                                                                                                                                                                                                                                        || Hotel/NonDiscPrice                 | The non discounted price. Some agent codes apply a discount so we return this field to enable a comparison.                                                                                                                                                                                                                                                                                                                       || Hotel/CancellationFeeExceptions    | If the hotel has non-standard cancellation fees.                                                                                                                                                                                                                                                                                                                                                                                  || Hotel/AmendmentFeeExceptions       | If the hotel has non-standard amendment fees.                                                                                                                                                                                                                                                                                                                                                                                     || Hotel/noncancellable_nonrefundable | Is this hotel noncancellable or non-refundable?                                                                                                                                                                                                                                                                                                                                                                                   || Hotel/parking_includes_arrival     | If parking during the customer's hotel stay included in their parking package                                                                                                                                                                                                                                                                                                                                                     || Hotel/CarPark                      | If your request included car parking, this is the car park code.                                                                                                                                                                                                                                                                                                                                                                  || Hotel/Filter                       | *NB: Please ignore this field as it is for internal use only.*                                                                                                                                                                                                                                                                                                                                                                    || Hotel/lead_time_cancellation       | This is the number of days before the booking starts that the product will switch from flexible to non-flexible.                                                                                                                                                                                                                                                                                                                  || API_Header/Request                 | The API returns every parameter and value you sent in the previous request.                                                                                                                                                                                                                                                                                                                                                       | \\* Where two rooms have been requested, these fields represent the total of adults and children across all rooms. Additional fields will show the individual room occupancy:  `FirstRoomAdults`, `FirstRoomChildren`, `SecondRoomAdults` and `SecondRoomChildren`.## Key Information on HotelsPlease read this section through carefully, as it contains useful information about restrictions on how hotels must be sold.### Advance purchaseAdvance purchase products are non-refundable and non-cancellable. As a result, Cancellation Waiver must *not* be sold to customers purchasing a product with `advance_purchase` set to 1.### Day Use OnlyThere is a field in the product library for hotels, named `day_use_only`. Day use products must not be sold to customers wishing to have an overnight stay where `day_use_only` is set to 1.### Parking Includes ArrivalIn order to establish whether the package includes parking for the night of the hotel stay the `parking_includes_arrival` field needs to be taken into account.Where this field is set to 0, this means the night of the hotel stay is not included as there is free overnight parking. Parking stay will start from the following day. Where it is set to 1, this means that parking starts from the date the customer checks into the hotel.### Mystery / Un-named ProductsThere are some hotels in which the name field will not provide the name of the hotel e.g `Mystery 4-star hotel`.  The name of these hotels should not be provided to the customer until the booking is made, along with other identifying details such as address, hotel images, restaurant names etc.### Lead time cancellationFlexible bookings become non flexible within a certain timeframe before the stay date ie booking turns non flexible within 30 days of stay.Scenario 1* Flexible booking made outside 60 days of stay.* Cancellation policy - only able to canx up to 30 days before stay date.* Booking is non flex within 30 days of stay date.Scenario 2* Flexible booking made inside 60 days of stay date.* Cancellation policy - only able to canx up to 3 days before stay date.* Booking is non flex within 3 days of stay date.## Worked ExamplesBelow are worked examples of both the requests and responses for hotel availability.### UK Hotel Availability Request - Room Only (zero days parking)```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=0```### UK Hotel Availability Response - Room Only (zero days parking)NB: This is a shortened example compiled from a full availability response.```xml            Mercure        LHRMEA        /v1/hotel/HPLHRMEA        /v1/product/LHRMEA                    1                45.00        45.90        2        1        TRL        RO        0        45.00        30        1        1        1                Thistle T5        LHRPAA        /v1/hotel/HPLHRPAA        /v1/product/LHRPAA                85.50        87.21        2        1        TRL        RO        0        85.50        30        1                    0                1                Hilton T5        LHRHLT        /v1/hotel/HPLHRHLT        /v1/product/LHRHLT                    1            1            1                99.00        100.98        2        1        TRL        RO        0        99.00                2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            0            1            ```### UK Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/LHR?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=T21&ParkingDays=8```### UK Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Mercure with Purple Parking Meet and Greet        LHRMPU        /v1/hotel/HPLHRMPU        /v1/product/LHRMPU                    1            1            1            1            1            1            1                129.00        131.58        2        1        TRL        RO        8        129.00        LHR5        LHR5                    1                        Thistle T5 with parking at the hotel and breakfast        LHRPAT        /v1/hotel/HPLHRPAT        /v1/product/LHRPAT                130.00        132.60        2        1        TRL        RO        8        130.00                    1            1            0                       Sheraton Skyline with parking at the hotel       LHRSKA       /v1/hotel/HPLHRSKA       /v1/product/LHRSKA              134.00       136.68       2       1       TRL       RO       8       134.00                  0                     2.00        0.00        4.00        0.00        0.00        0.00        2.99                                YourABTANumber            YourPassword            YourKey            YourToken            2017-12-01            1            T21            8            1            ```### European Hotel Availability Request - Room with Parking```https://api.holidayextras.com/v1/hotel/MUC?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2017-12-01&Nights=1&RoomType=D20&ParkingDays=8&System=ABG&lang=de```### European Hotel Availability Response - Room with ParkingNB: This is a shortened example compiled from a full availability response.```xml            Schweigers Landgasthof        MUCLAN        /v1/hotel/FRMUCLAN        /v1/product/MUCLAN                120.00        NaN        2        0        DZ        F        15        120.00                Airporthotel Regent        MUCREG        /v1/hotel/FRMUCREG        /v1/product/MUCREG                97.00        NaN        2        0        DZ        F        15        97.00                  NH München Airport          MUCAST          /v1/hotel/FRMUCAST          /v1/product/MUCAST                    113.00          NaN          2          0          DZ          U          8          113.00                0.00        0.00        0.00                                TESTG            Redacted            mytestkey            generate            2017-12-01            1            D20            8            ABG            de            1            ```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/hotel/av/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-upgrade": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Product Upgrades",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Product Upgrades[API Docs](/hxapi/) > [Product Upgrades](/hxapi/upgrade)## Upgrades Availability RequestUpgrades are currently only supported for parking, hotel and lounge bookings. Upgrades can be requested on a per product basis.#### MethodGET#### Endpoint/upgrade/{productCode}NB: Where `productCode` is the code of the base product i.e. the parking/hotel/lounge etc. product.```https://api.holidayextras.com/v1/upgrade/LGV4```## Request Parameters| Name        | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                          ||-------------|-----------|------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber  | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                 || Password    | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials    | String    | [A-Z] 3 chars    | N          | The initials of the Operator / Agent.                                                                                                                           || key         | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                             || token       | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                      || ArrivalDate | String    | YYYY-MM-DD       | Y          | This should be the same as the `ArrivalDate` from the base product request.                                                                                     || ArrivalTime | Time      | HHMM             | Y          | This should be the same as the `ArrivalTime` from the base product request.                                                                                     || DepartDate  | Date      | YYYY-MM-DD       | N          | This should be the same as the `DepartDate` from the base product request.                                                                                      || DepartTime  | Time      | HHMM             | N          | This should be the same as the `DepartTime` from the base product request.                                                                                      || Adults      | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of adults in the party                                                                                            || Children    | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of children in the party                                                                                          |## Upgrade Availability ResponseThe response will return a list of available upgrades.Upgrades are sold on a per booking, per person, or per room basis.Upgrades can be for the day before travel, day of departure or day of return.| Field              | Additional Information                                                                      ||--------------------|---------------------------------------------------------------------------------------------|| Code               | Product code for the upgrade                                                                || Name               | Name of the upgrade                                                                         || Per                | Pricing basis, either per *P*erson, per *B*ooking, per *R*oom                               || Canx               | Whether the upgrade is cancellable (Y/N)                                                    || description        |                                                                                             || supplement_type    | Type classification for the upgrade                                                         || Date               | Date the upgrade is to be booked for. Format YYYY-MM-DD                                     || only_for_adults    | Upgrades restricted to adult only parties e.g. Adult only lounges                           || Price              | The price of the upgrade minus any discounts. Only present for per booking upgrades         || NonDiscPrice       | The total price of the upgrade before discounts. Only present for per booking upgrades      || DiscAmt            | The amount of any discount applied. Only present for per booking upgrades                   || AdPrice            | The per adult price minus any discounts. Only present for per person upgrades               || NonDiscAdPrice     | The per adult price before any discounts. Only present for per person upgrades              || AdDiscAmt          | The amount of discount applied to the per adult price. Only present for per person upgrades || ChPrice            | The per child price minus any discounts. Only present for per person upgrades               || NonDiscChPrice     | The per child price before any discounts. Only present for per person upgrades              || ChDiscAmt          | The amount of discount applied to the child price. Only present for per person upgrades     || API_Header/Request | The API returns every parameter and value you sent in the request.                          |## Examples### Example 1 - Carpark Upgrades#### Request{% codetabs %}  {% codetab XML %}  ```https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45  ```  {% endcodetab %}  {% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/STN5.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```  {% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_1_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_1_response.json %}```{% endcodetab %}{% endcodetabs %}### Example 1 - Hotel Upgrades#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/LGWSOF.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_2_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_2_response.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/upgrade/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-hotel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Hotels",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Hotels[API Docs](/hxapi/) > product:[Hotels](index)## Hotel EndpointsHere are the hotel specific endpoints: | Action                                     | Endpoint                                                                         | Method | | ------                                     | --------                                                                         | ------ | | Availability at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](av)            | GET    | | Make booking at hotel      | [https://api.holidayextras.com/v1/hotel/LocationCode](bkg)           | POST   | | Pre-booking price check  | [https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck](priceCheck) | GET    |Please note: All hotel requests include parking options of zero, 8 and 15 days parking. To make a request for a hotel only product, please select zero days parking.## Hotel User JourneyTo follow -",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/hotel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-de-start": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "DE-Start",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# DE-StartThis documentation relates to an existing partner integration - it is NOT to be used or considered for any new partner integrations. The documentation relates to parking products only.## DE-Start EndpointsHere are the DE-Start specific endpoints: | Request | Endpoint | Method | | ------ | -------- | ------ | | Availability at airport  | [https://api.holidayextras.com/de-start/v1/carpark/AirportCode](/hxapi/de-start/airport)| GET    | | Booking at car park | [https://api.holidayextras.com/de-start/v1/carpark/CarParkCode](/hxapi/de-start/bkg)| POST   | | Cancel booking | [https://api.holidayextras.com/de-start/v1/booking/YourBookingRef](/hxapi/de-start/cancel)| GET / POST   |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/de-start/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-lounge": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Lounge",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# LoungeHere are the lounge specific endpoints:| Request | Endpoint | Method || --- | --- | --- || Availability of lounges at airport | [https://api.holidayextras.com/v1/lounge/AirportCode](av/airport) | GET || Make booking for lounge | [https://api.holidayextras.com/v1/lounge/LoungeCode](bkg) | POST |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/lounge/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-productlibrary": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Product Library",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Product LibraryThe data returned from a Product Library request depends on the type of product you ask for. A request for a car park returns different fields than a request for a hotel.By default, only fields that contain a value are returned.You can specify the fields you want returned. Simply add the parameter fields and specify the field names. An error/warning element will be returned for any fields which do not exist, but the request will still return those elements for which there is a value. If you request a valid field, but there is no value, it will not be returned.The purpose of most of the fields should be self-explanatory. If there is anything you do not understand, please email . There are no guarantees about the types of data returned, you should make no assumptions about a specific field being an integer etc.Data returned should not be cached locally for periods of time greater than one day (24 hours).### URL/product/{productCode}### MethodGET### Parameters| Name   | Format | Required ||--------|--------|----------|| token  | String | N        || key    | String | Y        || fields | String | N        |## Available FieldsThe available fields vary by product type. For each product type there is a recommended list of fields which should be requested to get the information required to effectively sell the product.{% codetabs %}{% codetab Parking %}{% include_relative _parkingFields.md %}{% endcodetab %}{% codetab Hotel room only %}{% include_relative _hotelOnlyFields.md %}{% endcodetab %}{% codetab Hotel with parking %}{% include_relative _hotelParkingFields.md %}{% endcodetab %}{% codetab Lounge %}{% include_relative _loungeFields.md %}{% endcodetab %}{% codetab Fast track %}{% include_relative _fastTrackFields.md %}{% endcodetab %}{% endcodetabs %}---## Examples### Example 1 - Default Response#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_1.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_1.json %}```{% endcodetab %}{% endcodetabs %}---### Example 2 - Restricted field list#### Request{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite?token=000015778&key=mytestkey&fields=name,longitude,latitude```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/LGW4/lite.js?token=000015778&key=mytestkey&fields=name,longitude,latitude```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_2.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_2.json %}```{% endcodetab %}{% endcodetabs %}---### Example 3 - German Parking Request#### RequestRequests for German products return a different set of fields. Explanation of fields not currently available.{% codetabs %}{% codetab Live (XML) %}```https://api.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Live (JSON) %}```https://api.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% codetab Sandbox (XML) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0?key=mytestkey```{% endcodetab %}{% codetab Sandbox (JSON) %}```https://api-sandbox.holidayextras.com/v1/product/FRA0.js?key=mytestkey```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative _examples/parking_reply_3.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative _examples/parking_reply_3.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/productlibrary/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-viewamendcancel": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Manage A Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Manage A Booking[API Docs](/hxapi/) > product:[viewamendcancel](index)## Manage A Booking EndpointsHere are the endpoints for managing a booking:| View booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](view) | GET || Amend booking - Simple | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_simple) | POST || Amend booking - Complex | [https://api.holidayextras.com/v1/booking/YourBookingRef](amend_complex) | POST || Cancel booking | [https://api.holidayextras.com/v1/booking/YourBookingRef](cancel) | POST |## Manage A Booking Top TipsThe three methods provided will enable your customers via your integration to manage their own booking online.### Amending a bookingWe allow both simple and complex amends:- A ***simple amend*** is where the booking details are updated, without affecting the price. This is also known as an \"amend no re-price\". For example, adding a car registration number to a parking booking.- A ***complex amend*** is where the booking details are updated and this does affect the price. This is also known as an \"amend re-price\". For example, changing the date of a booking.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/viewamendcancel/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-transfers-av": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Transfers Availability",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Transfers Availability## Availability Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/search```Here is an example:```https://api.holidayextras.com/v1/transfers/search?token=[TOKEN]&key=[KEY]&ABTANumber=[ABTA]&FromDate=2020-08-01&FromTime=1000&ReturnDate=2020-08-07&ReturnTime=1730&PickUp=AGP&PickUpType=IATA&DropOff=85101062&DropOffType=TTI&OutFlight=U28605&ReturnFlight=U28602&Adults=2```### Request ParametersNB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                       ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                  || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                            || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                          || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                          || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                   || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                  || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                  || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                   || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.  || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                       || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                     || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                        || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                    || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                              || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                               || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                  || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                            || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                  || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines. || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                      || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                    || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                       || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                   || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                             || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                              || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                 || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                 || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                        || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                       || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                     || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                      || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                            || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                     |#### Dates and TimesIt's important to note that availability should be requested with accurate dates and times. A good scenario would be if an Airport Transfer is required, where the `PickUp` would be an Airport and the `DropOff` would be a Hotel. The `FromDate` and `FromTime` should be the flight arrival date and time. If a return transfer is requested, then the `ReturnDate` and `ReturnTime` should be the flight departure date and time, our system will calculate an estimated pickup time from the Hotel.## Availability ResponseIf availability has been found for the requested parameters, the response will contain a `Transfers` field with all the nested Transfers available. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                      | Additional Information                                                                                      ||----------------------------|-------------------------------------------------------------------------------------------------------------|| Transfers/Name             | The name of the Transfer.                                                                                   || Transfers/Code             | The product code for the transfer, which must be used in the booking request.                               || Transfers/BookingURL       | The URL to POST the booking request to for this particular product.                                         || Transfers/TotalPrice       | The total price of the Transfer/s.                                                                          || Transfers/NonDiscPrice     | If a discount has been applied, this is the total price before discount.                                    || Transfers/SalesCurrency    | Three character identifier for the sale currency to qualify the price.                                      || Transfers/Images/Src       | Link to a image for the product. Prefix with `https:`.                                                      || Transfers/Images/Alt       | The alt tag for the image.                                                                                  || Transfers/Category         | The category assigned to the Transfer/s, for the full list of categories [please see below](/hxapi/transfers/av/#transfer-categories). || Transfers/Disclaimer       | Depending on supplier and transfer type, the Disclaimer will contain pickup details.                        || Transfers/ProviderDetails  | Shows the providers name and rating (if applicable).                                                        || Transfers/Cancellation     | Shows the cancellation period before pickup date/time.                                                      || Transfers/VehicleDetails   | Details about the vehicle being used for the Transfer/s.                                                    || Transfers/OutboundTransfer | Details about the outbound transfer.                                                                        || Transfers/ReturnTransfer   | Details about the return transfer (This field will be `null` if no return was requested).                   || Transfers/PartnerOwnSupply | Product originates from partner’s own supply. Your account manager will confirm whether you should use this. || Transfers/SupplierCost     | Supplier cost for this transfer. Only available for selected products and requests.                     |#### [Transfer Categories](#transfer-categories)Here are the available categories which may be returned, there will only be one category assigned to each Transfer:- private_adapted_vehicle- private_car- private_coach- private_electric_car- private_excutive_car- private_executive_electric_car- private_helicopter- private_limousine- private_luxury_car- private_minibus- private_minivan- private_sea_plane- private_speed_boat- private_suv- private_water_taxi- shared_express_shuttle- shared_shuttle- shared_water_taxi### Example```json{    \"API_Reply\": {        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 1,            \"Result\": \"OK\",            \"cached\": true,            \"expires\": \"2020-07-21 15:20:14\"        },        \"Transfers\": [            {                \"ATTRIBUTES\": [],                \"Name\": \"Shuttle\",                \"Code\": \"TBHT39\",                \"BookingURL\": \"/v1/transfers/TBHT39.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 103.52,                \"NonDiscPrice\": 103.52,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"shared_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 90,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:30\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Speedy Shuttle\",                \"Code\": \"TBHT519\",                \"BookingURL\": \"/v1/transfers/TBHT519.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 134.8,                \"NonDiscPrice\": 134.8,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/shuttlebus.jpeg\",                        \"Alt\": \"shuttlebus\"                    }                ],                \"Category\": \"speedy_shuttle\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": \"\",                    \"MaxCapacity\": \"\",                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 1,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": false,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 75,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"12:45\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Car\",                \"Code\": \"TBHT43\",                \"BookingURL\": \"/v1/transfers/TBHT43.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 201.72,                \"NonDiscPrice\": 201.72,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_transfer\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Executive Car\",                \"Code\": \"TBHT18\",                \"BookingURL\": \"/v1/transfers/TBHT18.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 291.86,                \"NonDiscPrice\": 291.86,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_luxury.jpeg\",                        \"Alt\": \"private luxury\"                    }                ],                \"Category\": \"private_executive\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 1,                    \"MaxCapacity\": 4,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 4,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            },            {                \"ATTRIBUTES\": [],                \"Name\": \"Private Minibus\",                \"Code\": \"TBHT2\",                \"BookingURL\": \"/v1/transfers/TBHT2.js\",                \"MoreInfoURL\": null,                \"TotalPrice\": 295.32,                \"NonDiscPrice\": 295.32,                \"SalesCurrency\": \"GBP\",                \"Images\": [                    {                        \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",                        \"Alt\": \"private standard\"                    }                ],                \"Category\": \"private_minibus\",                \"Disclaimer\": {                    \"Title\": null,                    \"Message\": null                },                \"ProviderDetails\": {                    \"ProviderName\": \"\",                    \"ProviderRating\": \"\"                },                \"Cancellation\": {                    \"Period\": 72,                    \"Percentage\": 100,                    \"Fee\": 0                },                \"VehicleDetails\": {                    \"MinCapacity\": 5,                    \"MaxCapacity\": 8,                    \"MinStops\": \"\",                    \"MaxStops\": \"\",                    \"Bags\": 8,                    \"NumberOfVehicles\": 1,                    \"IsPrivate\": true,                    \"Supplier\": \"\"                },                \"OutboundTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"Málaga Airport\",                    \"OriginAddress\": \"Málaga Airport, Málaga\",                    \"OriginIata\": \"AGP\",                    \"Destination\": \"BlueBay Banús\",                    \"DestinationAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"DestinationIata\": \"\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": \"2020-08-01\",                    \"ArrivalTime\": \"09:00\",                    \"ReturnDate\": null,                    \"ReturnTime\": null,                    \"PickupDate\": \"2020-08-01\",                    \"PickupTime\": \"09:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"ReturnTransfer\": {                    \"SupplierRef\": \"\",                    \"Origin\": \"BlueBay Banús\",                    \"OriginAddress\": \"Carretera Cadiz, 29660, Marbella\",                    \"OriginIata\": \"\",                    \"Destination\": \"Málaga Airport\",                    \"DestinationAddress\": \"Málaga Airport, Málaga\",                    \"DestinationIata\": \"AGP\",                    \"JourneyTime\": 60,                    \"ArrivalDate\": null,                    \"ArrivalTime\": null,                    \"ReturnDate\": \"2020-08-07\",                    \"ReturnTime\": \"16:30\",                    \"PickupDate\": \"2020-08-07\",                    \"PickupTime\": \"13:00\",                    \"JoiningInstructions\": null,                    \"ContactNumbers\": null                },                \"advance_purchase\": true,                \"PartnerOwnSupply\": false            }        ],        \"Pricing\": {},        \"SepaID\": \"\",        \"API_Header\": {            \"Request\": {                \"ABTANumber\": \"YourABTANumber\",                \"Password\": \"YourPassword\",                \"Initials\": \"YourInitials\",                \"key\": \"YourKey\",                \"token\": \"YourToken\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1000,                \"ReturnDate\": \"2020-08-07\",                \"ReturnTime\": 1730,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"OutFlight\": \"U28605\",                \"ReturnFlight\": \"U28602\",                \"Adults\": 2,                \"v\": 1,                \"format\": \"js\"            }        }    }}```### Worked ExamplesBelow are some worked examples of both the request and response when requesting transfers availability.#### Airport to GIATA##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=GIATA&DropOff=439771&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      GIATA      439771      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"GIATA\",        \"DropOff\": 439771,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to TTI##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=TTI&DropOff=10147575&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&Adults=2&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP        //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg    private standard        private_transfer                                        72    100    0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      s/n, Carretera de Banyeres, 03410, Biar            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      TTI      10147575      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 14:50:30\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [          {            \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",            \"Alt\": \"private standard\"          }        ],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"s/n, Carretera de Banyeres, 03410, Biar\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      },    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"TTI\",        \"DropOff\": 10147575,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}#### Airport to Postal Address##### Request{% codetabs %}{% codetab XML %}```https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```{% endcodetab %}{% codetab JSON %}```https:///api.holidayextras.com/v1/transfers/search.js?ABTANumber=YourABTANumber&Password=YourABTANumber&Initials=YourInitials&key=YourKey&token=YourToken&PickUp=ALC&PickUpType=IATA&DropOffType=postal-address&DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&DropOffAddress[0]=Carretera%20de%20Banyeres&DropOffAddress[1]=s/n&DropOffTown=%20Biar&DropOffCounty=Alicante&DropOffPostcode=03410&DropOffCountryCode=ES&DropOffLongitude=-0.76832006&DropOffLatitude=38.63852215&Adults=2&FromDate=2022-03-16&FromTime=1115&ReturnDate=2022-03-23&ReturnTime=1115&OutFlight=U28605&ReturnFlight=U28602```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}##### ResponseNB: This is a shortened example compiled from a full availability response.{% codetabs %}{% codetab XML %}```xml      Private Standard Car    TBHT1169922    /transfers/TBHT1169922        87.96    87.96    GBP          //dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg      private standard        private_transfer                                                  72      100      0              1      4                  4      1      true                                Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            60                  16/03/2022      11:15                  16/03/2022      11:15                                Hotel Rural Castillo De Biar      Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n, Biar, Alicante, 03410, ES            Alicante International Airport (Benidorm)      Alicante International Airport (Benidorm), Alicante      ALC      60                              23/03/2022      11:15      23/03/2022      07:45                    1    false                  YourABTANumber      YourPassword      YourInitials      YourKey      YourToken      ALC      IATA      postal-address      Hotel Rural Castillo De Biar      Carretera de Banyeres      s/n      Biar      Alicante      03410      ES      -0.76832006      38.63852215      2022-03-16      1115      2022-03-23      1115      2      U28605      U28602      ```{% endcodetab %}{% codetab JSON %}```json{  \"API_Reply\": {    \"ATTRIBUTES\": {      \"Product\": \"Transfers\",      \"RequestCode\": 1,      \"Result\": \"OK\",      \"cached\": true,      \"expires\": \"2021-12-07 16:26:43\"    },    \"Transfers\": [      {        \"ATTRIBUTES\": [],        \"Name\": \"Private Standard Car\",        \"Code\": \"TBHT1169922\",        \"BookingURL\": \"/transfers/TBHT1169922.js\",        \"MoreInfoURL\": null,        \"TotalPrice\": 87.96,        \"NonDiscPrice\": 87.96,        \"SalesCurrency\": \"GBP\",        \"Images\": [{          \"Src\": \"//dmy0b9oeprz0f.cloudfront.net/render/resortTransfers/private_standard.jpeg\",          \"Alt\": \"private standard\"        }],        \"Category\": \"private_transfer\",        \"Disclaimer\": {          \"Title\": null,          \"Message\": null        },        \"ProviderDetails\": {          \"ProviderName\": \"\",          \"ProviderRating\": \"\"        },        \"Cancellation\": {          \"Period\": 72,          \"Percentage\": 100,          \"Fee\": 0        },        \"VehicleDetails\": {          \"MinCapacity\": 1,          \"MaxCapacity\": 4,          \"MinStops\": \"\",          \"MaxStops\": \"\",          \"Bags\": 4,          \"NumberOfVehicles\": 1,          \"IsPrivate\": true,          \"Supplier\": \"\",          \"Make\": \"\"        },        \"OutboundTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Alicante International Airport (Benidorm)\",          \"OriginAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"OriginIata\": \"ALC\",          \"Destination\": \"Hotel Rural Castillo De Biar\",          \"DestinationAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"DestinationIata\": \"\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": \"2022-03-16\",          \"ArrivalTime\": \"11:15\",          \"ReturnDate\": null,          \"ReturnTime\": null,          \"PickupDate\": \"2022-03-16\",          \"PickupTime\": \"11:15\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"ReturnTransfer\": {          \"SupplierRef\": \"\",          \"Origin\": \"Hotel Rural Castillo De Biar\",          \"OriginAddress\": \"Hotel Rural Castillo De Biar, Carretera de Banyeres, s/n,  Biar, Alicante, 03410, ES\",          \"OriginIata\": \"\",          \"Destination\": \"Alicante International Airport (Benidorm)\",          \"DestinationAddress\": \"Alicante International Airport (Benidorm), Alicante\",          \"DestinationIata\": \"ALC\",          \"JourneyTime\": 60,          \"DepartureDate\": null,          \"DepartureTime\": null,          \"ArrivalDate\": null,          \"ArrivalTime\": null,          \"ReturnDate\": \"2022-03-23\",          \"ReturnTime\": \"11:15\",          \"PickupDate\": \"2022-03-23\",          \"PickupTime\": \"07:45\",          \"JoiningInstructions\": null,          \"ContactNumbers\": null        },        \"advance_purchase\": true,        \"PartnerOwnSupply\": false      }    ],    \"Pricing\": {},    \"SepaID\": \"\",    \"API_Header\": {      \"Request\": {        \"ABTANumber\": \"YourABTANumber\",        \"Password\": \"YourPassword\",        \"Initials\": \"YourInitials\",        \"key\": \"YourKey\",        \"token\": \"YourToken\",        \"PickUp\": \"ALC\",        \"PickUpType\": \"IATA\",        \"DropOffType\": \"postal-address\",        \"DropOffName\": \"Hotel Rural Castillo De Biar\",        \"DropOffAddress\": [          \"Carretera de Banyeres\",          \"s/n\"        ],        \"DropOffTown\": \" Biar\",        \"DropOffCounty\": \"Alicante\",        \"DropOffPostcode\": \"03410\",        \"DropOffCountryCode\": \"ES\",        \"DropOffLongitude\": -0.76832006,        \"DropOffLatitude\": 38.63852215,        \"FromDate\": \"2022-03-16\",        \"FromTime\": 1115,        \"ReturnDate\": \"2022-03-23\",        \"ReturnTime\": 1115,        \"Adults\": 2,        \"OutFlight\": \"U28605\",        \"ReturnFlight\": \"U28602\",        \"format\": \"js\"      }    }  }}```{% endcodetab %}{% endcodetabs %}[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/transfers/av/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-carhire": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Car Hire",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Car Hire[API Docs](/hxapi/) > product:[Car Hire](index)These are the car hire requests.| Action | Endpoint | Method || --- | --- | --- || Lookup Locations | [https://api.holidayextras.com/v1/carHire/locations](locations) | GET || Availability | [https://api.holidayextras.com/v1/carHire/products](availability) | GET || Make Booking | [https://api.holidayextras.com/v1/carHire/](booking/make) | POST || Lookup Booking | [https://api.holidayextras.com/v1/carHire-booking/](booking/lookup) | GET |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/carhire/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-transfers-bkg": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Transfers Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Transfers Booking## Booking Request### MethodPOST### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/[CODE]```Where ```[CODE]``` is the product code received in the availability request of the product you want to book.Here is an example for the following Availability response:```TBHT1169922/transfers/TBHT1169922...```Your Make Booking request will have the following URL: https://api.holidayextras.com/v1/transfers/TBHT1169922### Request ParametersThe parameters _must_ be sent in the body of the request, as `x-www-form-urlencoded` data.NB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   ||--------------------|-----------|------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                              || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                        || Initials           | String    | [A-Z] 3 chars    | N          | The initials of the Operator/Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                                      || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpType         | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `PickUpType=IATA`).                                                                                                                                                                                                                                                                                                                                                                                                              || PickUp             | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `PickUp=AGP`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                              || PickUpName         | String    | [A-Z0-9]         | Y [^1]     | The pick up location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               || PickUpAddress[]    | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"PickUpAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                              || PickUpTown         | String    | [A-Z0-9]         | Y [^1]     | The pick up town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || PickUpCounty       | String    | [A-Z0-9]         | Y [^1]     | The pick up county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || PickUpPostcode     | String    | [A-Z0-9]         | Y [^1]     | The pick up postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || PickUpCountryCode  | String    | [A-Z] 2 chars    | Y [^1]     | The pick up country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                                || PickUpLongitude    | Float     | [0-9]            | Y [^1]     | The pick up location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || PickUpLatitude     | Float     | [0-9]            | Y [^1]     | The pick up location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || DropOffType        | String    | [A-Z0-9]         | Y          | The type can either be `IATA`, `TTI`, `GIATA`, `postal-address` or `PC` (Postcode - only available for UK locations) (i.e `DropOffType=TTI`).                                                                                                                                                                                                                                                                                                                                                                                                              || DropOff            | String    | [A-Z0-9]         | Y*         | The IATA, TTI, GIATA or Postcode (i.e `DropOff=85101062`).Not required for `postal-address`                                                                                                                                                                                                                                                                                                                                                                                                                        || DropOffName        | String    | [A-Z0-9]         | Y [^1]     | The drop off location name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              || DropOffAddress[]   | String    | [A-Z0-9]         | Y [^1]     | First line of address (house name / number and road) of the destination.If you require more than one address line, then you can replicate this field and increment the number in square brackets, i.e. \"DropOffAddress[1]\" for address line two. Up to a maximum of two address lines.                                                                                                                                                                                                                             || DropOffTown        | String    | [A-Z0-9]         | Y [^1]     | The drop off town name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || DropOffCounty      | String    | [A-Z0-9]         | Y [^1]     | The drop off county name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                || DropOffPostcode    | String    | [A-Z0-9]         | Y [^1]     | The drop off postcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || DropOffCountryCode | String    | [A-Z] 2 chars    | Y [^1]     | The drop off country code in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format.                                                                                                                                                                                                                                                                                                                                                                                                               || DropOffLongitude   | Float     | [0-9]            | Y [^1]     | The drop off location longitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || DropOffLatitude    | Float     | [0-9]            | Y [^1]     | The drop off location latitude.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || FromDate           | Date      | YYYY-MM-DD       | Y          | Flight Arrival Date (`PickUpType` = `IATA`), Flight Departure Date (`DropOffType` = `IATA`), Preferred Date.                                                                                                                                                                                                                                                                                                                                                                                                             || FromTime           | Time      | HHMM             | Y          | Flight Arrival Time (`PickUpType` = `IATA`), Flight Departure Time (`DropOffType` = `IATA`), Preferred Time.                                                                                                                                                                                                                                                                                                                                                                                                             || ReturnDate         | Date      | YYYY-MM-DD       | N          | Flight Arrival Date (`DropOffType` = `IATA`), Flight Departure Date (`PickUpType` = `IATA`), Preferred Date. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || ReturnTime         | Time      | HHMM             | N          | Flight Arrival Time (`DropOffType` = `IATA`), Flight Departure Time (`PickUpType` = `IATA`), Preferred Time. **Required** for return bookings as it is not inferred from flight data;                                                                                                                                                                                                                                                                                                                                    || Adults             | Integer   | [0-9]            | Y          | Number of Adults requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || Children           | Integer   | [0-9]            | N          | Number of Children requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 || Infants            | Integer   | [0-9]            | N          | Number of Infants requiring a transfer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  || OutFlight          | String    | [A-Z0-9]         | Y*         | A flight number is required if the journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                        || ReturnFlight       | String    | [A-Z0-9]         | N*         | A flight number is required if the return journey involves being picked up or dropped off at an Airport.                                                                                                                                                                                                                                                                                                                                                                                                                 || Title              | String    | [A-Z]            | Y          | Title of lead passenger, an option from the [list of valid titles](/hxapi/reference/titles)                                                                                                                                                                                                                                                                                                                                                                                                                              || FirstName          | String    | [A-Z]            | Y          | The lead passenger's first name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || LastName           | String    | [A-Z]            | Y          | The lead passenger's last name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          || Email              | String    | [A-Z] 50 chars   | Y          | The lead passenger's email address.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      || DayPhone           | Integer   | [0-9] 20 chars   | Y          | The lead passenger's contact telephone number.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           || Price              | Float     | [0-9]            | Y          | The total price of the Transfer/s (This will be the value of the `TotalPrice` property returned in the availability response).                                                                                                                                                                                                                                                                                                                                                                                           || PriceCheckFlag     | String    | Y/N              | N          | Indicates a price check will be carried out prior to booking. If the price is lower in the system the booking will be made as the customer will benefit from a saving.  If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount.  You should then resubmit the request changing the PriceCheckPrice with the new price.         || PriceCheckPrice    | Float     | [0-9]            | N          | Price of the product, received from the availability request or price check.  Only required when `PriceCheckFlag` is `Y`                                                                                                                                                                                                                                                                                                                                                                                                 |#### PaymentIn the UK, we are PCI DSS compliant and so we do not accept customers' payment details being passed to us via the API. Further details can be found in our section on [Payment](/hxapi/payment).Please contact your Account Manager if you have any questions concerning payment.## Booking ResponseIf the booking has been successful, the response will contain a `Booking` field which will have a `BookingRef` property. A summary of the request received can be found in the header field at the end of the response.For a detailed explanation of the fields returned, please see below:| Field                                     | Additional Information                                                                                                                                     ||-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                        | The reference for the booking, use this reference in all communication with us relating to this booking.                                                   || Booking/AgentComm                         | Commission earned from this booking.                                                                                                                       || Booking/MoreInfoURL                       | The URL to GET more information about the booking (view [View Booking Request](../view) for more information).                        || Booking/Status (Future)                   | Indicates the current status of the booking (`Pending`, `Confirmed`, `Cancelled`, or `Error`).                                                             || Booking/SuggestedPollingInterval (Future) | Specifies the recommended interval in seconds for polling the view booking endpoint. The polling frequency varies based on the product type and supplier. |### Example```json{    \"API_Reply\": {        \"Booking\": {            \"BookingRef\": \"TBBGNHMT\",            \"AgentComm\": \"0.17\",            \"VATonComm\": \"0.00\",            \"MoreInfoURL\": \"/v1/booking/TBBGNHMT.js\",            \"Status\": \"Pending\",            \"SuggestedPollingInterval\": 3600        },        \"ATTRIBUTES\": {            \"Product\": \"Transfers\",            \"RequestCode\": 5,            \"Result\": \"OK\"        },        \"API_Header\": {            \"Request\": {                \"key\": \"TEST\",                \"token\": \"d2d6dedd-606f-4f00-aa8c-526a358e927c\",                \"ABTANumber\": \"TESTL\",                \"Password\": \"Redacted\",                \"FromDate\": \"2020-08-01\",                \"FromTime\": 1255,                \"ReturnDate\": \"2020-08-10\",                \"ReturnTime\": 1355,                \"PickUp\": \"AGP\",                \"PickUpType\": \"IATA\",                \"DropOff\": 85101062,                \"DropOffType\": \"TTI\",                \"Adults\": 2,                \"Title\": \"MR\",                \"FirstName\": \"Test\",                \"LastName\": \"Test\",                \"Email\": \"test@holidayextras.com\",                \"DayPhone\": \"07123456789\",                \"Price\": 103.52,                \"OutFlight\": \"LS1405\",                \"ReturnFlight\": \"LS1406\",                \"v\": 1,                \"format\": \"js\"            }        }    }}```[^1]: Only required when the location type is `postal-address`.",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/transfers/bkg/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-upgrade": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Product Upgrades",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Product Upgrades[API Docs](/hxapi/) > [Product Upgrades](/hxapi/upgrade)## Upgrades Availability RequestUpgrades are currently only supported for parking, hotel and lounge bookings. Upgrades can be requested on a per product basis.#### MethodGET#### Endpoint/upgrade/{productCode}NB: Where `productCode` is the code of the base product i.e. the parking/hotel/lounge etc. product.```https://api.holidayextras.com/v1/upgrade/LGV4```## Request Parameters| Name        | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                          ||-------------|-----------|------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber  | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                 || Password    | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials    | String    | [A-Z] 3 chars    | N          | The initials of the Operator / Agent.                                                                                                                           || key         | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                             || token       | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                      || ArrivalDate | String    | YYYY-MM-DD       | Y          | This should be the same as the `ArrivalDate` from the base product request.                                                                                     || ArrivalTime | Time      | HHMM             | Y          | This should be the same as the `ArrivalTime` from the base product request.                                                                                     || DepartDate  | Date      | YYYY-MM-DD       | N          | This should be the same as the `DepartDate` from the base product request.                                                                                      || DepartTime  | Time      | HHMM             | N          | This should be the same as the `DepartTime` from the base product request.                                                                                      || Adults      | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of adults in the party                                                                                            || Children    | Integer   | [0-9]            | Y*         | Mandatory for Lounge upgrade requests. Number of children in the party                                                                                          |## Upgrade Availability ResponseThe response will return a list of available upgrades.Upgrades are sold on a per booking, per person, or per room basis.Upgrades can be for the day before travel, day of departure or day of return.| Field              | Additional Information                                                                      ||--------------------|---------------------------------------------------------------------------------------------|| Code               | Product code for the upgrade                                                                || Name               | Name of the upgrade                                                                         || Per                | Pricing basis, either per *P*erson, per *B*ooking, per *R*oom                               || Canx               | Whether the upgrade is cancellable (Y/N)                                                    || description        |                                                                                             || supplement_type    | Type classification for the upgrade                                                         || Date               | Date the upgrade is to be booked for. Format YYYY-MM-DD                                     || only_for_adults    | Upgrades restricted to adult only parties e.g. Adult only lounges                           || Price              | The price of the upgrade minus any discounts. Only present for per booking upgrades         || NonDiscPrice       | The total price of the upgrade before discounts. Only present for per booking upgrades      || DiscAmt            | The amount of any discount applied. Only present for per booking upgrades                   || AdPrice            | The per adult price minus any discounts. Only present for per person upgrades               || NonDiscAdPrice     | The per adult price before any discounts. Only present for per person upgrades              || AdDiscAmt          | The amount of discount applied to the per adult price. Only present for per person upgrades || ChPrice            | The per child price minus any discounts. Only present for per person upgrades               || NonDiscChPrice     | The per child price before any discounts. Only present for per person upgrades              || ChDiscAmt          | The amount of discount applied to the child price. Only present for per person upgrades     || API_Header/Request | The API returns every parameter and value you sent in the request.                          |## Examples### Example 1 - Carpark Upgrades#### Request{% codetabs %}  {% codetab XML %}  ```https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45  ```  {% endcodetab %}  {% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/STN5.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```  {% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_1_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_1_response.json %}```{% endcodetab %}{% endcodetabs %}### Example 1 - Hotel Upgrades#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/upgrade/LGWSOF.js?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2020-11-03&ArrivalTime=12:30&DepartDate=2020-11-11&DepartTime=13:45```{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_example_2_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_example_2_response.json %}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/upgrade/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-transfers": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Transfers",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Transfers[API Docs](/hxapi/) > product:[Transfers](index)## Transfer EndpointsWhen using the Transfer endpoints below, you will be able to search using various types of location data which will represent the transfers pickup and dropoff points. Currently, the API will accept IATA Codes, TTI Codes and Postcodes (Postcodes can be used for UK Transfers).You will need a token to call the api. To get the user token use the existing endpoint: [Get Token](https://docs.holidayextras.co.uk/hxapi/usertoken/).For the complete API specification, see the [OpenAPI schema](https://api.holidayextras.com/v1/transfers/openapi.yml). | Action                     | Endpoint                                                                     | Method | | ------                     | --------                                                                     | ------ | | Availability               | [https://api.holidayextras.com/v1/transfers/search](av)                    | GET    | | Make Booking               | [https://api.holidayextras.com/v1/transfers/[TransferCode]](bkg)           | POST   | | View Booking               | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](view)    | GET    | | Cancel Booking             | [https://api.holidayextras.com/v1/transfers/booking/[BookingRef]](cancel)  | DELETE | | Cancellation Policy        | [https://api.holidayextras.com/v1/transfers/[BookingRef]/cancellation-policy](cancellation-policy) | GET    | | Amend Booking              | not supported                                                                |   -    |",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/transfers/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -400,17 +400,17 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "payment-gateway-v1-pay": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "payment-gateway-v2-pay": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Payment Gateway: Pay",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v1/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v1+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [A-Z] | Y | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | String | [0-9] | Y | The price (in pence) to be paid. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v1+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"paymentId\": \"testPaymentId\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": \"1234\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/payment-gateway/v1/pay/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v2/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.**Note**: We have added postalCode and countryCode as NatWest have started refusing payments without this information.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v2+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [0-9A-Z]{16} | N | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. If this is not supplied, then one will be generated for this payment and returned as part of the result. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | Integer | [0-9] | Y | The price (in pence) to be paid. | | currency | String | [A-Z]{3} | Y | ISO 4217 standard currency code for the currency of this payment | | postalCode | String | [A-Z0-9] | N | The postal code for the payment's billing address. | | countryCode | String | [A-Z]{2} | N | ISO 3166-1 alpha-2 standard country code for the billing address. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v2+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": 1234,  \"currency\": \"GBP\",  \"postalCode\": \"CT21 4JF\",  \"countryCode\": \"GB\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/payment-gateway/v2/pay/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "payment-gateway-v2-pay": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "payment-gateway-v1-pay": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Payment Gateway: Pay",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v2/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.**Note**: We have added postalCode and countryCode as NatWest have started refusing payments without this information.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v2+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [0-9A-Z]{16} | N | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. If this is not supplied, then one will be generated for this payment and returned as part of the result. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | Integer | [0-9] | Y | The price (in pence) to be paid. | | currency | String | [A-Z]{3} | Y | ISO 4217 standard currency code for the currency of this payment | | postalCode | String | [A-Z0-9] | N | The postal code for the payment's billing address. | | countryCode | String | [A-Z]{2} | N | ISO 3166-1 alpha-2 standard country code for the billing address. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v2+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": 1234,  \"currency\": \"GBP\",  \"postalCode\": \"CT21 4JF\",  \"countryCode\": \"GB\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/payment-gateway/v2/pay/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Payment Gateway: Pay[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Pay](/payment-gateway/v1/pay)## Payment RequestThis endpoint will take payment using a token and required payment parameters.**Note**: Token payment is currently available for Level 5 Germany agents only.### MethodPOST### EndpointTo make a payment, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/pay```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v1+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | paymentId | String | [A-Z] | Y | A unique ID to be used when making the payment. This cannot already exist otherwise payment will fail. | | token   | String | [0-9] | Y | A tokenised card to make the payment against. This needs to exist already, otherwise payment will fail. | | paymentReference | String | [A-Z] | Y | A reference used to group multiple payments together, doesn't need to be unique. | | amount | String | [0-9] | Y | The price (in pence) to be paid. |## Payment ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been paid | | status | The status of the payment | | error | The error if the payment fails |## ExamplesBelow are examples of both the request and response for a new payment.### Payment Request**POST**  `https://payment-gateway.holidayextras.co.uk/pay`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v1+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"paymentId\": \"testPaymentId\",  \"token\": \"4111111111111111\",  \"paymentReference\": \"testPaymentRef\",  \"amount\": \"1234\"}```### Payment Response#### Successful payment```{    \"amount\": 12.34,    \"id\": \"testPaymentId\",    \"status\": \"SUCCESS\"}```#### Failed payment```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed to make payment\"}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/payment-gateway/v1/pay/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -421,13 +421,6 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-parking-pricecheck": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Car Park Price Check",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Car Park Price Check[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av) > [Price Check](/hxapi/parking/priceCheck)## Car Park Pre-booking Price Check RequestThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck```For example, for _Maple Manor Meet and Greet at London Gatwick North terminal_ the endpoint is:```https://api.holidayextras.com/v1/carpark/LGW4/priceCheck```### Request ParametersNB: All parameter names are case sensitive.| Name                   | Data Type | Format            | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           ||------------------------|-----------|-------------------|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber             | String    | [A-Z0-9] 5 chars  | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                  || Password               | String    | [A-Z0-9] 5 chars  | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                  || Initials               | String    | [A-Z] 3 chars     | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            || key                    | String    | [A-Z]             | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                              || token                  | String    | [0-9] 9 chars     | Y          | This is the same token used in the availability request.                                                                                                                                                                                                                                                                                                                                                                                                                                                         || ArrivalDate            | Date      | YYYY-MM-DD        | Y          | Date customer drops vehicle at car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || ArrivalTime            | Time      | HHMM              | Y          | Time customer drops vehicle at car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || DepartDate             | Date      | YYYY-MM-DD        | Y          | Date customer picks up vehicle from car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || DepartTime             | Time      | HHMM              | Y          | Time customer picks up vehicle from car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || NumberOfPax            | Integer   | [0-9] 2 chars     | Y          | Number of passengers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            || System                 | String    | [A-Z] 3 chars     | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                                                                                                                                                                                   |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/parking/bkg).## Car Park Price Check Response| Field                   | Additional Information                                                                                                                                                                                        ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice      | This is the total price for the booking including all upgrades || API_Header/Request      | A list of parameters that were sent in the booking request.                                                                                                                                                   |## Worked ExamplesBelow are worked examples of both the request and response for the price check for parking.### UK Parking price check#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1200&DepartDate=2025-07-08&DepartTime=1200&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_response.xml %}```### UK Parking price check with Upgrades#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1230&DepartDate=2025-07-08&DepartTime=1345&NumberOfPax=1&Supplements[0][Code]=HXOST1&Supplements[0][Date]=2025-07-01&Supplements[0][Quantity]=1&Supplements[1][Code]=LHRSFS&Supplements[1][Date]=2025-07-01&Supplements[1][Adults]=2&Supplements[1][Children]=1```#### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```### Error example: no availability#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-09-15&ArrivalTime=1300&DepartDate=2024-09-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_no_availability_response.xml %}```### Error example: request which is incorrect or can't be actioned#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-11-15&ArrivalTime=2500&DepartDate=2024-11-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_incorrect_request_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/parking/priceCheck/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "hxapi-hotel-pricecheck": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Hotel Price Check",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "# Hotel Price CheckThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.## MethodGET## EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/hotel/HotelProductCode/priceCheck```For example, for _Mercure at London Heathrow_ the endpoint is:```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck```## Request ParametersNB: All parameter names are case sensitive.| Name                   | Data Type | Format             | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       ||------------------------|-----------|--------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber             | String    | [A-Z0-9] 5 chars   | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                              || Password               | String    | [A-Z0-9] 5 chars   | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                              || Initials               | String    | [A-Z] 3 chars      | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        || key                    | String    | [A-Z]              | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                          || token                  | String    | [0-9] 9 chars      | Y          | This is the same token used in the availability request.                                                                                                                                                                                                                                                                                                                                                                                                                                                     || ArrivalDate            | Date      | YYYY-MM-DD         | Y          | Date customer arrives at hotel.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              || Nights                 | Integer   | 1, 2, 3, etc       | Y          | Number of nights the customer wants to stay in the hotel. NB: For European products it is only possible to book one night stays.                                                                                                                                                                                                                                                                                                                                                                             || RoomCode               | String    | [A-Z0-9] 3 chars   | Y          | See [RoomCodes](/hxapi/types/roomcode) for a list of valid codes.                                                                                                                                                                                                                                                                                                                                                                                                                                            || Adults                 | Integer   | [1-5] 1 char       | Y          | The number of adults occupying the room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     || Children               | Integer   | [0-4] 1 char       | Y          | The number of children occupying the room.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   || ParkingDays            | Integer   | [0-9] 2 chars      | Y          | NB: The maximum duration accepted for ParkingDays is 30.                                                                                                                                                                                                                                                                                                                                                                                                                                                     || CustomerRef            | String    | [A-Z0-9] 20 chars  | N          | Enter your Customer Reference to help match bookings for accounting purposes.                                                                                                                                                                                                                                                                                                                                                                                                                                || Remarks                | String    | [A-Z0-9] 60 chars  | N          | Pass in Remarks for notification such as COT REQUESTED in ROOM                                                                                                                                                                                                                                                                                                                                                                                                                                               || Waiver                 | Boolean   | [0,1]              | Y          | Defaults to 0 if not supplied.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               || DataProtection         | String    | [Y,N]              | N          | Does the customer consent to receiving offers from Holiday Extras? Y = Yes, will receive offers, N = No, customer data is protected. Defaults to No if not supplied.                                                                                                                                                                                                                                                                                                                                         || System                 | String    | [A-Z] 3 chars      | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                                                                                                                                                                               || lang                   | String    | [A-Z] 2 chars      | Y*         | Required for requests for European products. (Values available are `en`, `de`, `it`, `es`, `pt` and `nl`.)                                                                                                                                                                                                                                                                                                                                                                                                   |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/hotel/bkg).## Multiple rooms on same bookingThe additional parameters for including a second room are:| Name               | Data Type | Format                              | Mandatory? | Additional Information                                                                                                                                ||--------------------|-----------|-------------------------------------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|| SecondRoomType     | String    | [A-Z0-9] 2 chars                    | N*         | This parameter is mandatory if the customer wishes to book two rooms at the same time. The room codes are as per [Room Codes](/hxapi/types/roomcode). || SecondRoomCode     | String    | [Room Codes](/hxapi/types/roomcode) | N          | NB: Please note that the room codes differ between availability and booking requests.                                                                 || SecondRoomAdults   | Integer   | [1-5] 1 char                        | N          | The number of adults occupying the second room.                                                                                                       || SecondRoomChildren | Integer   | [0-4] 1 char                        | N          | The number of children occupying the second room.                                                                                                     |## UK Hotels with parkingThe additional parameters for hotel with parking (where parking > 0 days) are:| Name           | Data Type | Format            | Mandatory? ||----------------|-----------|-------------------|------------|| CarDropoffDate | Date      | YYYY-MM-DD        | Y          || CarDropoffTime | Time      | HHMM              | Y          || CarPickupDate  | Date      | YYYY-MM-DD        | Y          || CarPickupTime  | Time      | HHMM              | Y          |# Hotel Price Check Response| Field                   | Additional Information                                                                                                                                                                                        ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice      | This is the total price for the booking including all upgrades || API_Header/Request | A list of parameters that were sent in the booking request.                                                                                                                                               |# Worked ExamplesBelow are worked examples of both the request and response for the price check for hotels.## UK Hotel price check### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0```### Response```xml{% include_relative examples/_uk_room_only_price_check_response.xml %}```## UK Hotel price check with Upgrades### Request```https://api.holidayextras.com/v1/hotel/LHRMEA/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&ArrivalDate=2025-07-10&Nights=1&RoomCode=DBL&ParkingDays=0&Adults=2&Children=0&Supplements[0][Code]=LGWSOE&Supplements[0][Date]=2025-07-10&Supplements[0][Quantity]=1&Supplements[0][TotalPrice]=40.00&Supplements[1][Code]=LGWASC&Supplements[1][Date]=2025-07-11&Supplements[1][Adults]=2&Supplements[1][Children]=0&Supplements[1][TotalPrice]=82.00```### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```## Error example: no availability### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=0&Nights=1&ArrivalDate=2024-10-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_no_availability_response.xml %}```## Error example: validation error### Request```https://api.holidayextras.com/v1/hotel/LGWEUL/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&key=YourKey&token=YourToken&RoomCode=DBL&Adults=2&Children=2&Nights=1&ArrivalDate=2024-11-15```### Response```xml{% include_relative examples/_uk_booking_room_only_price_check_validation_error_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -435,10 +428,10 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "payment-gateway-v1-refund": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Payment Gateway: Refund",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Payment Gateway: Refund[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Refund](/payment-gateway/v1/refund)## Refund RequestThis endpoint will make a refund based on existing payments.### MethodPOST### EndpointTo make a refund, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/refund```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v1+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | payments | Array | [String, String] | Y | An array listing all payments made for this booking. | | amount | String | [0-9] | Y | The price (in pence) to be refunded. |## Refund ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been refunded | | status | The status of the refund | | error | The error if the refund fails |## ExamplesBelow are examples of both the request and response for a refund.### Refund Request**POST**  `https://payment-gateway.holidayextras.co.uk/refund`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v1+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"payments\": [\"testPaymentId1\", \"testPaymentId2\"],  \"amount\": \"1234\"}```### Refund Response#### Successful Refund```{    \"amount\": 12.34,    \"id\": \"REFUND-testPaymentId1\",    \"status\": \"SUCCESS\"}```#### Failed Refund```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed making refund\"}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/payment-gateway/v1/refund/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-parking-pricecheck": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Car Park Price Check",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Car Park Price Check[API Docs](/hxapi/) > product:[Parking](/hxapi/parking) > endpoint:[carpark](/hxapi/parking/av) > [Price Check](/hxapi/parking/priceCheck)## Car Park Pre-booking Price Check RequestThe price check is an optional step to retrieve an up-to-date total price prior to booking.The parameters are similar to the Book request; the total price retrieved will include all ugprades specified.### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/carpark/CarParkProductCode/priceCheck```For example, for _Maple Manor Meet and Greet at London Gatwick North terminal_ the endpoint is:```https://api.holidayextras.com/v1/carpark/LGW4/priceCheck```### Request ParametersNB: All parameter names are case sensitive.| Name                   | Data Type | Format            | Mandatory? | Additional Information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           ||------------------------|-----------|-------------------|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber             | String    | [A-Z0-9] 5 chars  | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                  || Password               | String    | [A-Z0-9] 5 chars  | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                  || Initials               | String    | [A-Z] 3 chars     | N          | The initials of the Operator / Agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            || key                    | String    | [A-Z]             | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                                                                                                                                                                                                                                              || token                  | String    | [0-9] 9 chars     | Y          | This is the same token used in the availability request.                                                                                                                                                                                                                                                                                                                                                                                                                                                         || ArrivalDate            | Date      | YYYY-MM-DD        | Y          | Date customer drops vehicle at car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || ArrivalTime            | Time      | HHMM              | Y          | Time customer drops vehicle at car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         || DepartDate             | Date      | YYYY-MM-DD        | Y          | Date customer picks up vehicle from car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || DepartTime             | Time      | HHMM              | Y          | Time customer picks up vehicle from car park.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    || NumberOfPax            | Integer   | [0-9] 2 chars     | Y          | Number of passengers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            || System                 | String    | [A-Z] 3 chars     | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                                                                                                                                                                                                                                                                                                                                                                   |{% include _booking_request_supplement_params.md %}For further details on the upgrade parameters, see the [Booking request](/hxapi/parking/bkg).## Car Park Price Check Response| Field                   | Additional Information                                                                                                                                                                                        ||-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| TotalPrice      | This is the total price for the booking including all upgrades || API_Header/Request      | A list of parameters that were sent in the booking request.                                                                                                                                                   |## Worked ExamplesBelow are worked examples of both the request and response for the price check for parking.### UK Parking price check#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1200&DepartDate=2025-07-08&DepartTime=1200&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_response.xml %}```### UK Parking price check with Upgrades#### Request```https://api.holidayextras.com/carpark/LHH6/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&ArrivalDate=2025-07-01&ArrivalTime=1230&DepartDate=2025-07-08&DepartTime=1345&NumberOfPax=1&Supplements[0][Code]=HXOST1&Supplements[0][Date]=2025-07-01&Supplements[0][Quantity]=1&Supplements[1][Code]=LHRSFS&Supplements[1][Date]=2025-07-01&Supplements[1][Adults]=2&Supplements[1][Children]=1```#### Response```xml{% include_relative examples/_uk_upgrade_price_check_response.xml %}```### Error example: no availability#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-09-15&ArrivalTime=1300&DepartDate=2024-09-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_no_availability_response.xml %}```### Error example: request which is incorrect or can't be actioned#### Request```https://api.holidayextras.com/v1/carpark/GLF2/priceCheck?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&token=YourToken&System=ABC&lang=en&ArrivalDate=2024-11-15&ArrivalTime=2500&DepartDate=2024-11-17&NumberOfPax=1```#### Response```xml{% include_relative examples/_uk_price_check_incorrect_request_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/parking/priceCheck/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -449,6 +442,13 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "payment-gateway-v1-refund": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Payment Gateway: Refund",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Payment Gateway: Refund[API Docs](/) > [Payment Gateway](/payment-gateway/) > [Refund](/payment-gateway/v1/refund)## Refund RequestThis endpoint will make a refund based on existing payments.### MethodPOST### EndpointTo make a refund, the endpoint to use is:```https://payment-gateway.holidayextras.co.uk/refund```### Request Headers| Name  | Data Type | Format | Mandatory? | Additional Information || ----  | --------- | ------ | ---------- | ---------------------- || Content-Type | String | `application/json` | Y | This should always be `application/json` || Authorization   | String | `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` | Y | Base64 encoded string for the `username:password` credentials which will be created and provided to you. This header is required with every request.|| Accept | String | `application/vnd.holidayextras.v1+json` | N | To use a different version please provide a different value. |### Request ParametersNB: All parameter names are case sensitive. | Name  | Data Type | Format | Mandatory? | Additional Information | | ----  | --------- | ------ | ---------- | ---------------------- | | channel | String | [A-Z] | Y | This will be supplied with your authentication credentials. | | payments | Array | [String, String] | Y | An array listing all payments made for this booking. | | amount | String | [0-9] | Y | The price (in pence) to be refunded. |## Refund ResponseFor a detailed explanation of the fields returned, please see below: | Field | Additional Information | | ----- | ---------------------- | | amount | The amount that has been refunded | | status | The status of the refund | | error | The error if the refund fails |## ExamplesBelow are examples of both the request and response for a refund.### Refund Request**POST**  `https://payment-gateway.holidayextras.co.uk/refund`**HEADERS** `Content-Type: application/json` `Accept: application/vnd.holidayextras.v1+json` `Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=````{  \"channel\": \"channel\",  \"payments\": [\"testPaymentId1\", \"testPaymentId2\"],  \"amount\": \"1234\"}```### Refund Response#### Successful Refund```{    \"amount\": 12.34,    \"id\": \"REFUND-testPaymentId1\",    \"status\": \"SUCCESS\"}```#### Failed Refund```{    \"amount\": 12.34,    \"status\": \"FAIL\",    \"error\": \"Failed making refund\"}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/payment-gateway/v1/refund/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "hxapi-request24": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "Amend-no-reprice",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "# Amend-no-repriceThis must be a POST, as you are amending a booking. It must be made over HTTPS, you must enforce this.Unlike the normal amend process, you will not be asked for confirmation before completing this. There is only one request to send for amend-no-reprice## /booking/YourBookingRef### MethodPOST### Parameters | Name           | Data Type | Format     | Required | | ----           | --------- | ------     | -------- | | StartCustomer  | String    | [0-9]{6}   | Y        | | BusinessUnit   | String    | [0-9]{3}   | Y        | | Operator       | String    | [A-Z]{3}   | Y        | | BookingRef     | String    | [A-Z0-9] {5,12} | Y        | | ReturnFlight   |           | [A-Z0-9] {10} | N        | | Remarks        | String    | [A-Z0-9] {60} | N        | | Pax            | Number    | [0-9] {2} | N        | | Registration   | String    | [A-Z0-9] {20} | Y        | | CarMake        | String    | [A-Z0-9] {20} | N        | | CarModel       | String    | [A-Z0-9] {20} | N        | | CarColour      | String    | [A-Z0-9] {20} | N        | | OutFltNo       | String    | [A-Z0-9] {10} | N        | | InFltNo        | String    | [A-Z0-9] {10} | N        | | OutFltTime     | Number    | HHMM       | N        | | InFltTime      | Number    | HHMM       | N        | | OutTerminal    |           | [A-Z0-9] {4} | N        | | RetTerminal    |           | [A-Z0-9] {4} | N        | | ShipName       |           | [A-Z0-9] {20} | N        | | PierName       |           | [A-Z0-9] {20} | N        | | ChildSeat      | Boolean   | [Y/N] | N        | | AddlServices   | Boolean   | [Y/N]| N        | | MobileNum      |           | [A-Z0-9] {15} | N        | | CarDropoffTime | Number    | HHMM       | N        | | CarPickupTime  | Number    | HHMM       | N        | | Title          | String    | [A-Z] {4}| Y        | | Initial        | String    | [A-Z] {1} | Y        | | Surname        | String    | [A-Z] {15} | Y        | | Address        | Striing   | [A-Z0-9] {25} | N        | | Town           | String    | [A-Z0-9] {20} | N        | | County         | String    | [A-Z0-9] {20} | N        | | PostCode       | String    | [A-Z0-9] {10} | N        | | DayPhone       |           | [A-Z0-9] {20} | N        | | EvePhone       |           | [A-Z0-9] {20} | N        | | Confirmation   | Boolean   | [Y/N]      | Y        | | DataProtection | Boolean   | [Y/N] | N        | | Email          | String    | [A-Z0-9] {50}| N        | | InvoiceReqd    | Boolean   | [Y/N]| N        | | TaxType        | String    | [A-Z0-9] {2} | N        | | TaxLocation    | String    | [A-Z0-9] {3} | N        | | InvLanguage    | String    | [A-Z0-9] {2} | N        | | InvHouseNo     | Integer   | [0-9] {4}    | N        | | InvCountry     | String    | [A-Z0-9] {20} | N        | | InvStreet      | String    | [A-Z0-9] {20} | N        | | InvTown        | String    | [A-Z0-9] {20} | N        | | InvPostcode    | String    | [A-Z0-9] {10} | N        | | InvCompany     | String    | [A-Z0-9] {40} | N        | | CustVATNo      | String    | [A-Z0-9] {10} | N        | | SupplierVATId  | String    | [A-Z0-9] {15} | N        | | InvTitle      | String    | [A-Z0-9] {4} | N        | | InvFirstName      | String    | [A-Z0-9] {20} | N        | | InvSurname      | String    | [A-Z0-9] {15} | N        | | InvEmail      | String    | [A-Z0-9] {50} | N        |### Requestsznt -> api```https://api.holidayextras.com/de-start/sandbox/v1/booking/10524994/?BookingRef=FBKM6&BusinessUnit=001&CarDropoffTime=1200&CarPickupTime=1300&Confirmation=Y&County=testcountyaenderung&Email=test.email&Initial=T&Operator=BJT&Remarks=test&Surname=Testnameaenderung&Title=Herr&TraveltainmentCustomer=111111&holidayextras.com=&key=YourKey```api -> chauntry```xml            111111        001        BJT        Y                FBKM6                        test                                                                                                                                                1200        1300                Herr        T        Testnameaenderung                testcountyaenderung                                Y                test.email                                                Herr        T        Testnameaenderung                                                                test.email    ```chauntry -> api```xml            111111        001        BJT        Y                FBKM6                        TEST                                                                                                                                                1200        1300                HERR        T        TESTNAMEAENDERUNG                TESTCOUNTYAENDERUNG                                Y                test.email                                                HERR        T        TESTNAMEAENDERUNG                                                                TOM.PRICE                            FBKM6            001            1200            1300            Y            testcountyaenderung            test.email            T            BJT            test            Testnameaenderung            Herr            111111                        YourKey            de            ABG            ```api -> zntNote this is the same as request chauntry -> api```xml            111111        001        BJT        Y                FBKM6                        TEST                                                                                                                                                1200        1300                HERR        T        TESTNAMEAENDERUNG                TESTCOUNTYAENDERUNG                                Y                test.email                                                HERR        T        TESTNAMEAENDERUNG                                                                TOM.PRICE                            FBKM6            001            1200            1300            Y            testcountyaenderung            test.email            T            BJT            test            Testnameaenderung            Herr            111111                        YourKey            de            ABG            ```### Request Fields ExplainedAny fields sent through in the level 24 request will amend what is saved to chipsFields include:BookingRef - Reference of the booking which is to be amendedAddress - An array of address lines to replace the current addressPax - Number of passengers#### Invoice Only Fieldslang - Language for the invoiceHouseNumberCountryCompanyCustomerVAT",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -505,13 +505,6 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      "hxapi-transfers-view": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "title": "Transfers View Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "content": "# Transfers View Booking## Important Notes- This endpoint provides comprehensive booking details including journey information, contact numbers, and cancellation policies- Use this endpoint to retrieve up-to-date booking status and transfer details- The response includes both outbound and return transfer information (if applicable)## View Booking Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/booking/[BookingRef]```Where ```[BookingRef]``` is the booking reference you received when making the original booking.For example:```https://api.holidayextras.com/v1/transfers/booking/TBBGNHMT```### Request ParametersNB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                       ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                  || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                            || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                          || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                   |## View Booking ResponseIf the booking is found, the response will contain detailed information about the transfer booking including journey details, cancellation policy, and contact information.For a detailed explanation of the fields returned, please see below:| Field                                     | Additional Information                                                                                                                                     ||-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                        | The reference for the booking.                                                                                                                             || Booking/SupplierRef                       | Reference number provided by the transfer supplier (for the overall booking).                                                                              || Booking/Status                            | Current status of the booking (e.g., Confirmed, Pending, Cancelled).                                                                                      || Booking/DateBooked                        | Date and time when the booking was made (ISO 8601 format, UTC timezone).                                                                                  || Booking/DateCancelled                     | Date and time when the booking was cancelled, if applicable (ISO 8601 format, UTC timezone).                                                              || Booking/Email                             | Email address associated with the booking.                                                                                                                 || Booking/Product/Price                     | Total price for the transfer booking.                                                                                                                      || Booking/Product/Currency                  | Currency in which the price is denominated.                                                                                                                || Booking/Product/Category                  | Category of the transfer product. See [Transfer Categories](/hxapi/transfers/av/#transfer-categories) for available options.                              || Booking/Product/TransferCode              | Unique code for the transfer product.                                                                                                                      || Booking/Product/Cancellation             | Cancellation policy details including period (in hours), percentage, and fee. For full cancellation details including refund calculations, use the [Cancellation Policy](/hxapi/transfers/cancellation-policy/) endpoint. || Booking/Product/VehicleDetails           | Details about the vehicle including capacity, stops, bags allowed, and whether it's private.                                                               || Booking/Product/OutboundTransfer         | Details of the outbound transfer journey including origin, destination, journey time, and pickup/arrival times.                                           || Booking/Product/ReturnTransfer           | Details of the return transfer journey (only present if the booking includes a return transfer).                                                           |### Transfer Details FieldsBoth `OutboundTransfer` and `ReturnTransfer` contain the following detailed information:| Field                | Additional Information                                                        ||----------------------|-------------------------------------------------------------------------------|| JourneyId            | Unique identifier for the transfer journey.                                  || SupplierRef          | Reference provided by the transfer supplier (specific to this journey leg). || Origin               | Starting point of the transfer.                                              || OriginAddress        | Address of the origin location.                                               || OriginIata           | IATA code of the origin location.                                             || Destination          | Destination point of the transfer.                                            || DestinationAddress   | Address of the destination location.                                          || DestinationIata      | IATA code of the destination location.                                        || JourneyTime          | Duration of the journey in minutes.                                           || FlightDetails        | Flight information associated with the transfer.                              || Pickup               | Pickup time for the transfer vehicle as an ISO 8601 timestamp in UTC (Zulu time). || InformationUrl       | URL with additional transfer information (when available from supplier).     || JoiningInstruction   | Instructions on where and how to join the transfer.                          || ContactNumbers       | Contact information including UkEmergencyTel, ReconfirmationTel, and EmergencyTel phone numbers. |### FlightDetails FieldsThe `FlightDetails` object contains flight information when the transfer is associated with a flight:| Field                                | Additional Information                                                        ||--------------------------------------|-------------------------------------------------------------------------------|| FlightDetails/Code                   | Flight number/code (e.g., \"U28605\").                                         || FlightDetails/Origin                 | Origin airport IATA code (e.g., \"LGW\").                                      || FlightDetails/Destination            | Destination airport IATA code (e.g., \"AGP\").                                 || FlightDetails/Departure              | Flight departure time as ISO 8601 timestamp in UTC (Zulu time).              || FlightDetails/Arrival                | Flight arrival time as ISO 8601 timestamp in UTC (Zulu time).                |**Important Notes:**- All timestamps use UTC timezone and are formatted as ISO 8601 with 'Z' suffix (e.g., \"2025-08-01T10:00:00Z\")- For airport pickup transfers, the `Arrival` time represents when passengers land and need pickup- For airport drop-off transfers, the `Departure` time represents the flight departure time, and the pickup time is automatically calculated to ensure passengers arrive at the airport with adequate time before their flight- The `FlightDetails` object and its individual fields can be null when flight information is not available or unknown### Example{% codetabs %}{% codetab XML %}```xml  TBBGNHMT  123456  Confirmed  2025-01-15T10:30:00Z    customer@example.com      103.52    GBP    private_car    TBHT1169922          24      100      0              1      4                  4      1      true      Transfer Company Ltd      Mercedes              OUT123456      ABC123      Málaga Airport      Málaga Airport, Málaga      AGP      Hotel Sol Marbella      Av. del Mar, 29600, Marbella            60              U28605        LGW        AGP                2025-08-01T10:00:00Z            2025-08-01T10:30:00Z      https://example.com/transfer-info      Meet at Terminal 3 Arrivals Hall              +44 20 7123 4567        +34 952 123 456        +34 952 999 888                    RET123456      DEF456      Hotel Sol Marbella      Av. del Mar, 29600, Marbella            Málaga Airport      Málaga Airport, Málaga      AGP      60              U28602        AGP        LGW        2025-08-07T13:30:00Z                    2025-08-07T10:00:00Z      https://example.com/transfer-info      Meet in hotel lobby 10 minutes before pickup              +44 20 7123 4567        +34 952 123 456        +34 952 999 888            ```{% endcodetab %}{% codetab JSON %}```json{  \"Booking\": {    \"BookingRef\": \"TBBGNHMT\",    \"SupplierRef\": 123456,    \"Status\": \"Confirmed\",    \"DateBooked\": \"2025-01-15T10:30:00Z\",    \"DateCancelled\": null,    \"Email\": \"customer@example.com\",    \"Product\": {      \"Price\": 103.52,      \"Currency\": \"GBP\",      \"Category\": \"private_car\",      \"TransferCode\": \"TBHT1169922\",      \"Cancellation\": {        \"Period\": 24,        \"Percentage\": 100,        \"Fee\": 0      },      \"VehicleDetails\": {        \"MinCapacity\": 1,        \"MaxCapacity\": 4,        \"MinStops\": \"\",        \"MaxStops\": \"\",        \"Bags\": 4,        \"NumberOfVehicles\": 1,        \"IsPrivate\": true,        \"Supplier\": \"Transfer Company Ltd\",        \"Make\": \"Mercedes\"      },      \"OutboundTransfer\": {        \"JourneyId\": \"OUT123456\",        \"SupplierRef\": \"ABC123\",        \"Origin\": \"Málaga Airport\",        \"OriginAddress\": \"Málaga Airport, Málaga\",        \"OriginIata\": \"AGP\",        \"Destination\": \"Hotel Sol Marbella\",        \"DestinationAddress\": \"Av. del Mar, 29600, Marbella\",        \"DestinationIata\": \"\",        \"JourneyTime\": 60,        \"FlightDetails\": {          \"Code\": \"U28605\",          \"Origin\": \"LGW\",          \"Destination\": \"AGP\",          \"Departure\": null,          \"Arrival\": \"2025-08-01T10:00:00Z\"        },        \"Pickup\": \"2025-08-01T10:30:00Z\",        \"InformationUrl\": \"https://example.com/transfer-info\",        \"JoiningInstruction\": \"Meet at Terminal 3 Arrivals Hall\",        \"ContactNumbers\": {          \"UkEmergencyTel\": \"+44 20 7123 4567\",          \"ReconfirmationTel\": \"+34 952 123 456\",          \"EmergencyTel\": \"+34 952 999 888\"        }      },      \"ReturnTransfer\": {        \"JourneyId\": \"RET123456\",        \"SupplierRef\": \"DEF456\",        \"Origin\": \"Hotel Sol Marbella\",        \"OriginAddress\": \"Av. del Mar, 29600, Marbella\",        \"OriginIata\": \"\",        \"Destination\": \"Málaga Airport\",        \"DestinationAddress\": \"Málaga Airport, Málaga\",        \"DestinationIata\": \"AGP\",        \"JourneyTime\": 60,        \"FlightDetails\": {          \"Code\": \"U28602\",          \"Origin\": \"AGP\",          \"Destination\": \"LGW\",          \"Departure\": \"2025-08-07T13:30:00Z\",          \"Arrival\": null        },        \"Pickup\": \"2025-08-07T10:00:00Z\",        \"InformationUrl\": \"https://example.com/transfer-info\",        \"JoiningInstruction\": \"Meet in hotel lobby 10 minutes before pickup\",        \"ContactNumbers\": {          \"UkEmergencyTel\": \"+44 20 7123 4567\",          \"ReconfirmationTel\": \"+34 952 123 456\",          \"EmergencyTel\": \"+34 952 999 888\"        }      }    }  }}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -        "url": "/hxapi/transfers/view/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          -    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "hxapi-viewamendcancel-view": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "View Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "# View Booking[API Docs](/hxapi/) > product:[view](/hxapi/viewamendcancel/view)## View Booking RequestThis method works for bookings made for any product type using our API.### MethodGET### EndpointThe endpoint to use is (where `YourBookingRef` is the Holiday Extras booking reference):{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}### Request ParametersNB: All parameter names are case sensitive.| Name       | Data Type | Format            | Mandatory? | Additional Information                                                                                                                                          ||------------|-----------|-------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber | String    | [A-Z0-9] 5 chars  | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                 || Password   | String    | [A-Z0-9] 5 chars  | N*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up. || Initials   | String    | [A-Z] 3 chars     | N          | The initials of the Operator / Agent.                                                                                                                           || key        | String    | [A-Z]             | Y          | This will be assigned to you by your Account Manager during set up.                                                                                             || Email      | String    | [A-Z0-9] 50 chars | Y          | Email address used to make the booking (i.e. the email address of the lead passenger)                                                                           || System     | String    | [A-Z] 3 chars     | Y*         | For European products, you need to pass in the value of `System=ABG` (the default is `System=ABC`, which is UK products only).                                  |## View Booking ResponseThe view booking response will return all of the details against that booking record in our system.For a detailed explanation of the fields returned, please see below:| Field                                          | Additional Information                                                                                                                                                                                        ||------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                             | This is the reference for this booking. It must be referred to in all communication with us concerning this booking. NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q). || Booking/Amendable                              | This will return one of the following: `Y` = booking can be amended; `N` = booking cannot be amended; `C` = booking has been cancelled; `S` = booking is same day so cannot be amended or cancelled.          || Booking/CanxDate                               | If the booking has been cancelled, the date on which it was will return here.                                                                                                                                 || Booking/AgentComm                              | Commission you have earned from this booking.                                                                                                                                                                 || Booking/BookingDate                            | The date the booking was originally made on.                                                                                                                                                                  || Booking/PdfURL                                 | ⚠ Deprecated: This feature provided a link to generate a PDF version of the booking confirmation. It is no longer supported and will be removed in future releases.                                           || Itinerary                                      | This block will return details of the original booking, as per the booking response for each product type. Please see the respective booking guides for further details on the fields.                        || ClientDetails                                  | This block will return details of the lead passenger.                                                                                                                                                         || Pricing                                        | This block will return details of the price paid by the customer.                                                                                                                                             || VAT                                            | Please ignore this block.                                                                                                                                                                                     || CustRef                                        | If you have passed in a Customer Reference with your original booking request, it will return here.                                                                                                           || BarCode                                        | A link to generate a bar code for the booking confirmation.                                                                                                                                                   || QRCodeValue                                    | (EU only) Value of the QR code that comes with email confirmation. [More details about QR Code](/hxapi/barcode#qr_code)                                                                                       || QRCodeValueStr                                 | (EU only) Value of the QR code that comes with email confirmation. [More details about QR Code](/hxapi/barcode#qr_code)                                                                                       || SupplierRef                                    | (EU only) External booking id booking                                                                                                                                                                         || CurrentSupplements[]                           | Array of upgrades on the booking                                                                                                                                                                              || CurrentSupplements/Supplement/Code             | Upgrade product code                                                                                                                                                                                          || CurrentSupplements/Supplement/Price            | The price paid for the upgrade                                                                                                                                                                                || CurrentSupplements/Supplement/NonDiscPrice     | The price of the upgrade before any discounts                                                                                                                                                                 || CurrentSupplements/Supplement/DiscAmt          | The value of any discount applied                                                                                                                                                                             || CurrentSupplements/Supplement/Supplier         | Code for the supplier of the upgrade                                                                                                                                                                          || CurrentSupplements/Supplement/Rule             | Internal field                                                                                                                                                                                                || CurrentSupplements/Supplement/Req              | The purchased quantity of the upgrade                                                                                                                                                                         || CurrentSupplements/Supplement/Per              | The pricing basis of the upgrade                                                                                                                                                                              || CurrentSupplements/Supplement/Adults           | The number of adult passes purchased                                                                                                                                                                          || CurrentSupplements/Supplement/Children         | The number of chlid passes purchased                                                                                                                                                                          || CurrentSupplements/Supplement/Date             | The date of use for the upgrade                                                                                                                                                                               || CurrentSupplements/Supplement/Canx             | Whether the upgrade is cancellable                                                                                                                                                                            || CurrentSupplements/Supplement/Remarks          | Notes field. Used to store arrival time for lounge upgrades                                                                                                                                                   || AvailableSupplements[]                         | Array of upgrades available to purchase post booking                                                                                                                                                          || AvailableSupplements/Supplement/Code           | Upgrade product code                                                                                                                                                                                          || AvailableSupplements/Supplement/Supplier       | Code for the supplier of the upgrade                                                                                                                                                                          || AvailableSupplements/Supplement/Per            | The pricing basis of the upgrade                                                                                                                                                                              || AvailableSupplements/Supplement/Canx           | Whether the upgrade is cancellable                                                                                                                                                                            || AvailableSupplements/Supplement/Name           | The name of the upgrade product                                                                                                                                                                               || AvailableSupplements/Supplement/Price          | The price of the upgrade                                                                                                                                                                                      || AvailableSupplements/Supplement/NonDiscPrice   | The price of the upgrade before any discounts                                                                                                                                                                 || AvailableSupplements/Supplement/DiscAmt        | The value of any discount applied                                                                                                                                                                             || AvailableSupplements/Supplement/AdPrice        | The per adult price minus any discounts. Only present for per person upgrades                                                                                                                                 || AvailableSupplements/Supplement/NonDiscAdPrice | The per adult price before any discounts. Only present for per person upgrades                                                                                                                                || AvailableSupplements/Supplement/AdDiscAmt      | The amount of discount applied to the per adult price. Only present for per person upgrades                                                                                                                   || AvailableSupplements/Supplement/ChPrice        | The per child price minus any discounts. Only present for per person upgrades                                                                                                                                 || AvailableSupplements/Supplement/NonDiscChPrice | The per child price before any discounts. Only present for per person upgrades                                                                                                                                || AvailableSupplements/Supplement/ChDiscAmt      | The amount of discount applied to the child price. Only present for per person upgrades                                                                                                                       || AvailableSupplements/Supplement/PerNight       | Whether the upgrade is charged per night of a stay                                                                                                                                                            || API_Header/Request                             | A list of parameters that were sent in the view booking request.                                                                                                                                              || Booking/Status  (Future)                       | Indicates the current status of the booking (`Pending`, `Confirmed`, `Cancelled`, or `Error`).                                                                                                                |#### /Booking/AmendablePossible values*  Y - booking can be amended or cancelled*  N - booking cannot be amended or cancelled (advance purchase product etc)*  C - booking has been cancelled## Worked ExamplesBelow are worked examples of both the request and response for view a booking.### UK Products View Booking (for a car park)#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_view_uk_booking_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_view_uk_booking_response.json %}```{% endcodetab %}{% endcodetabs %}---### UK Products View Booking (for a transfer)#### Request{% codetabs %}{% codetab XML %}```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```{% endcodetab %}{% codetab JSON %}```https://api.holidayextras.com/v1/booking/YourBookingRef.js?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com```Note the `.js` extension.{% endcodetab %}{% endcodetabs %}#### Response{% codetabs %}{% codetab XML %}```xml{% include_relative examples/_view_uk_transfers_booking_response.xml %}```{% endcodetab %}{% codetab JSON %}```json{% include_relative examples/_view_uk_transfers_booking_response.json %}```{% endcodetab %}{% endcodetabs %}---### European Products View Booking (for a hotel room only)#### Request```https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&Password=YourPassword&Initials=YourInitials&key=YourKey&Email=test@test.com&System=ABG```#### Response```xml{% include_relative examples/_view_eu_booking_response.xml %}```",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          @@ -519,6 +512,13 @@
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      "hxapi-transfers-view": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "title": "Transfers View Booking",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "content": "# Transfers View Booking## Important Notes- This endpoint provides comprehensive booking details including journey information, contact numbers, and cancellation policies- Use this endpoint to retrieve up-to-date booking status and transfer details- The response includes both outbound and return transfer information (if applicable)## View Booking Request### MethodGET### EndpointThe endpoint to use is:```https://api.holidayextras.com/v1/transfers/booking/[BookingRef]```Where ```[BookingRef]``` is the booking reference you received when making the original booking.For example:```https://api.holidayextras.com/v1/transfers/booking/TBBGNHMT```### Request ParametersNB: All parameter names are case sensitive.| Name               | Data Type | Format           | Mandatory? | Additional Information                                                                                                                                                                                                                                                                       ||--------------------|-----------|------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|| ABTANumber         | String    | [A-Z0-9] 5 chars | Y          | This is also known as an 'agent code'. This will be confirmed to you by your Account Manager during set up.                                                                                                                                                                                  || Password           | String    | [A-Z0-9] 5 chars | Y*         | Password required for retail agent requests - intermediaries do not require a password.This will be confirmed to you by your Account Manager during set up.                                                                                                                            || key                | String    | [A-Z]            | Y          | This will be assigned to you by your Account Manager during set up.                                                                                                                                                                                                                          || token              | String    | [0-9] 9 chars    | Y          | Please see [user token endpoint](/hxapi/usertoken) for details of how to generate a token.                                                                                                                                                                                                   |## View Booking ResponseIf the booking is found, the response will contain detailed information about the transfer booking including journey details, cancellation policy, and contact information.For a detailed explanation of the fields returned, please see below:| Field                                     | Additional Information                                                                                                                                     ||-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|| Booking/BookingRef                        | The reference for the booking.                                                                                                                             || Booking/SupplierRef                       | Reference number provided by the transfer supplier (for the overall booking).                                                                              || Booking/Status                            | Current status of the booking (e.g., Confirmed, Pending, Cancelled).                                                                                      || Booking/DateBooked                        | Date and time when the booking was made (ISO 8601 format, UTC timezone).                                                                                  || Booking/DateCancelled                     | Date and time when the booking was cancelled, if applicable (ISO 8601 format, UTC timezone).                                                              || Booking/Email                             | Email address associated with the booking.                                                                                                                 || Booking/Product/Price                     | Total price for the transfer booking.                                                                                                                      || Booking/Product/Currency                  | Currency in which the price is denominated.                                                                                                                || Booking/Product/Category                  | Category of the transfer product. See [Transfer Categories](/hxapi/transfers/av/#transfer-categories) for available options.                              || Booking/Product/TransferCode              | Unique code for the transfer product.                                                                                                                      || Booking/Product/Cancellation             | Cancellation policy details including period (in hours), percentage, and fee. For full cancellation details including refund calculations, use the [Cancellation Policy](/hxapi/transfers/cancellation-policy/) endpoint. || Booking/Product/VehicleDetails           | Details about the vehicle including capacity, stops, bags allowed, and whether it's private.                                                               || Booking/Product/OutboundTransfer         | Details of the outbound transfer journey including origin, destination, journey time, and pickup/arrival times.                                           || Booking/Product/ReturnTransfer           | Details of the return transfer journey (only present if the booking includes a return transfer).                                                           |### Transfer Details FieldsBoth `OutboundTransfer` and `ReturnTransfer` contain the following detailed information:| Field                | Additional Information                                                        ||----------------------|-------------------------------------------------------------------------------|| JourneyId            | Unique identifier for the transfer journey.                                  || SupplierRef          | Reference provided by the transfer supplier (specific to this journey leg). || Origin               | Starting point of the transfer.                                              || OriginAddress        | Address of the origin location.                                               || OriginIata           | IATA code of the origin location.                                             || Destination          | Destination point of the transfer.                                            || DestinationAddress   | Address of the destination location.                                          || DestinationIata      | IATA code of the destination location.                                        || JourneyTime          | Duration of the journey in minutes.                                           || FlightDetails        | Flight information associated with the transfer.                              || Pickup               | Pickup time for the transfer vehicle as an ISO 8601 timestamp in UTC (Zulu time). || InformationUrl       | URL with additional transfer information (when available from supplier).     || JoiningInstruction   | Instructions on where and how to join the transfer.                          || ContactNumbers       | Contact information including UkEmergencyTel, ReconfirmationTel, and EmergencyTel phone numbers. |### FlightDetails FieldsThe `FlightDetails` object contains flight information when the transfer is associated with a flight:| Field                                | Additional Information                                                        ||--------------------------------------|-------------------------------------------------------------------------------|| FlightDetails/Code                   | Flight number/code (e.g., \"U28605\").                                         || FlightDetails/Origin                 | Origin airport IATA code (e.g., \"LGW\").                                      || FlightDetails/Destination            | Destination airport IATA code (e.g., \"AGP\").                                 || FlightDetails/Departure              | Flight departure time as ISO 8601 timestamp in UTC (Zulu time).              || FlightDetails/Arrival                | Flight arrival time as ISO 8601 timestamp in UTC (Zulu time).                |**Important Notes:**- All timestamps use UTC timezone and are formatted as ISO 8601 with 'Z' suffix (e.g., \"2025-08-01T10:00:00Z\")- For airport pickup transfers, the `Arrival` time represents when passengers land and need pickup- For airport drop-off transfers, the `Departure` time represents the flight departure time, and the pickup time is automatically calculated to ensure passengers arrive at the airport with adequate time before their flight- The `FlightDetails` object and its individual fields can be null when flight information is not available or unknown### Example{% codetabs %}{% codetab XML %}```xml  TBBGNHMT  123456  Confirmed  2025-01-15T10:30:00Z    customer@example.com      103.52    GBP    private_car    TBHT1169922          24      100      0              1      4                  4      1      true      Transfer Company Ltd      Mercedes              OUT123456      ABC123      Málaga Airport      Málaga Airport, Málaga      AGP      Hotel Sol Marbella      Av. del Mar, 29600, Marbella            60              U28605        LGW        AGP                2025-08-01T10:00:00Z            2025-08-01T10:30:00Z      https://example.com/transfer-info      Meet at Terminal 3 Arrivals Hall              +44 20 7123 4567        +34 952 123 456        +34 952 999 888                    RET123456      DEF456      Hotel Sol Marbella      Av. del Mar, 29600, Marbella            Málaga Airport      Málaga Airport, Málaga      AGP      60              U28602        AGP        LGW        2025-08-07T13:30:00Z                    2025-08-07T10:00:00Z      https://example.com/transfer-info      Meet in hotel lobby 10 minutes before pickup              +44 20 7123 4567        +34 952 123 456        +34 952 999 888            ```{% endcodetab %}{% codetab JSON %}```json{  \"Booking\": {    \"BookingRef\": \"TBBGNHMT\",    \"SupplierRef\": 123456,    \"Status\": \"Confirmed\",    \"DateBooked\": \"2025-01-15T10:30:00Z\",    \"DateCancelled\": null,    \"Email\": \"customer@example.com\",    \"Product\": {      \"Price\": 103.52,      \"Currency\": \"GBP\",      \"Category\": \"private_car\",      \"TransferCode\": \"TBHT1169922\",      \"Cancellation\": {        \"Period\": 24,        \"Percentage\": 100,        \"Fee\": 0      },      \"VehicleDetails\": {        \"MinCapacity\": 1,        \"MaxCapacity\": 4,        \"MinStops\": \"\",        \"MaxStops\": \"\",        \"Bags\": 4,        \"NumberOfVehicles\": 1,        \"IsPrivate\": true,        \"Supplier\": \"Transfer Company Ltd\",        \"Make\": \"Mercedes\"      },      \"OutboundTransfer\": {        \"JourneyId\": \"OUT123456\",        \"SupplierRef\": \"ABC123\",        \"Origin\": \"Málaga Airport\",        \"OriginAddress\": \"Málaga Airport, Málaga\",        \"OriginIata\": \"AGP\",        \"Destination\": \"Hotel Sol Marbella\",        \"DestinationAddress\": \"Av. del Mar, 29600, Marbella\",        \"DestinationIata\": \"\",        \"JourneyTime\": 60,        \"FlightDetails\": {          \"Code\": \"U28605\",          \"Origin\": \"LGW\",          \"Destination\": \"AGP\",          \"Departure\": null,          \"Arrival\": \"2025-08-01T10:00:00Z\"        },        \"Pickup\": \"2025-08-01T10:30:00Z\",        \"InformationUrl\": \"https://example.com/transfer-info\",        \"JoiningInstruction\": \"Meet at Terminal 3 Arrivals Hall\",        \"ContactNumbers\": {          \"UkEmergencyTel\": \"+44 20 7123 4567\",          \"ReconfirmationTel\": \"+34 952 123 456\",          \"EmergencyTel\": \"+34 952 999 888\"        }      },      \"ReturnTransfer\": {        \"JourneyId\": \"RET123456\",        \"SupplierRef\": \"DEF456\",        \"Origin\": \"Hotel Sol Marbella\",        \"OriginAddress\": \"Av. del Mar, 29600, Marbella\",        \"OriginIata\": \"\",        \"Destination\": \"Málaga Airport\",        \"DestinationAddress\": \"Málaga Airport, Málaga\",        \"DestinationIata\": \"AGP\",        \"JourneyTime\": 60,        \"FlightDetails\": {          \"Code\": \"U28602\",          \"Origin\": \"AGP\",          \"Destination\": \"LGW\",          \"Departure\": \"2025-08-07T13:30:00Z\",          \"Arrival\": null        },        \"Pickup\": \"2025-08-07T10:00:00Z\",        \"InformationUrl\": \"https://example.com/transfer-info\",        \"JoiningInstruction\": \"Meet in hotel lobby 10 minutes before pickup\",        \"ContactNumbers\": {          \"UkEmergencyTel\": \"+44 20 7123 4567\",          \"ReconfirmationTel\": \"+34 952 123 456\",          \"EmergencyTel\": \"+34 952 999 888\"        }      }    }  }}```{% endcodetab %}{% endcodetabs %}",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +        "url": "/hxapi/transfers/view/"
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      }
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +      ,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          +    
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 "assets-main-css": {
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "title": "",
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   "content": "@import \"minima\";",