diff --git a/docs/feed.xml b/docs/feed.xml
index eda83059..075da236 100644
--- a/docs/feed.xml
+++ b/docs/feed.xml
@@ -1,2 +1,2 @@
-<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.9.3">Jekyll</generator><link href="/feed.xml" rel="self" type="application/atom+xml" /><link href="/" rel="alternate" type="text/html" /><updated>2026-03-16T10:01:34+00:00</updated><id>/feed.xml</id><title type="html">Holiday Extras API</title><subtitle>Documentation to give to partners who would like to integrate with our API.
+<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.9.3">Jekyll</generator><link href="/feed.xml" rel="self" type="application/atom+xml" /><link href="/" rel="alternate" type="text/html" /><updated>2026-03-18T14:05:13+00:00</updated><id>/feed.xml</id><title type="html">Holiday Extras API</title><subtitle>Documentation to give to partners who would like to integrate with our API.
 </subtitle></feed>
\ No newline at end of file
diff --git a/docs/hxapi/asynchronous-bookings/index.html b/docs/hxapi/asynchronous-bookings/index.html
index 7f8b6c52..6acf5ade 100644
--- a/docs/hxapi/asynchronous-bookings/index.html
+++ b/docs/hxapi/asynchronous-bookings/index.html
@@ -85,7 +85,7 @@ <h3 id="availability-request">Availability Request</h3>
 
 <h3 id="uk-products-availability-request">UK Products Availability Request</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#2818577e-55f2-4c6d-b183-e831657b2183'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#f0169653-8628-4118-b34d-87f6ad189158'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -93,7 +93,7 @@ <h3 id="uk-products-availability-request">UK Products Availability Request</h3>
 
 </ul>
 
-<ul id="2818577e-55f2-4c6d-b183-e831657b2183" class="uk-switcher uk-margin">
+<ul id="f0169653-8628-4118-b34d-87f6ad189158" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/carpark/LGW?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;Initials=YourInitials&amp;key=YourKey&amp;token=YourToken&amp;ArrivalDate=2025-01-07&amp;ArrivalTime=1200&amp;DepartDate=2025-01-08&amp;DepartTime=1200&amp;NumberOfPax=1&amp;includeAsyncOnlyProducts=true
@@ -110,7 +110,7 @@ <h3 id="uk-products-availability-request">UK Products Availability Request</h3>
 
 <h3 id="european-products-availability-request">European Products Availability Request</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#67fe7cd9-5dbb-4951-9525-13f50a761139'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#e9961bbc-eeff-487c-a5f9-b87da6adf407'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -118,7 +118,7 @@ <h3 id="european-products-availability-request">European Products Availability R
 
 </ul>
 
-<ul id="67fe7cd9-5dbb-4951-9525-13f50a761139" class="uk-switcher uk-margin">
+<ul id="e9961bbc-eeff-487c-a5f9-b87da6adf407" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/carpark/MUC?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;Initials=YourInitials&amp;key=YourKey&amp;token=YourToken&amp;ArrivalDate=2025-12-01&amp;ArrivalTime=1200&amp;DepartDate=2025-12-08&amp;DepartTime=1200&amp;NumberOfPax=1&amp;System=ABG&amp;lang=en&amp;includeAsyncOnlyProducts=true
diff --git a/docs/hxapi/carhire/availability/index.html b/docs/hxapi/carhire/availability/index.html
index 4ea5ce12..f9790cb4 100644
--- a/docs/hxapi/carhire/availability/index.html
+++ b/docs/hxapi/carhire/availability/index.html
@@ -61,7 +61,7 @@ <h2 id="request">Request</h2>
 </code></pre></div></div>
 
 <p>Example request:</p>
-<ul class="uk-tab" data-uk-switcher="{connect:'#e77f6661-718b-4bf1-bd84-2de01ee9e3a0'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#debd14ed-68de-4829-a574-abd71932d5e7'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -69,7 +69,7 @@ <h2 id="request">Request</h2>
 
 </ul>
 
-<ul id="e77f6661-718b-4bf1-bd84-2de01ee9e3a0" class="uk-switcher uk-margin">
+<ul id="debd14ed-68de-4829-a574-abd71932d5e7" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/sandbox/carHire/products?key=1&amp;From=06NOV16&amp;ArrivalTime=1200&amp;To=13NOV&amp;DepartTime=1600&amp;PickupLocation=FL965&amp;DropoffLocation=FL965&amp;DateOfBirth=1990-10-13
diff --git a/docs/hxapi/parking/av/airport/index.html b/docs/hxapi/parking/av/airport/index.html
index 8a8bdebf..56686554 100644
--- a/docs/hxapi/parking/av/airport/index.html
+++ b/docs/hxapi/parking/av/airport/index.html
@@ -57,7 +57,7 @@ <h3 id="endpoint">Endpoint</h3>
 
 <p>For example, for London Gatwick the endpoint is:</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#1c5db3ad-1f9d-4c91-9986-90febac1572e'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#c153ae1e-8aa8-48eb-a6f5-9c01055c81f3'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -65,7 +65,7 @@ <h3 id="endpoint">Endpoint</h3>
 
 </ul>
 
-<ul id="1c5db3ad-1f9d-4c91-9986-90febac1572e" class="uk-switcher uk-margin">
+<ul id="c153ae1e-8aa8-48eb-a6f5-9c01055c81f3" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/carpark/LGW
@@ -452,7 +452,7 @@ <h2 id="worked-examples">Worked Examples</h2>
 
 <h3 id="uk-products-availability-request">UK Products Availability Request</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#d245ff8e-888c-4449-b0d7-b6b99fed8001'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#afaf0b8b-9dbf-48db-b34c-0104f6746190'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -460,7 +460,7 @@ <h3 id="uk-products-availability-request">UK Products Availability Request</h3>
 
 </ul>
 
-<ul id="d245ff8e-888c-4449-b0d7-b6b99fed8001" class="uk-switcher uk-margin">
+<ul id="afaf0b8b-9dbf-48db-b34c-0104f6746190" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/carpark/LGW?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;Initials=YourInitials&amp;key=YourKey&amp;token=YourToken&amp;ArrivalDate=2020-01-07&amp;ArrivalTime=1200&amp;DepartDate=2020-01-08&amp;DepartTime=1200&amp;NumberOfPax=1
@@ -479,7 +479,7 @@ <h3 id="uk-products-availability-response">UK Products Availability Response</h3
 
 <p>NB: This is a shortened example compiled from a full availability response.</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#0e8d4edc-1005-412b-824e-2f4f4ae9e4c6'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#5c04ce41-5434-4860-a8c2-d8bc23a26b0b'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -487,7 +487,7 @@ <h3 id="uk-products-availability-response">UK Products Availability Response</h3
 
 </ul>
 
-<ul id="0e8d4edc-1005-412b-824e-2f4f4ae9e4c6" class="uk-switcher uk-margin">
+<ul id="5c04ce41-5434-4860-a8c2-d8bc23a26b0b" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
@@ -715,7 +715,7 @@ <h3 id="uk-products-availability-response">UK Products Availability Response</h3
 
 <h3 id="european-products-availability-request">European Products Availability Request</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#0e67001d-5114-46eb-b738-6a17ed84249f'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#8ba86e35-e83e-4b69-a63e-d790e34860c8'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -723,7 +723,7 @@ <h3 id="european-products-availability-request">European Products Availability R
 
 </ul>
 
-<ul id="0e67001d-5114-46eb-b738-6a17ed84249f" class="uk-switcher uk-margin">
+<ul id="8ba86e35-e83e-4b69-a63e-d790e34860c8" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/carpark/MUC?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;Initials=YourInitials&amp;key=YourKey&amp;token=YourToken&amp;ArrivalDate=2017-12-01&amp;ArrivalTime=1200&amp;DepartDate=2017-12-08&amp;DepartTime=1200&amp;NumberOfPax=1&amp;System=ABG&amp;lang=en
@@ -742,7 +742,7 @@ <h3 id="european-products-availability-response">European Products Availability
 
 <p>NB: This is a shortened example compiled from a full availability response.</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#2e177e5c-c9cc-4828-bd11-e65e84e8d475'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#2b55c96a-0345-4da5-9ddb-508086632717'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -750,7 +750,7 @@ <h3 id="european-products-availability-response">European Products Availability
 
 </ul>
 
-<ul id="2e177e5c-c9cc-4828-bd11-e65e84e8d475" class="uk-switcher uk-margin">
+<ul id="2b55c96a-0345-4da5-9ddb-508086632717" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
diff --git a/docs/hxapi/productlibrary/index.html b/docs/hxapi/productlibrary/index.html
index f5a5da13..c1dab506 100644
--- a/docs/hxapi/productlibrary/index.html
+++ b/docs/hxapi/productlibrary/index.html
@@ -91,7 +91,7 @@ <h2 id="available-fields">Available Fields</h2>
 
 <p>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.</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#9a17020a-da1f-44f9-a49d-1e23be09c2e1'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#4c2a014c-1045-48ae-9f85-fd098c3e15d8'}">
 
 	<li class="uk-active"><a href="#">Parking</a></li>
 
@@ -105,7 +105,7 @@ <h2 id="available-fields">Available Fields</h2>
 
 </ul>
 
-<ul id="9a17020a-da1f-44f9-a49d-1e23be09c2e1" class="uk-switcher uk-margin">
+<ul id="4c2a014c-1045-48ae-9f85-fd098c3e15d8" class="uk-switcher uk-margin">
 
 	<li>
 <h4 id="recommended">Recommended</h4>
@@ -976,7 +976,7 @@ <h3 id="example-1---default-response">Example 1 - Default Response</h3>
 
 <h4 id="request">Request</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#c2822bcb-ccb8-476d-8faa-59d530f667b1'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#7e39202b-0721-470b-a906-91dc39f199f9'}">
 
 	<li class="uk-active"><a href="#">Live (XML)</a></li>
 
@@ -988,7 +988,7 @@ <h4 id="request">Request</h4>
 
 </ul>
 
-<ul id="c2822bcb-ccb8-476d-8faa-59d530f667b1" class="uk-switcher uk-margin">
+<ul id="7e39202b-0721-470b-a906-91dc39f199f9" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&amp;key=mytestkey
@@ -1016,7 +1016,7 @@ <h4 id="request">Request</h4>
 
 <h4 id="response">Response</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#1daf7fa5-c05b-4ad0-b96d-39a788223f27'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#d65c1b34-5014-4dd1-968b-ebd9796ffbe4'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -1024,7 +1024,7 @@ <h4 id="response">Response</h4>
 
 </ul>
 
-<ul id="1daf7fa5-c05b-4ad0-b96d-39a788223f27" class="uk-switcher uk-margin">
+<ul id="d65c1b34-5014-4dd1-968b-ebd9796ffbe4" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
@@ -1411,7 +1411,7 @@ <h3 id="example-2---restricted-field-list">Example 2 - Restricted field list</h3
 
 <h4 id="request-1">Request</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#6b542f5d-9e7d-4544-a450-cdaacdf87b00'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#4d8e79de-ef71-4ac5-804a-3496bd3613af'}">
 
 	<li class="uk-active"><a href="#">Live (XML)</a></li>
 
@@ -1423,7 +1423,7 @@ <h4 id="request-1">Request</h4>
 
 </ul>
 
-<ul id="6b542f5d-9e7d-4544-a450-cdaacdf87b00" class="uk-switcher uk-margin">
+<ul id="4d8e79de-ef71-4ac5-804a-3496bd3613af" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/product/LGW4/lite?token=000015778&amp;key=mytestkey&amp;fields=name,longitude,latitude
@@ -1451,7 +1451,7 @@ <h4 id="request-1">Request</h4>
 
 <h4 id="response-1">Response</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#b78e0b32-1292-4dbf-9534-4be7a1dc0986'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#b9c61e0b-55a8-4cda-b524-f3675874f56d'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -1459,7 +1459,7 @@ <h4 id="response-1">Response</h4>
 
 </ul>
 
-<ul id="b78e0b32-1292-4dbf-9534-4be7a1dc0986" class="uk-switcher uk-margin">
+<ul id="b9c61e0b-55a8-4cda-b524-f3675874f56d" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
@@ -1520,7 +1520,7 @@ <h4 id="request-2">Request</h4>
 
 <p>Requests for German products return a different set of fields. Explanation of fields not currently available.</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#4535b7e2-64c4-404c-87bb-8fc170828761'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#cffca6d1-99c0-4f0a-b004-c25991960c83'}">
 
 	<li class="uk-active"><a href="#">Live (XML)</a></li>
 
@@ -1532,7 +1532,7 @@ <h4 id="request-2">Request</h4>
 
 </ul>
 
-<ul id="4535b7e2-64c4-404c-87bb-8fc170828761" class="uk-switcher uk-margin">
+<ul id="cffca6d1-99c0-4f0a-b004-c25991960c83" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/product/FRA0?key=mytestkey
@@ -1560,7 +1560,7 @@ <h4 id="request-2">Request</h4>
 
 <h4 id="response-2">Response</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#042d1bbd-5f5e-4c6a-9abe-2b7905505aa5'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#898cf35a-1962-4ef6-af16-fc348fc66257'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -1568,7 +1568,7 @@ <h4 id="response-2">Response</h4>
 
 </ul>
 
-<ul id="042d1bbd-5f5e-4c6a-9abe-2b7905505aa5" class="uk-switcher uk-margin">
+<ul id="898cf35a-1962-4ef6-af16-fc348fc66257" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
diff --git a/docs/hxapi/transfers/av/index.html b/docs/hxapi/transfers/av/index.html
index 10760616..8d1e9802 100644
--- a/docs/hxapi/transfers/av/index.html
+++ b/docs/hxapi/transfers/av/index.html
@@ -864,7 +864,7 @@ <h3 id="worked-examples">Worked Examples</h3>
 <h4 id="airport-to-giata">Airport to GIATA</h4>
 <h5 id="request">Request</h5>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#9fc4a8fb-370b-4819-b699-450de3204bd3'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#451c8868-a3df-4bba-ac9f-bb1a7197ce64'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -872,7 +872,7 @@ <h5 id="request">Request</h5>
 
 </ul>
 
-<ul id="9fc4a8fb-370b-4819-b699-450de3204bd3" class="uk-switcher uk-margin">
+<ul id="451c8868-a3df-4bba-ac9f-bb1a7197ce64" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&amp;Password=YourABTANumber&amp;Initials=YourInitials&amp;key=YourKey&amp;token=YourToken&amp;PickUp=ALC&amp;PickUpType=IATA&amp;DropOffType=GIATA&amp;DropOff=439771&amp;FromDate=2022-03-16&amp;FromTime=1115&amp;ReturnDate=2022-03-23&amp;ReturnTime=1115&amp;Adults=2&amp;OutFlight=U28605&amp;ReturnFlight=U28602
@@ -890,7 +890,7 @@ <h5 id="request">Request</h5>
 <h5 id="response">Response</h5>
 <p>NB: This is a shortened example compiled from a full availability response.</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#f21cf783-379d-4637-8edf-e4ed47569321'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#75560018-95b5-4c88-ac87-e31ef99f055c'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -898,7 +898,7 @@ <h5 id="response">Response</h5>
 
 </ul>
 
-<ul id="f21cf783-379d-4637-8edf-e4ed47569321" class="uk-switcher uk-margin">
+<ul id="75560018-95b5-4c88-ac87-e31ef99f055c" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;API_Reply</span> <span class="na">Product=</span><span class="s">"Transfers"</span> <span class="na">RequestCode=</span><span class="s">"1"</span> <span class="na">Result=</span><span class="s">"OK"</span> <span class="na">cached=</span><span class="s">"1"</span> <span class="na">expires=</span><span class="s">"2021-12-07 13:06:41"</span><span class="nt">&gt;</span>
@@ -1136,7 +1136,7 @@ <h5 id="response">Response</h5>
 <h4 id="airport-to-tti">Airport to TTI</h4>
 <h5 id="request-1">Request</h5>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#235c8492-273b-418e-b62a-a46b4b3a0bf4'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#20e4d8f5-80c2-4b86-84af-ba6c66ee69d1'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -1144,7 +1144,7 @@ <h5 id="request-1">Request</h5>
 
 </ul>
 
-<ul id="235c8492-273b-418e-b62a-a46b4b3a0bf4" class="uk-switcher uk-margin">
+<ul id="20e4d8f5-80c2-4b86-84af-ba6c66ee69d1" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&amp;Password=YourABTANumber&amp;Initials=YourInitials&amp;key=YourKey&amp;token=YourToken&amp;PickUp=ALC&amp;PickUpType=IATA&amp;DropOffType=TTI&amp;DropOff=10147575&amp;FromDate=2022-03-16&amp;FromTime=1115&amp;ReturnDate=2022-03-23&amp;ReturnTime=1115&amp;Adults=2&amp;OutFlight=U28605&amp;ReturnFlight=U28602
@@ -1163,7 +1163,7 @@ <h5 id="response-1">Response</h5>
 
 <p>NB: This is a shortened example compiled from a full availability response.</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#53458915-05d2-4fb9-abcc-600763d55799'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#d8d01bbe-fc68-49c9-95a3-77034b0814be'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -1171,7 +1171,7 @@ <h5 id="response-1">Response</h5>
 
 </ul>
 
-<ul id="53458915-05d2-4fb9-abcc-600763d55799" class="uk-switcher uk-margin">
+<ul id="d8d01bbe-fc68-49c9-95a3-77034b0814be" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;API_Reply</span> <span class="na">Product=</span><span class="s">"Transfers"</span> <span class="na">RequestCode=</span><span class="s">"1"</span> <span class="na">Result=</span><span class="s">"OK"</span> <span class="na">cached=</span><span class="s">"1"</span> <span class="na">expires=</span><span class="s">"2021-12-07 13:06:41"</span><span class="nt">&gt;</span>
@@ -1408,7 +1408,7 @@ <h5 id="response-1">Response</h5>
 
 <h4 id="airport-to-postal-address">Airport to Postal Address</h4>
 <h5 id="request-2">Request</h5>
-<ul class="uk-tab" data-uk-switcher="{connect:'#bf99c6d7-e9a4-47f1-a316-c53a16895410'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#2a0a0cb7-a9e3-4ab0-b9db-03edfa3c0998'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -1416,7 +1416,7 @@ <h5 id="request-2">Request</h5>
 
 </ul>
 
-<ul id="bf99c6d7-e9a4-47f1-a316-c53a16895410" class="uk-switcher uk-margin">
+<ul id="2a0a0cb7-a9e3-4ab0-b9db-03edfa3c0998" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https:///api.holidayextras.com/v1/transfers/search?ABTANumber=YourABTANumber&amp;Password=YourABTANumber&amp;Initials=YourInitials&amp;key=YourKey&amp;token=YourToken&amp;PickUp=ALC&amp;PickUpType=IATA&amp;DropOffType=postal-address&amp;DropOffName=Hotel%20Rural%20Castillo%20De%20Biar&amp;DropOffAddress[0]=Carretera%20de%20Banyeres&amp;DropOffAddress[1]=s/n&amp;DropOffTown=%20Biar&amp;DropOffCounty=Alicante&amp;DropOffPostcode=03410&amp;DropOffCountryCode=ES&amp;DropOffLongitude=-0.76832006&amp;DropOffLatitude=38.63852215&amp;Adults=2&amp;FromDate=2022-03-16&amp;FromTime=1115&amp;ReturnDate=2022-03-23&amp;ReturnTime=1115&amp;OutFlight=U28605&amp;ReturnFlight=U28602
@@ -1435,7 +1435,7 @@ <h5 id="response-2">Response</h5>
 
 <p>NB: This is a shortened example compiled from a full availability response.</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#575dfded-1dc1-4cdd-8360-4124ba068a3c'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#386c458e-a677-4546-bbee-5ed3880c6ac1'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -1443,7 +1443,7 @@ <h5 id="response-2">Response</h5>
 
 </ul>
 
-<ul id="575dfded-1dc1-4cdd-8360-4124ba068a3c" class="uk-switcher uk-margin">
+<ul id="386c458e-a677-4546-bbee-5ed3880c6ac1" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;API_Reply</span> <span class="na">Product=</span><span class="s">"Transfers"</span> <span class="na">RequestCode=</span><span class="s">"1"</span> <span class="na">Result=</span><span class="s">"OK"</span> <span class="na">cached=</span><span class="s">"1"</span> <span class="na">expires=</span><span class="s">"2021-12-07 16:31:35"</span><span class="nt">&gt;</span>
diff --git a/docs/hxapi/transfers/cancel/index.html b/docs/hxapi/transfers/cancel/index.html
index 70541bfe..173c6a7d 100644
--- a/docs/hxapi/transfers/cancel/index.html
+++ b/docs/hxapi/transfers/cancel/index.html
@@ -168,7 +168,7 @@ <h2 id="cancel-booking-response">Cancel Booking Response</h2>
 
 <h3 id="example">Example</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#0c13beda-4176-4d0e-a926-1bfc9329efc7'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#c6b097a1-5c4b-447b-9514-6f7214dcb01d'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -176,7 +176,7 @@ <h3 id="example">Example</h3>
 
 </ul>
 
-<ul id="0c13beda-4176-4d0e-a926-1bfc9329efc7" class="uk-switcher uk-margin">
+<ul id="c6b097a1-5c4b-447b-9514-6f7214dcb01d" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;Booking&gt;</span>
diff --git a/docs/hxapi/transfers/cancellation-policy/index.html b/docs/hxapi/transfers/cancellation-policy/index.html
index a7c9e46f..9037f25a 100644
--- a/docs/hxapi/transfers/cancellation-policy/index.html
+++ b/docs/hxapi/transfers/cancellation-policy/index.html
@@ -153,7 +153,7 @@ <h2 id="cancellation-policy-response">Cancellation Policy Response</h2>
 
 <h3 id="example">Example</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#2e712bb7-1146-42dd-a802-f89ba80fe5e3'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#9ed11592-98e2-4e53-8512-9ab26931a056'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -161,7 +161,7 @@ <h3 id="example">Example</h3>
 
 </ul>
 
-<ul id="2e712bb7-1146-42dd-a802-f89ba80fe5e3" class="uk-switcher uk-margin">
+<ul id="9ed11592-98e2-4e53-8512-9ab26931a056" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;BookingRef&gt;</span>TB12345<span class="nt">&lt;/BookingRef&gt;</span>
@@ -187,7 +187,7 @@ <h3 id="example">Example</h3>
 
 <h3 id="example---non-cancellable-booking">Example - Non-Cancellable Booking</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#d74230b2-34cb-4632-9f4e-3906d8ffb3ad'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#bc018f33-df34-4142-8b47-fab0550e35b4'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -195,7 +195,7 @@ <h3 id="example---non-cancellable-booking">Example - Non-Cancellable Booking</h3
 
 </ul>
 
-<ul id="d74230b2-34cb-4632-9f4e-3906d8ffb3ad" class="uk-switcher uk-margin">
+<ul id="bc018f33-df34-4142-8b47-fab0550e35b4" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;BookingRef&gt;</span>TB12345<span class="nt">&lt;/BookingRef&gt;</span>
diff --git a/docs/hxapi/transfers/view/index.html b/docs/hxapi/transfers/view/index.html
index 20cc6ddf..e717241f 100644
--- a/docs/hxapi/transfers/view/index.html
+++ b/docs/hxapi/transfers/view/index.html
@@ -303,7 +303,7 @@ <h3 id="flightdetails-fields">FlightDetails Fields</h3>
 
 <h3 id="example">Example</h3>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#2f8b9cbf-4f9c-4060-84e4-304a221748e8'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#1f5469ff-6c96-4c2c-8418-c7444cf1e950'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -311,7 +311,7 @@ <h3 id="example">Example</h3>
 
 </ul>
 
-<ul id="2f8b9cbf-4f9c-4060-84e4-304a221748e8" class="uk-switcher uk-margin">
+<ul id="1f5469ff-6c96-4c2c-8418-c7444cf1e950" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;Booking&gt;</span>
diff --git a/docs/hxapi/upgrade/index.html b/docs/hxapi/upgrade/index.html
index b532ebc5..272316df 100644
--- a/docs/hxapi/upgrade/index.html
+++ b/docs/hxapi/upgrade/index.html
@@ -247,7 +247,7 @@ <h3 id="example-1---carpark-upgrades">Example 1 - Carpark Upgrades</h3>
 
 <h4 id="request">Request</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#72e038c7-0c6b-44e8-ac3d-4b25ec3b65ee'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#0d716e9e-dd82-4f70-bd96-17a780b397fe'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -255,7 +255,7 @@ <h4 id="request">Request</h4>
 
 </ul>
 
-<ul id="72e038c7-0c6b-44e8-ac3d-4b25ec3b65ee" class="uk-switcher uk-margin">
+<ul id="0d716e9e-dd82-4f70-bd96-17a780b397fe" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/upgrade/STN5?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;key=YourKey&amp;token=YourToken&amp;ArrivalDate=2020-11-03&amp;ArrivalTime=12:30&amp;DepartDate=2020-11-11&amp;DepartTime=13:45
@@ -273,7 +273,7 @@ <h4 id="request">Request</h4>
 
 <h4 id="response">Response</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#8beb20bb-6676-4f68-b3c8-40bc69263f52'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#7c321cf9-2d26-4201-bf06-e2ceaaf4aee2'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -281,7 +281,7 @@ <h4 id="response">Response</h4>
 
 </ul>
 
-<ul id="8beb20bb-6676-4f68-b3c8-40bc69263f52" class="uk-switcher uk-margin">
+<ul id="7c321cf9-2d26-4201-bf06-e2ceaaf4aee2" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
@@ -618,7 +618,7 @@ <h3 id="example-1---hotel-upgrades">Example 1 - Hotel Upgrades</h3>
 
 <h4 id="request-1">Request</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#442a73d8-3c55-4d35-81d9-d438110016ad'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#d7775234-ea6f-4edd-aa5f-31865cd68cad'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -626,7 +626,7 @@ <h4 id="request-1">Request</h4>
 
 </ul>
 
-<ul id="442a73d8-3c55-4d35-81d9-d438110016ad" class="uk-switcher uk-margin">
+<ul id="d7775234-ea6f-4edd-aa5f-31865cd68cad" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/upgrade/LGWSOF?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;key=YourKey&amp;token=YourToken&amp;ArrivalDate=2020-11-03&amp;ArrivalTime=12:30&amp;DepartDate=2020-11-11&amp;DepartTime=13:45
@@ -642,7 +642,7 @@ <h4 id="request-1">Request</h4>
 
 <h4 id="response-1">Response</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#faf7b276-1452-43bf-a3d1-df3c134232a1'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#a5eeb219-bd7f-46f1-ad5d-c3a489ef3d34'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -650,7 +650,7 @@ <h4 id="response-1">Response</h4>
 
 </ul>
 
-<ul id="faf7b276-1452-43bf-a3d1-df3c134232a1" class="uk-switcher uk-margin">
+<ul id="a5eeb219-bd7f-46f1-ad5d-c3a489ef3d34" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
diff --git a/docs/hxapi/viewamendcancel/view/index.html b/docs/hxapi/viewamendcancel/view/index.html
index 8867a1db..c967aba3 100644
--- a/docs/hxapi/viewamendcancel/view/index.html
+++ b/docs/hxapi/viewamendcancel/view/index.html
@@ -54,7 +54,7 @@ <h3 id="endpoint">Endpoint</h3>
 
 <p>The endpoint to use is (where <code class="language-plaintext highlighter-rouge">YourBookingRef</code> is the Holiday Extras booking reference):</p>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#eea8a146-915d-490e-a319-bb0e22b67f66'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#ebc5891a-089c-4059-83e3-ad8458a9e673'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -62,7 +62,7 @@ <h3 id="endpoint">Endpoint</h3>
 
 </ul>
 
-<ul id="eea8a146-915d-490e-a319-bb0e22b67f66" class="uk-switcher uk-margin">
+<ul id="ebc5891a-089c-4059-83e3-ad8458a9e673" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/booking/YourBookingRef
@@ -366,7 +366,7 @@ <h3 id="uk-products-view-booking-for-a-car-park">UK Products View Booking (for a
 
 <h4 id="request">Request</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#1c9ed8e8-bd6d-40a9-9c7e-1bfac352e54e'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#1bfeef43-7611-4900-8cc0-6de2cf96002a'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -374,7 +374,7 @@ <h4 id="request">Request</h4>
 
 </ul>
 
-<ul id="1c9ed8e8-bd6d-40a9-9c7e-1bfac352e54e" class="uk-switcher uk-margin">
+<ul id="1bfeef43-7611-4900-8cc0-6de2cf96002a" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;Initials=YourInitials&amp;key=YourKey&amp;Email=test@test.com
@@ -391,7 +391,7 @@ <h4 id="request">Request</h4>
 
 <h4 id="response">Response</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#18adca42-9d89-4dc0-bfd2-78891ed82966'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#6991c423-905a-4f24-9708-392fbb6d704e'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -399,7 +399,7 @@ <h4 id="response">Response</h4>
 
 </ul>
 
-<ul id="18adca42-9d89-4dc0-bfd2-78891ed82966" class="uk-switcher uk-margin">
+<ul id="6991c423-905a-4f24-9708-392fbb6d704e" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
@@ -925,7 +925,7 @@ <h4 id="response">Response</h4>
 <h3 id="uk-products-view-booking-for-a-transfer">UK Products View Booking (for a transfer)</h3>
 
 <h4 id="request-1">Request</h4>
-<ul class="uk-tab" data-uk-switcher="{connect:'#0786bb1a-c8a2-493a-946e-ea64c341d7ba'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#01229ad3-37b0-46f6-8f41-09f6d6d02bd6'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -933,7 +933,7 @@ <h4 id="request-1">Request</h4>
 
 </ul>
 
-<ul id="0786bb1a-c8a2-493a-946e-ea64c341d7ba" class="uk-switcher uk-margin">
+<ul id="01229ad3-37b0-46f6-8f41-09f6d6d02bd6" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://api.holidayextras.com/v1/booking/YourBookingRef?ABTANumber=YourABTANumber&amp;Password=YourPassword&amp;Initials=YourInitials&amp;key=YourKey&amp;Email=test@test.com
@@ -950,7 +950,7 @@ <h4 id="request-1">Request</h4>
 
 <h4 id="response-1">Response</h4>
 
-<ul class="uk-tab" data-uk-switcher="{connect:'#6aac4725-7582-42bd-8149-5919fe135ee9'}">
+<ul class="uk-tab" data-uk-switcher="{connect:'#803d4aed-c93f-4f2e-808f-a4b72e7b49fa'}">
 
 	<li class="uk-active"><a href="#">XML</a></li>
 
@@ -958,7 +958,7 @@ <h4 id="response-1">Response</h4>
 
 </ul>
 
-<ul id="6aac4725-7582-42bd-8149-5919fe135ee9" class="uk-switcher uk-margin">
+<ul id="803d4aed-c93f-4f2e-808f-a4b72e7b49fa" class="uk-switcher uk-margin">
 
 	<li>
 <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;?xml version="1.0"?&gt;</span>
diff --git a/docs/partner/v2/api-endpoint-navigation-guide.md b/docs/partner/v2/api-endpoint-navigation-guide.md
index 8863473b..245b72ec 100644
--- a/docs/partner/v2/api-endpoint-navigation-guide.md
+++ b/docs/partner/v2/api-endpoint-navigation-guide.md
@@ -1,6 +1,6 @@
-# APIConnect Partner API v2 - Understanding the OpenAPI Documentation
+# APIConnect (Partner API 2026) - Understanding the OpenAPI Documentation
 
-Document Version: 0.1 Last Updated: 2026-01-30
+Document Version: 0.2 Last Updated: 2026-03-18
 
 This document is in Beta
 
@@ -37,7 +37,7 @@ This can be viewed using a tool of your choice. We recommend <https://editor.swa
 
 ### Product-Centric Design
 
-The APIConnect API is built around **products**. Each of our five products has the same set of endpoints:
+The APIConnect API is built around **products**. Each of our products has the same set of endpoints:
 
 **Available Products:**
 
@@ -45,6 +45,7 @@ The APIConnect API is built around **products**. Each of our five products has t
 
 **Coming Soon**
 
+* **Transfers** - Airport transfers
 * **Hotels** - Airport hotel accommodation
 * **Hotel with Parking** - Integrated packages
 * **Lounges** - Airport lounge access
@@ -195,7 +196,7 @@ Use this when you want the API to calculate appropriate parking times based on f
 * Basic product information
 * Supplier required information
 
-**Important:** The price guarantee token will expire. We will inform you in the API response of this duration. If the customer takes longer to book, you'll need to search again to get a fresh token.
+**Important:** The price guarantee token will expire — the expiry time is included in the response. Using an expired token will return a `422 Unprocessable Entity` error. If this happens, re-run the search to get a fresh token.
 
 **Caching:** DO NOT cache this response - prices and availability change frequently
 
@@ -262,7 +263,7 @@ Examples:
 * **Recommended polling interval** (in seconds) - Suggested frequency for status checks
 * All booking details
 
-**Important:** Always include an `Idempotency-Key` header to prevent duplicate bookings if there's a network error.
+**Important:** Always include an `Idempotency-Key` header to prevent duplicate bookings if there's a network error. Any unique string is accepted; UUID v4 is recommended. Re-use the same key to safely retry a failed request.
 
 **Understanding Booking Status:**
 
@@ -346,9 +347,9 @@ You have four options for handling pending bookings, depending on how much contr
 
 **Format options:**
 
-* `json`: Structured data for your own rendering
-* `html`: Ready-to-use HTML snippet for web pages
-* `markdown`: Text-based format for simpler emails
+* `json`: Returns an array of `{ type, value }` pairs (e.g., `{ "type": "booking_reference", "value": "HX123456" }`). Use these fields to build your own confirmation page.
+* `html`: Returns a `{ text }` object containing a ready-to-use HTML snippet for web pages.
+* `markdown`: Returns a `{ text }` object containing text-based format for simpler emails.
 
 **Why use this?** The formatted confirmation includes product-specific instructions. It's optimized for customer-facing display.
 
@@ -381,6 +382,8 @@ You have four options for handling pending bookings, depending on how much contr
 
 ### Stage 7: List Bookings (Alternative Lookup)
 
+> This endpoint will be available in a later phase.
+
 **Endpoint:** `GET /v2/bookings/parking?partner_reference={your-reference}`
 
 **Purpose:** Find bookings using YOUR reference
@@ -447,7 +450,7 @@ You have four options for handling pending bookings, depending on how much contr
 * Confirmation of changes
 * Receipt of any charges/refunds
 
-**Important:** The amendment token works the same as the price guarantee token.
+**Important:** The amendment token is short-lived, like the price guarantee token. Using an expired token will return a `422 Unprocessable Entity` error — re-request the amendment quote to get a fresh token.
 
 **Typical workflow:**
 
@@ -502,7 +505,7 @@ You have four options for handling pending bookings, depending on how much contr
 * Confirmation of cancellation
 * Final refund amounts
 
-**Important:** Cancellations cannot be undone. The customer would need to create a new booking.
+**Important:** The cancellation token is short-lived. Using an expired token will return a `422 Unprocessable Entity` error — re-request the cancellation quote to get a fresh token. Cancellations cannot be undone; you would need to create a new booking.
 
 **Typical workflow:**
 
diff --git a/docs/partner/v2/api-endpoint-navigation-guide/index.html b/docs/partner/v2/api-endpoint-navigation-guide/index.html
index 9a4f39ad..cb136d4b 100644
--- a/docs/partner/v2/api-endpoint-navigation-guide/index.html
+++ b/docs/partner/v2/api-endpoint-navigation-guide/index.html
@@ -38,9 +38,9 @@
     <div class="container">
       <main role="main">
         <div class="panel-body">
-  <h1 id="apiconnect-partner-api-v2---understanding-the-openapi-documentation">APIConnect Partner API v2 - Understanding the OpenAPI Documentation</h1>
+  <h1 id="apiconnect-partner-api-2026---understanding-the-openapi-documentation">APIConnect (Partner API 2026) - Understanding the OpenAPI Documentation</h1>
 
-<p>Document Version: 0.1 Last Updated: 2026-01-30</p>
+<p>Document Version: 0.2 Last Updated: 2026-03-18</p>
 
 <p>This document is in Beta</p>
 
@@ -75,7 +75,7 @@ <h2 id="api-architecture-overview">API Architecture Overview</h2>
 
 <h3 id="product-centric-design">Product-Centric Design</h3>
 
-<p>The APIConnect API is built around <strong>products</strong>. Each of our five products has the same set of endpoints:</p>
+<p>The APIConnect API is built around <strong>products</strong>. Each of our products has the same set of endpoints:</p>
 
 <p><strong>Available Products:</strong></p>
 
@@ -86,6 +86,7 @@ <h3 id="product-centric-design">Product-Centric Design</h3>
 <p><strong>Coming Soon</strong></p>
 
 <ul>
+  <li><strong>Transfers</strong> - Airport transfers</li>
   <li><strong>Hotels</strong> - Airport hotel accommodation</li>
   <li><strong>Hotel with Parking</strong> - Integrated packages</li>
   <li><strong>Lounges</strong> - Airport lounge access</li>
@@ -257,7 +258,7 @@ <h3 id="stage-2-product-search">Stage 2: Product Search</h3>
   <li>Supplier required information</li>
 </ul>
 
-<p><strong>Important:</strong> The price guarantee token will expire. We will inform you in the API response of this duration. If the customer takes longer to book, you’ll need to search again to get a fresh token.</p>
+<p><strong>Important:</strong> The price guarantee token will expire — the expiry time is included in the response. Using an expired token will return a <code class="language-plaintext highlighter-rouge">422 Unprocessable Entity</code> error. If this happens, re-run the search to get a fresh token.</p>
 
 <p><strong>Caching:</strong> DO NOT cache this response - prices and availability change frequently</p>
 
@@ -337,7 +338,7 @@ <h3 id="stage-4-create-booking">Stage 4: Create Booking</h3>
   <li>All booking details</li>
 </ul>
 
-<p><strong>Important:</strong> Always include an <code class="language-plaintext highlighter-rouge">Idempotency-Key</code> header to prevent duplicate bookings if there’s a network error.</p>
+<p><strong>Important:</strong> Always include an <code class="language-plaintext highlighter-rouge">Idempotency-Key</code> header to prevent duplicate bookings if there’s a network error. Any unique string is accepted; UUID v4 is recommended. Re-use the same key to safely retry a failed request.</p>
 
 <p><strong>Understanding Booking Status:</strong></p>
 
@@ -441,9 +442,9 @@ <h3 id="stage-5-booking-confirmation-details">Stage 5: Booking Confirmation Deta
 <p><strong>Format options:</strong></p>
 
 <ul>
-  <li><code class="language-plaintext highlighter-rouge">json</code>: Structured data for your own rendering</li>
-  <li><code class="language-plaintext highlighter-rouge">html</code>: Ready-to-use HTML snippet for web pages</li>
-  <li><code class="language-plaintext highlighter-rouge">markdown</code>: Text-based format for simpler emails</li>
+  <li><code class="language-plaintext highlighter-rouge">json</code>: Returns an array of <code class="language-plaintext highlighter-rouge">{ type, value }</code> pairs (e.g., <code class="language-plaintext highlighter-rouge">{ "type": "booking_reference", "value": "HX123456" }</code>). Use these fields to build your own confirmation page.</li>
+  <li><code class="language-plaintext highlighter-rouge">html</code>: Returns a <code class="language-plaintext highlighter-rouge">{ text }</code> object containing a ready-to-use HTML snippet for web pages.</li>
+  <li><code class="language-plaintext highlighter-rouge">markdown</code>: Returns a <code class="language-plaintext highlighter-rouge">{ text }</code> object containing text-based format for simpler emails.</li>
 </ul>
 
 <p><strong>Why use this?</strong> The formatted confirmation includes product-specific instructions. It’s optimized for customer-facing display.</p>
@@ -478,6 +479,10 @@ <h3 id="stage-6-view-booking">Stage 6: View Booking</h3>
 
 <h3 id="stage-7-list-bookings-alternative-lookup">Stage 7: List Bookings (Alternative Lookup)</h3>
 
+<blockquote>
+  <p>This endpoint will be available in a later phase.</p>
+</blockquote>
+
 <p><strong>Endpoint:</strong> <code class="language-plaintext highlighter-rouge">GET /v2/bookings/parking?partner_reference={your-reference}</code></p>
 
 <p><strong>Purpose:</strong> Find bookings using YOUR reference</p>
@@ -557,7 +562,7 @@ <h4 id="step-2-amend-confirm">Step 2: Amend Confirm</h4>
   <li>Receipt of any charges/refunds</li>
 </ul>
 
-<p><strong>Important:</strong> The amendment token works the same as the price guarantee token.</p>
+<p><strong>Important:</strong> The amendment token is short-lived, like the price guarantee token. Using an expired token will return a <code class="language-plaintext highlighter-rouge">422 Unprocessable Entity</code> error — re-request the amendment quote to get a fresh token.</p>
 
 <p><strong>Typical workflow:</strong></p>
 
@@ -620,7 +625,7 @@ <h4 id="step-2-cancel-confirm">Step 2: Cancel Confirm</h4>
   <li>Final refund amounts</li>
 </ul>
 
-<p><strong>Important:</strong> Cancellations cannot be undone. The customer would need to create a new booking.</p>
+<p><strong>Important:</strong> The cancellation token is short-lived. Using an expired token will return a <code class="language-plaintext highlighter-rouge">422 Unprocessable Entity</code> error — re-request the cancellation quote to get a fresh token. Cancellations cannot be undone; you would need to create a new booking.</p>
 
 <p><strong>Typical workflow:</strong></p>
 
diff --git a/docs/partner/v2/problems/bad-request.md b/docs/partner/v2/problems/bad-request.md
index e2210f62..fa89889f 100644
--- a/docs/partner/v2/problems/bad-request.md
+++ b/docs/partner/v2/problems/bad-request.md
@@ -33,3 +33,5 @@ The request was malformed or missing required parameters. Check the `errors` arr
 ## How to resolve
 
 Review the `errors` array to identify which fields need correcting. Each error includes a `field` name and a `message` describing the validation failure.
+
+> **Note:** The `errors` array is always present in every error response. It will contain field-level details when applicable, or be empty (e.g., for 500 errors).
diff --git a/docs/partner/v2/problems/bad-request/index.html b/docs/partner/v2/problems/bad-request/index.html
index 7ba7c13c..21008531 100644
--- a/docs/partner/v2/problems/bad-request/index.html
+++ b/docs/partner/v2/problems/bad-request/index.html
@@ -89,6 +89,10 @@ <h2 id="how-to-resolve">How to resolve</h2>
 
 <p>Review the <code class="language-plaintext highlighter-rouge">errors</code> array to identify which fields need correcting. Each error includes a <code class="language-plaintext highlighter-rouge">field</code> name and a <code class="language-plaintext highlighter-rouge">message</code> describing the validation failure.</p>
 
+<blockquote>
+  <p><strong>Note:</strong> The <code class="language-plaintext highlighter-rouge">errors</code> array is always present in every error response. It will contain field-level details when applicable, or be empty (e.g., for 500 errors).</p>
+</blockquote>
+
 </div>
 
       </main>
diff --git a/docs/partner/v2/webhook-integration-guide.md b/docs/partner/v2/webhook-integration-guide.md
index 976f9e28..fda933af 100644
--- a/docs/partner/v2/webhook-integration-guide.md
+++ b/docs/partner/v2/webhook-integration-guide.md
@@ -1,4 +1,4 @@
-# APIConnect Partner API v2 - Event Notifications
+# APIConnect (Partner API 2026) - Event Notifications
 
 Version: 1.0 Last Updated: 2026-01-29
 
diff --git a/docs/partner/v2/webhook-integration-guide/index.html b/docs/partner/v2/webhook-integration-guide/index.html
index 460cff6c..61c0e532 100644
--- a/docs/partner/v2/webhook-integration-guide/index.html
+++ b/docs/partner/v2/webhook-integration-guide/index.html
@@ -38,7 +38,7 @@
     <div class="container">
       <main role="main">
         <div class="panel-body">
-  <h1 id="apiconnect-partner-api-v2---event-notifications">APIConnect Partner API v2 - Event Notifications</h1>
+  <h1 id="apiconnect-partner-api-2026---event-notifications">APIConnect (Partner API 2026) - Event Notifications</h1>
 
 <p>Version: 1.0 Last Updated: 2026-01-29</p>
 
diff --git a/docs/search/index.html b/docs/search/index.html
index ed58a289..48666bab 100644
--- a/docs/search/index.html
+++ b/docs/search/index.html
@@ -535,8 +535,8 @@
       ,
     
       "partner-v2-api-endpoint-navigation-guide": {
-        "title": "APIConnect Partner API v2 - Understanding the OpenAPI Documentation",
-        "content": "# APIConnect Partner API v2 - Understanding the OpenAPI DocumentationDocument Version: 0.1 Last Updated: 2026-01-30This document is in Beta---## Purpose of This GuideThis guide helps you navigate the Swagger/OpenAPI documentation by explaining the **context** and **workflow** of the API endpoints. While Swagger shows you *what* each endpoint does, this guide explains *when* and *why* to use each endpoint, and how they work together.## OpenAPI SpecificationThe openapi schema for the API can be found at This is a live document and is expected to be updated.This can be viewed using a tool of your choice. We recommend  or importing the schema into [Postman](https://www.postman.com/).---## Table of Contents1. [API Architecture Overview](#api-architecture-overview)2. [Core Concepts](#core-concepts)3. [The Customer Journey](#the-customer-journey)4. [Common Workflows](#common-workflows)---## API Architecture Overview### Product-Centric DesignThe APIConnect API is built around **products**. Each of our five products has the same set of endpoints:**Available Products:*** **Parking** - Airport car parking**Coming Soon*** **Hotels** - Airport hotel accommodation* **Hotel with Parking** - Integrated packages* **Lounges** - Airport lounge access* **FastTrack** - Priority security lanes**Endpoint Pattern:** When you see endpoints in the OpenAPI schema like:* `GET /v2/products/parking`* `GET /v2/products/hotels`* `GET /v2/products/lounges`These all follow the same pattern - just replace the product type.### The One Exception: LocationsThe **Locations** endpoint is the only endpoint that doesn't follow the product-specific pattern. It's used to discover which locations (airports) have which products available.---## Core Concepts### 1. Price Guarantee Tokens**What:** A time-limited token that locks in a price **When:** Obtained from the Products endpoint **Why:** Ensures customers aren't charged more than the quoted price **Validity:** 30 minutes **Usage:** Required for Book endpoint**Example Flow:**```1. Customer searches → Products endpoint returns price + token2. Customer sees price: £45.993. Customer books → Pass token to Book endpoint4. API validates token → Price has increased to £48.995. API only charges £45.99 (the guaranteed price)```### 2. Booking Reference vs Partner Reference**Booking Reference:*** **Format:** e.g., `HX123456`* **Source:** Generated by APIConnect* **Uniqueness:** Guaranteed unique* **Usage:** Use this for View Booking, Amend, Cancel endpoints* **Why:** This is our internal identifier that pinpoints a single booking**Partner Reference:*** **Format:** Your choice (e.g., `ORDER-12345`)* **Source:** Provided by you* **Uniqueness:** NOT guaranteed unique (up to you to manage)* **Usage:** Use this for List Bookings endpoint only* **Why:** Helps you match our bookings to your internal systems### 3. Quote and Confirm PatternFor amendments and cancellations, we use a two-step \"quote and confirm\" pattern:**Quote Step:*** Preview what will happen* Get costs/refunds calculated* Receive a token* Nothing is actioned yet**Confirm Step:*** Use the token from the quote* Actually execute the change* Booking is modified/cancelled* Customer is charged/refunded**Why this pattern?** It allows customers to see the financial impact before committing to the change.---## The Customer Journey### Stage 1: Discovery**Endpoint:** `GET /v2/locations`**Purpose:** Find out which airports have which products available**When to use:*** User hasn't selected a location yet* Building a location selector* Need to show available products by location**Response includes:*** Location types* Location codes (IATA / UNLOCODE)* Location names* Available product types at each location**Caching:** Safe to cache for 24 hours---### Stage 2: Product Search**Endpoint:** `GET /v2/products/parking`**Purpose:** Search for available products with pricing**When to use:*** Customer has selected location and dates* You need availability and pricing* This is always the first step in the booking flow**Parking-specific parameter options:**For parking products, you have flexibility in how you specify timing. You can provide **either** set of parameters:**Option 1: Explicit parking times*** `parking_entry_date_time` - When the customer will arrive at the car park* `parking_exit_date_time` - When the customer will leave the car parkUse this when you know the exact parking duration needed.**Option 2: Flight-based calculation*** `outbound_flight_number` - Departure flight number* `outbound_flight_date_time` - Departure flight time* `inbound_flight_number` - Return flight number* `inbound_flight_date_time` - Return flight timeUse this when you want the API to calculate appropriate parking times based on flight schedules. The API will automatically add buffer time for airport arrival/departure.**Important rules:*** At least one set of parameters must be provided* If both sets are provided, `parking_entry_date_time` and `parking_exit_date_time` take precedence* Flight-based calculation is useful when you're unsure how much time customers need between parking and their flight**Response includes:*** List of available products* Pricing for each product* **Price guarantee token** (important!)* Product capabilities (modifiable, cancellable, etc.)* Basic product information* Supplier required information**Important:** The price guarantee token will expire. We will inform you in the API response of this duration. If the customer takes longer to book, you'll need to search again to get a fresh token.**Caching:** DO NOT cache this response - prices and availability change frequently---### Stage 3: Content Enrichment (Optional)**Endpoint:** `GET /v2/content/parking`Examples:* `GET /v2/content/parking`**Purpose:** Get detailed product information, images, descriptions, and features**When to use:*** Customer clicks on a product to see more details* You want to show rich product information* Building a product details page**Response includes:*** Full product descriptions (multi-language)* Images and gallery* Detailed features and amenities* Location details and directions**Caching:** Safe to cache - check response headers for cache duration**Why separate from Products?** Content is large and changes less frequently. Separating it allows the Products endpoint to be fast and efficient, while Content can be cached and only fetched when needed.---### Stage 4: Create Booking**Endpoint:** `POST /v2/bookings/parking`**Purpose:** Create a booking.**When to use:*** Customer has selected a product* Customer is ready to confirm the booking**Request requires:*** **Price guarantee token** (from the search results)* Customer details* Product-specific details (see product-specific integration guide)  * Parking: Vehicle details, flight info, entry/exit times  * Hotels: Room requirements, arrival time, guest count  * Lounges: Passenger details, flight info, visit time  * FastTrack: Passenger details, flight info, travel time* Your partner reference (optional but recommended)**Response includes:*** **Booking reference** (e.g., HX123456) - Our booking reference* **Booking status** (`pending` or `confirmed`)* **Hosted confirmation page URL** - A link to our hosted confirmation page* **Recommended polling interval** (in seconds) - Suggested frequency for status checks* All booking details**Important:** Always include an `Idempotency-Key` header to prevent duplicate bookings if there's a network error.**Understanding Booking Status:****Confirmed Status:*** The booking is fully confirmed with the supplier* Show confirmation details to the customer immediately* No further action needed**Pending Status:*** We have created the booking on our side* Our supplier is still processing the confirmation on their side* The booking will transition to either `confirmed` or `error`**Handling Pending Bookings - Four Options:**You have four options for handling pending bookings, depending on how much control you want:**Option 1: Hosted Confirmation Page (Simplest)*** Use the Holiday Extras co-branded hosted confirmation page URL included in the booking response* Direct customers to this URL* We handle all status updates and display logic* The page automatically updates when the booking confirms* No polling or webhooks needed on your side**Option 2: Confirmation Endpoint (Simple)*** Use the Confirmation endpoint (Stage 5) to display booking details* The data returned is always relevant to the current status* Shows \"pending\" messaging when pending, \"confirmed\" details when confirmed* Make the same call regardless of status - we handle the logic* No need to track status transitions yourself**Option 3: Polling (More Control)*** Call the GET booking endpoint (`GET /v2/bookings/parking/{booking-reference}`) repeatedly* Use the `recommended_polling_interval` from the booking response* Check the status field in each response* Stop polling when status changes to `confirmed` or `error`* You control the customer experience during the pending period**Option 4: Webhooks (Event-Driven)*** Build an endpoint on your side matching our webhook specification* We call your endpoint when the booking status changes* Your endpoint receives notification of the status update* Then call GET booking to retrieve the latest information* Most efficient for handling status updates**Recommendation:*** Use Option 1 or 2 if you want us to handle the complexity* Use Option 3 or 4 if you need full control over the customer experience---### Stage 5: Booking Confirmation Details**Endpoint:** `GET /v2/bookings/parking/{booking-reference}/confirmation-details`**Purpose:** Get formatted confirmation details for display**When to use:*** Immediately after booking is created* Displaying a confirmation page**Query parameters:*** `format`: `json` (default), `html`, or `markdown`**Response includes:*** All booking details formatted for display* Product-specific instructions (PIN codes, meeting points, etc.)* Contact information* Important notices**Format options:*** `json`: Structured data for your own rendering* `html`: Ready-to-use HTML snippet for web pages* `markdown`: Text-based format for simpler emails**Why use this?** The formatted confirmation includes product-specific instructions. It's optimized for customer-facing display.---### Stage 6: View Booking**Endpoint:** `GET /v2/bookings/parking/{booking-reference}`**Purpose:** Retrieve a specific booking by our booking reference**When to use:*** Customer wants to view their booking* You need to check current booking status* Before allowing amendments or cancellations**Response includes:*** Complete booking details* Current status (pending, confirmed, cancelled, error)* Customer details**Important:** Use our **booking reference**, not your partner reference.---### Stage 7: List Bookings (Alternative Lookup)**Endpoint:** `GET /v2/bookings/parking?partner_reference={your-reference}`**Purpose:** Find bookings using YOUR reference**When to use:*** Customer lost our booking reference* You need to look up by your internal order ID* You need to reconcile your orders with our bookings**Response includes:*** **Array of bookings** (not a single booking)* Each booking has our booking reference* Use our booking reference for subsequent operations**Why an array?** We don't guarantee your partner reference is unique. You might reuse order IDs or have multiple bookings per order. Therefore, we always return an array, even if there's only one result.**Next step:** Display the bookings to the customer and let them select which one they want to manage, then use our booking reference for amendments/cancellations.---### Stage 8: Amend Booking (Two-Step Process)#### Step 1: Amend Quote**Endpoint:** `PATCH /v2/bookings/parking/{booking-reference}/amendments/quote`**Purpose:** Preview the amendment without executing it**When to use:*** Customer wants to change booking details* You need to show pricing impact before confirming**Response includes:*** Amendment fee (if any)* Price difference (if dates/product changed)* Total charge or refund* **Amendment token** (for the confirm step)**Nothing is changed yet** - this is just a quote.#### Step 2: Amend Confirm**Endpoint:** `POST /v2/bookings/parking/{booking-reference}/amendments/confirm`**Purpose:** Actually execute the amendment**When to use:*** Customer has seen the quote and accepted it* You're ready to charge/refund the difference**Request requires:*** **Amendment token** (from the quote response)**Response includes:*** Updated booking details* Confirmation of changes* Receipt of any charges/refunds**Important:** The amendment token works the same as the price guarantee token.**Typical workflow:**```1. Customer clicks \"Change flight details\"2. Call Amend Quote → Show \"£5 amendment fee\"3. Customer clicks \"Confirm changes\"4. Call Amend Confirm with token → Booking updated```---### Stage 9: Cancel Booking (Two-Step Process)#### Step 1: Cancel Quote**Endpoint:** `PATCH /v2/bookings/parking/{booking-reference}/cancellations/quote`**Purpose:** Preview the cancellation without executing it**When to use:*** Customer wants to cancel* You need to show refund amount before confirming**Response includes:*** Cancellation fee (if any)* Refund amount* **Cancellation token** (for the confirm step)**Nothing is cancelled yet** - this is just a quote.#### Step 2: Cancel Confirm**Endpoint:** `POST /v2/bookings/parking/{booking-reference}/cancellations/confirm`**Purpose:** Actually cancel the booking**When to use:*** Customer has seen the refund amount and confirmed* You're ready to process the cancellation**Request requires:*** **Cancellation token** (from the quote response)**Response includes:*** Confirmation of cancellation* Final refund amounts**Important:** Cancellations cannot be undone. The customer would need to create a new booking.**Typical workflow:**```1. Customer clicks \"Cancel booking\"2. Call Cancel Quote → Show \"You'll receive a £40.99 refund\"3. Customer clicks \"Confirm cancellation\"4. Call Cancel Confirm with token → Booking cancelled5. Show confirmation```---## Common Workflows### Workflow 1: Standard Booking Flow```1. GET /v2/locations   → Show airport selector2. GET /v2/products/parking?location_code=LHR&...   → Show available parking products with prices   → Save price_guarantee_token from response3. [Optional] GET /v2/content/parking   → Show detailed product information4. POST /v2/bookings/parking   → Include the price_guarantee_token   → Create booking5. GET /v2/bookings/parking/{booking-reference}/confirmation-details?format=html   → Display confirmation to customer   → Send confirmation email```### Workflow 2: Customer Wants to View Their Booking**Scenario A: Customer has our booking reference**```1. GET /v2/bookings/parking/{booking-reference}   → Show booking details```**Scenario B: Customer only has your order number**```1. GET /v2/bookings/parking?partner_reference={your-ref}   → Returns array of bookings2. Display list of bookings to customer3. Customer selects booking → Use our booking_reference4. GET /v2/bookings/parking/{booking-reference}   → Show booking details```### Workflow 3: Customer Wants to Change Flight Details```1. GET /v2/bookings/parking/{booking-reference}   → Get current booking details   → Show to customer2. Customer enters new flight details3. PATCH /v2/bookings/parking/{booking-reference}/amendments/quote   → Pass new flight details   → Get amendment_token4. Show customer: \"Amendment fee: £5.00\"   → Customer confirms5. POST /v2/bookings/parking/{booking-reference}/amendments/confirm   → Include amendment_token   → Booking updated6. GET /v2/bookings/parking/{booking-reference}/confirmation-details?format=html   → Send updated confirmation email```### Workflow 4: Customer Wants to Cancel```1. GET /v2/bookings/parking/{booking-reference}   → Get current booking details2. PATCH /v2/bookings/parking/{booking-reference}/cancellations/quote   → Get cancellation_token and refund amount3. Show customer: \"You'll receive a refund of £40.99\"   → Customer confirms4. POST /v2/bookings/parking/{booking-reference}/cancellations/confirm   → Include cancellation_token   → Booking cancelled5. Show confirmation: \"Booking cancelled.\"```",
+        "title": "APIConnect (Partner API 2026) - Understanding the OpenAPI Documentation",
+        "content": "# APIConnect (Partner API 2026) - Understanding the OpenAPI DocumentationDocument Version: 0.2 Last Updated: 2026-03-18This document is in Beta---## Purpose of This GuideThis guide helps you navigate the Swagger/OpenAPI documentation by explaining the **context** and **workflow** of the API endpoints. While Swagger shows you *what* each endpoint does, this guide explains *when* and *why* to use each endpoint, and how they work together.## OpenAPI SpecificationThe openapi schema for the API can be found at This is a live document and is expected to be updated.This can be viewed using a tool of your choice. We recommend  or importing the schema into [Postman](https://www.postman.com/).---## Table of Contents1. [API Architecture Overview](#api-architecture-overview)2. [Core Concepts](#core-concepts)3. [The Customer Journey](#the-customer-journey)4. [Common Workflows](#common-workflows)---## API Architecture Overview### Product-Centric DesignThe APIConnect API is built around **products**. Each of our products has the same set of endpoints:**Available Products:*** **Parking** - Airport car parking**Coming Soon*** **Transfers** - Airport transfers* **Hotels** - Airport hotel accommodation* **Hotel with Parking** - Integrated packages* **Lounges** - Airport lounge access* **FastTrack** - Priority security lanes**Endpoint Pattern:** When you see endpoints in the OpenAPI schema like:* `GET /v2/products/parking`* `GET /v2/products/hotels`* `GET /v2/products/lounges`These all follow the same pattern - just replace the product type.### The One Exception: LocationsThe **Locations** endpoint is the only endpoint that doesn't follow the product-specific pattern. It's used to discover which locations (airports) have which products available.---## Core Concepts### 1. Price Guarantee Tokens**What:** A time-limited token that locks in a price **When:** Obtained from the Products endpoint **Why:** Ensures customers aren't charged more than the quoted price **Validity:** 30 minutes **Usage:** Required for Book endpoint**Example Flow:**```1. Customer searches → Products endpoint returns price + token2. Customer sees price: £45.993. Customer books → Pass token to Book endpoint4. API validates token → Price has increased to £48.995. API only charges £45.99 (the guaranteed price)```### 2. Booking Reference vs Partner Reference**Booking Reference:*** **Format:** e.g., `HX123456`* **Source:** Generated by APIConnect* **Uniqueness:** Guaranteed unique* **Usage:** Use this for View Booking, Amend, Cancel endpoints* **Why:** This is our internal identifier that pinpoints a single booking**Partner Reference:*** **Format:** Your choice (e.g., `ORDER-12345`)* **Source:** Provided by you* **Uniqueness:** NOT guaranteed unique (up to you to manage)* **Usage:** Use this for List Bookings endpoint only* **Why:** Helps you match our bookings to your internal systems### 3. Quote and Confirm PatternFor amendments and cancellations, we use a two-step \"quote and confirm\" pattern:**Quote Step:*** Preview what will happen* Get costs/refunds calculated* Receive a token* Nothing is actioned yet**Confirm Step:*** Use the token from the quote* Actually execute the change* Booking is modified/cancelled* Customer is charged/refunded**Why this pattern?** It allows customers to see the financial impact before committing to the change.---## The Customer Journey### Stage 1: Discovery**Endpoint:** `GET /v2/locations`**Purpose:** Find out which airports have which products available**When to use:*** User hasn't selected a location yet* Building a location selector* Need to show available products by location**Response includes:*** Location types* Location codes (IATA / UNLOCODE)* Location names* Available product types at each location**Caching:** Safe to cache for 24 hours---### Stage 2: Product Search**Endpoint:** `GET /v2/products/parking`**Purpose:** Search for available products with pricing**When to use:*** Customer has selected location and dates* You need availability and pricing* This is always the first step in the booking flow**Parking-specific parameter options:**For parking products, you have flexibility in how you specify timing. You can provide **either** set of parameters:**Option 1: Explicit parking times*** `parking_entry_date_time` - When the customer will arrive at the car park* `parking_exit_date_time` - When the customer will leave the car parkUse this when you know the exact parking duration needed.**Option 2: Flight-based calculation*** `outbound_flight_number` - Departure flight number* `outbound_flight_date_time` - Departure flight time* `inbound_flight_number` - Return flight number* `inbound_flight_date_time` - Return flight timeUse this when you want the API to calculate appropriate parking times based on flight schedules. The API will automatically add buffer time for airport arrival/departure.**Important rules:*** At least one set of parameters must be provided* If both sets are provided, `parking_entry_date_time` and `parking_exit_date_time` take precedence* Flight-based calculation is useful when you're unsure how much time customers need between parking and their flight**Response includes:*** List of available products* Pricing for each product* **Price guarantee token** (important!)* Product capabilities (modifiable, cancellable, etc.)* Basic product information* Supplier required information**Important:** The price guarantee token will expire — the expiry time is included in the response. Using an expired token will return a `422 Unprocessable Entity` error. If this happens, re-run the search to get a fresh token.**Caching:** DO NOT cache this response - prices and availability change frequently---### Stage 3: Content Enrichment (Optional)**Endpoint:** `GET /v2/content/parking`Examples:* `GET /v2/content/parking`**Purpose:** Get detailed product information, images, descriptions, and features**When to use:*** Customer clicks on a product to see more details* You want to show rich product information* Building a product details page**Response includes:*** Full product descriptions (multi-language)* Images and gallery* Detailed features and amenities* Location details and directions**Caching:** Safe to cache - check response headers for cache duration**Why separate from Products?** Content is large and changes less frequently. Separating it allows the Products endpoint to be fast and efficient, while Content can be cached and only fetched when needed.---### Stage 4: Create Booking**Endpoint:** `POST /v2/bookings/parking`**Purpose:** Create a booking.**When to use:*** Customer has selected a product* Customer is ready to confirm the booking**Request requires:*** **Price guarantee token** (from the search results)* Customer details* Product-specific details (see product-specific integration guide)  * Parking: Vehicle details, flight info, entry/exit times  * Hotels: Room requirements, arrival time, guest count  * Lounges: Passenger details, flight info, visit time  * FastTrack: Passenger details, flight info, travel time* Your partner reference (optional but recommended)**Response includes:*** **Booking reference** (e.g., HX123456) - Our booking reference* **Booking status** (`pending` or `confirmed`)* **Hosted confirmation page URL** - A link to our hosted confirmation page* **Recommended polling interval** (in seconds) - Suggested frequency for status checks* All booking details**Important:** Always include an `Idempotency-Key` header to prevent duplicate bookings if there's a network error. Any unique string is accepted; UUID v4 is recommended. Re-use the same key to safely retry a failed request.**Understanding Booking Status:****Confirmed Status:*** The booking is fully confirmed with the supplier* Show confirmation details to the customer immediately* No further action needed**Pending Status:*** We have created the booking on our side* Our supplier is still processing the confirmation on their side* The booking will transition to either `confirmed` or `error`**Handling Pending Bookings - Four Options:**You have four options for handling pending bookings, depending on how much control you want:**Option 1: Hosted Confirmation Page (Simplest)*** Use the Holiday Extras co-branded hosted confirmation page URL included in the booking response* Direct customers to this URL* We handle all status updates and display logic* The page automatically updates when the booking confirms* No polling or webhooks needed on your side**Option 2: Confirmation Endpoint (Simple)*** Use the Confirmation endpoint (Stage 5) to display booking details* The data returned is always relevant to the current status* Shows \"pending\" messaging when pending, \"confirmed\" details when confirmed* Make the same call regardless of status - we handle the logic* No need to track status transitions yourself**Option 3: Polling (More Control)*** Call the GET booking endpoint (`GET /v2/bookings/parking/{booking-reference}`) repeatedly* Use the `recommended_polling_interval` from the booking response* Check the status field in each response* Stop polling when status changes to `confirmed` or `error`* You control the customer experience during the pending period**Option 4: Webhooks (Event-Driven)*** Build an endpoint on your side matching our webhook specification* We call your endpoint when the booking status changes* Your endpoint receives notification of the status update* Then call GET booking to retrieve the latest information* Most efficient for handling status updates**Recommendation:*** Use Option 1 or 2 if you want us to handle the complexity* Use Option 3 or 4 if you need full control over the customer experience---### Stage 5: Booking Confirmation Details**Endpoint:** `GET /v2/bookings/parking/{booking-reference}/confirmation-details`**Purpose:** Get formatted confirmation details for display**When to use:*** Immediately after booking is created* Displaying a confirmation page**Query parameters:*** `format`: `json` (default), `html`, or `markdown`**Response includes:*** All booking details formatted for display* Product-specific instructions (PIN codes, meeting points, etc.)* Contact information* Important notices**Format options:*** `json`: Returns an array of `{ type, value }` pairs (e.g., `{ \"type\": \"booking_reference\", \"value\": \"HX123456\" }`). Use these fields to build your own confirmation page.* `html`: Returns a `{ text }` object containing a ready-to-use HTML snippet for web pages.* `markdown`: Returns a `{ text }` object containing text-based format for simpler emails.**Why use this?** The formatted confirmation includes product-specific instructions. It's optimized for customer-facing display.---### Stage 6: View Booking**Endpoint:** `GET /v2/bookings/parking/{booking-reference}`**Purpose:** Retrieve a specific booking by our booking reference**When to use:*** Customer wants to view their booking* You need to check current booking status* Before allowing amendments or cancellations**Response includes:*** Complete booking details* Current status (pending, confirmed, cancelled, error)* Customer details**Important:** Use our **booking reference**, not your partner reference.---### Stage 7: List Bookings (Alternative Lookup)> This endpoint will be available in a later phase.**Endpoint:** `GET /v2/bookings/parking?partner_reference={your-reference}`**Purpose:** Find bookings using YOUR reference**When to use:*** Customer lost our booking reference* You need to look up by your internal order ID* You need to reconcile your orders with our bookings**Response includes:*** **Array of bookings** (not a single booking)* Each booking has our booking reference* Use our booking reference for subsequent operations**Why an array?** We don't guarantee your partner reference is unique. You might reuse order IDs or have multiple bookings per order. Therefore, we always return an array, even if there's only one result.**Next step:** Display the bookings to the customer and let them select which one they want to manage, then use our booking reference for amendments/cancellations.---### Stage 8: Amend Booking (Two-Step Process)#### Step 1: Amend Quote**Endpoint:** `PATCH /v2/bookings/parking/{booking-reference}/amendments/quote`**Purpose:** Preview the amendment without executing it**When to use:*** Customer wants to change booking details* You need to show pricing impact before confirming**Response includes:*** Amendment fee (if any)* Price difference (if dates/product changed)* Total charge or refund* **Amendment token** (for the confirm step)**Nothing is changed yet** - this is just a quote.#### Step 2: Amend Confirm**Endpoint:** `POST /v2/bookings/parking/{booking-reference}/amendments/confirm`**Purpose:** Actually execute the amendment**When to use:*** Customer has seen the quote and accepted it* You're ready to charge/refund the difference**Request requires:*** **Amendment token** (from the quote response)**Response includes:*** Updated booking details* Confirmation of changes* Receipt of any charges/refunds**Important:** The amendment token is short-lived, like the price guarantee token. Using an expired token will return a `422 Unprocessable Entity` error — re-request the amendment quote to get a fresh token.**Typical workflow:**```1. Customer clicks \"Change flight details\"2. Call Amend Quote → Show \"£5 amendment fee\"3. Customer clicks \"Confirm changes\"4. Call Amend Confirm with token → Booking updated```---### Stage 9: Cancel Booking (Two-Step Process)#### Step 1: Cancel Quote**Endpoint:** `PATCH /v2/bookings/parking/{booking-reference}/cancellations/quote`**Purpose:** Preview the cancellation without executing it**When to use:*** Customer wants to cancel* You need to show refund amount before confirming**Response includes:*** Cancellation fee (if any)* Refund amount* **Cancellation token** (for the confirm step)**Nothing is cancelled yet** - this is just a quote.#### Step 2: Cancel Confirm**Endpoint:** `POST /v2/bookings/parking/{booking-reference}/cancellations/confirm`**Purpose:** Actually cancel the booking**When to use:*** Customer has seen the refund amount and confirmed* You're ready to process the cancellation**Request requires:*** **Cancellation token** (from the quote response)**Response includes:*** Confirmation of cancellation* Final refund amounts**Important:** The cancellation token is short-lived. Using an expired token will return a `422 Unprocessable Entity` error — re-request the cancellation quote to get a fresh token. Cancellations cannot be undone; you would need to create a new booking.**Typical workflow:**```1. Customer clicks \"Cancel booking\"2. Call Cancel Quote → Show \"You'll receive a £40.99 refund\"3. Customer clicks \"Confirm cancellation\"4. Call Cancel Confirm with token → Booking cancelled5. Show confirmation```---## Common Workflows### Workflow 1: Standard Booking Flow```1. GET /v2/locations   → Show airport selector2. GET /v2/products/parking?location_code=LHR&...   → Show available parking products with prices   → Save price_guarantee_token from response3. [Optional] GET /v2/content/parking   → Show detailed product information4. POST /v2/bookings/parking   → Include the price_guarantee_token   → Create booking5. GET /v2/bookings/parking/{booking-reference}/confirmation-details?format=html   → Display confirmation to customer   → Send confirmation email```### Workflow 2: Customer Wants to View Their Booking**Scenario A: Customer has our booking reference**```1. GET /v2/bookings/parking/{booking-reference}   → Show booking details```**Scenario B: Customer only has your order number**```1. GET /v2/bookings/parking?partner_reference={your-ref}   → Returns array of bookings2. Display list of bookings to customer3. Customer selects booking → Use our booking_reference4. GET /v2/bookings/parking/{booking-reference}   → Show booking details```### Workflow 3: Customer Wants to Change Flight Details```1. GET /v2/bookings/parking/{booking-reference}   → Get current booking details   → Show to customer2. Customer enters new flight details3. PATCH /v2/bookings/parking/{booking-reference}/amendments/quote   → Pass new flight details   → Get amendment_token4. Show customer: \"Amendment fee: £5.00\"   → Customer confirms5. POST /v2/bookings/parking/{booking-reference}/amendments/confirm   → Include amendment_token   → Booking updated6. GET /v2/bookings/parking/{booking-reference}/confirmation-details?format=html   → Send updated confirmation email```### Workflow 4: Customer Wants to Cancel```1. GET /v2/bookings/parking/{booking-reference}   → Get current booking details2. PATCH /v2/bookings/parking/{booking-reference}/cancellations/quote   → Get cancellation_token and refund amount3. Show customer: \"You'll receive a refund of £40.99\"   → Customer confirms4. POST /v2/bookings/parking/{booking-reference}/cancellations/confirm   → Include cancellation_token   → Booking cancelled5. Show confirmation: \"Booking cancelled.\"```",
         "url": "/partner/v2/api-endpoint-navigation-guide/"
       }
       ,
@@ -564,7 +564,7 @@
     
       "partner-v2-problems-bad-request": {
         "title": "Bad Request",
-        "content": "# Bad Request| Field | Value ||-------|-------|| **Status** | 400 || **Code** | `bad_request` |The request was malformed or missing required parameters. Check the `errors` array for details on which fields failed validation.## Common causes- Missing required query parameters (e.g. `location_code`, `currency`)- Invalid parameter format (e.g. non-ISO datetime, invalid IATA code)- Missing or malformed request body on POST/PATCH endpoints## Example response```json{  \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/bad-request\",  \"title\": \"Bad Request\",  \"status\": 400,  \"code\": \"bad_request\",  \"errors\": [    {      \"field\": \"location_code\",      \"message\": \"must match pattern \\\"^[A-Z]{3}$\\\"\"    }  ]}```## How to resolveReview the `errors` array to identify which fields need correcting. Each error includes a `field` name and a `message` describing the validation failure.",
+        "content": "# Bad Request| Field | Value ||-------|-------|| **Status** | 400 || **Code** | `bad_request` |The request was malformed or missing required parameters. Check the `errors` array for details on which fields failed validation.## Common causes- Missing required query parameters (e.g. `location_code`, `currency`)- Invalid parameter format (e.g. non-ISO datetime, invalid IATA code)- Missing or malformed request body on POST/PATCH endpoints## Example response```json{  \"type\": \"https://docs.holidayextras.co.uk/partner/v2/problems/bad-request\",  \"title\": \"Bad Request\",  \"status\": 400,  \"code\": \"bad_request\",  \"errors\": [    {      \"field\": \"location_code\",      \"message\": \"must match pattern \\\"^[A-Z]{3}$\\\"\"    }  ]}```## How to resolveReview the `errors` array to identify which fields need correcting. Each error includes a `field` name and a `message` describing the validation failure.> **Note:** The `errors` array is always present in every error response. It will contain field-level details when applicable, or be empty (e.g., for 500 errors).",
         "url": "/partner/v2/problems/bad-request/"
       }
       ,
@@ -619,8 +619,8 @@
       ,
     
       "partner-v2-webhook-integration-guide": {
-        "title": "APIConnect Partner API v2 - Event Notifications",
-        "content": "# APIConnect Partner API v2 - Event NotificationsVersion: 1.0 Last Updated: 2026-01-29---## OverviewWebhooks allow you to receive real-time notifications when booking events occur. We'll send HTTP POST requests to your endpoint when booking states change.### When to Use WebhooksUse webhooks when you want to be notified about booking status changes, particularly for pending bookings that need confirmation.**Note:** If you use our hosted confirmation page or the confirmation endpoint (which handles status automatically), you may not need webhooks. See the [API Endpoint Navigation Guide](/partner/v2/api-endpoint-navigation-guide/#stage-4-create-booking) for alternatives.---## Configuration### Step 1: Create Your EndpointYour webhook endpoint must:* Accept HTTP POST requests* Be publicly accessible via HTTPS (valid SSL certificate required)* Respond with HTTP 200 within 10 seconds* Verify the signature we send (security requirement)### Step 2: Speak With Your Partnerships ManagerLet your partnerships manager know your endpoint and they will configure it within the Holiday Extras APIConnect platform**Important:** Store your webhook secret securely (environment variable or vault).---## Event Payload StructureAll webhook events follow this structure:```json{  \"collection_id\": \"550e8400-e29b-41d4-a716-446655440000\",  \"event_type\": \"booking.confirmed\",  \"timestamp\": \"2026-01-29T10:30:45.123Z\",  \"correlation_id\": \"c7f8e3d2-a1b4-4c5d-9e8f-7a6b5c4d3e2f\",  \"trace_id\": \"trace_abc123xyz789\",  \"source\": \"APIConnect\",  \"data\": {    \"booking_reference\": \"HX123456\",    \"partner_reference\": \"ORDER-12345\"  }}```### Envelope Fields| Field | Purpose | How to Use ||-------|---------|------------|| `collection_id` | Unique event identifier | Use for deduplication - store this to prevent processing the same event twice || `event_type` | Type of event | Describes what has occurred || `timestamp` | When event occurred | For ordering events and auditing || `correlation_id` | Groups related events | For tracking the entire booking lifecycle || `trace_id` | Debug identifier | Include in support requests || `source` | Who sent this webhook | Verification purposes || `data.booking_reference` | Our booking reference | Use to fetch full booking details via API || `data.partner_reference` | Your reference | Match to your internal order/transaction |### Why Thin Payloads?The webhook contains **only identifiers**, not full booking details. This is intentional:* You always get fresh data by calling the API* No risk of processing stale information* Consistent data structure across all events**After receiving a webhook, call:** `GET /api/v1/bookings/{booking_reference}` to fetch full booking details.---## Event Types| Event Type | When Sent | Typical Action ||------------|-----------|----------------|| `booking.confirmed` | Supplier confirms | Fetch booking details, update database, send confirmation email || `booking.failed` | Supplier rejects | Fetch failure reason, process refund, notify customer |## Security: Signature VerificationEvery webhook includes an HMAC-SHA256 signature in the `X-HX-Signature` header. You **must** verify this signature to ensure the webhook came from us.### Request Headers```httpPOST /webhooks/apiconnect HTTP/1.1Host: api.yourcompany.comContent-Type: application/jsonX-HX-Signature: sha256=a1b2c3d4e5f6...X-HX-Timestamp: 1738152645X-HX-Collection-Id: 550e8400-e29b-41d4-a716-446655440000{...webhook payload...}```---## Handling DuplicatesWebhooks use **at-least-once delivery**, meaning the same event may be delivered multiple times.---",
+        "title": "APIConnect (Partner API 2026) - Event Notifications",
+        "content": "# APIConnect (Partner API 2026) - Event NotificationsVersion: 1.0 Last Updated: 2026-01-29---## OverviewWebhooks allow you to receive real-time notifications when booking events occur. We'll send HTTP POST requests to your endpoint when booking states change.### When to Use WebhooksUse webhooks when you want to be notified about booking status changes, particularly for pending bookings that need confirmation.**Note:** If you use our hosted confirmation page or the confirmation endpoint (which handles status automatically), you may not need webhooks. See the [API Endpoint Navigation Guide](/partner/v2/api-endpoint-navigation-guide/#stage-4-create-booking) for alternatives.---## Configuration### Step 1: Create Your EndpointYour webhook endpoint must:* Accept HTTP POST requests* Be publicly accessible via HTTPS (valid SSL certificate required)* Respond with HTTP 200 within 10 seconds* Verify the signature we send (security requirement)### Step 2: Speak With Your Partnerships ManagerLet your partnerships manager know your endpoint and they will configure it within the Holiday Extras APIConnect platform**Important:** Store your webhook secret securely (environment variable or vault).---## Event Payload StructureAll webhook events follow this structure:```json{  \"collection_id\": \"550e8400-e29b-41d4-a716-446655440000\",  \"event_type\": \"booking.confirmed\",  \"timestamp\": \"2026-01-29T10:30:45.123Z\",  \"correlation_id\": \"c7f8e3d2-a1b4-4c5d-9e8f-7a6b5c4d3e2f\",  \"trace_id\": \"trace_abc123xyz789\",  \"source\": \"APIConnect\",  \"data\": {    \"booking_reference\": \"HX123456\",    \"partner_reference\": \"ORDER-12345\"  }}```### Envelope Fields| Field | Purpose | How to Use ||-------|---------|------------|| `collection_id` | Unique event identifier | Use for deduplication - store this to prevent processing the same event twice || `event_type` | Type of event | Describes what has occurred || `timestamp` | When event occurred | For ordering events and auditing || `correlation_id` | Groups related events | For tracking the entire booking lifecycle || `trace_id` | Debug identifier | Include in support requests || `source` | Who sent this webhook | Verification purposes || `data.booking_reference` | Our booking reference | Use to fetch full booking details via API || `data.partner_reference` | Your reference | Match to your internal order/transaction |### Why Thin Payloads?The webhook contains **only identifiers**, not full booking details. This is intentional:* You always get fresh data by calling the API* No risk of processing stale information* Consistent data structure across all events**After receiving a webhook, call:** `GET /api/v1/bookings/{booking_reference}` to fetch full booking details.---## Event Types| Event Type | When Sent | Typical Action ||------------|-----------|----------------|| `booking.confirmed` | Supplier confirms | Fetch booking details, update database, send confirmation email || `booking.failed` | Supplier rejects | Fetch failure reason, process refund, notify customer |## Security: Signature VerificationEvery webhook includes an HMAC-SHA256 signature in the `X-HX-Signature` header. You **must** verify this signature to ensure the webhook came from us.### Request Headers```httpPOST /webhooks/apiconnect HTTP/1.1Host: api.yourcompany.comContent-Type: application/jsonX-HX-Signature: sha256=a1b2c3d4e5f6...X-HX-Timestamp: 1738152645X-HX-Collection-Id: 550e8400-e29b-41d4-a716-446655440000{...webhook payload...}```---## Handling DuplicatesWebhooks use **at-least-once delivery**, meaning the same event may be delivered multiple times.---",
         "url": "/partner/v2/webhook-integration-guide/"
       }
       ,
diff --git a/site/partner/v2/api-endpoint-navigation-guide.md b/site/partner/v2/api-endpoint-navigation-guide.md
index 8863473b..245b72ec 100644
--- a/site/partner/v2/api-endpoint-navigation-guide.md
+++ b/site/partner/v2/api-endpoint-navigation-guide.md
@@ -1,6 +1,6 @@
-# APIConnect Partner API v2 - Understanding the OpenAPI Documentation
+# APIConnect (Partner API 2026) - Understanding the OpenAPI Documentation
 
-Document Version: 0.1 Last Updated: 2026-01-30
+Document Version: 0.2 Last Updated: 2026-03-18
 
 This document is in Beta
 
@@ -37,7 +37,7 @@ This can be viewed using a tool of your choice. We recommend <https://editor.swa
 
 ### Product-Centric Design
 
-The APIConnect API is built around **products**. Each of our five products has the same set of endpoints:
+The APIConnect API is built around **products**. Each of our products has the same set of endpoints:
 
 **Available Products:**
 
@@ -45,6 +45,7 @@ The APIConnect API is built around **products**. Each of our five products has t
 
 **Coming Soon**
 
+* **Transfers** - Airport transfers
 * **Hotels** - Airport hotel accommodation
 * **Hotel with Parking** - Integrated packages
 * **Lounges** - Airport lounge access
@@ -195,7 +196,7 @@ Use this when you want the API to calculate appropriate parking times based on f
 * Basic product information
 * Supplier required information
 
-**Important:** The price guarantee token will expire. We will inform you in the API response of this duration. If the customer takes longer to book, you'll need to search again to get a fresh token.
+**Important:** The price guarantee token will expire — the expiry time is included in the response. Using an expired token will return a `422 Unprocessable Entity` error. If this happens, re-run the search to get a fresh token.
 
 **Caching:** DO NOT cache this response - prices and availability change frequently
 
@@ -262,7 +263,7 @@ Examples:
 * **Recommended polling interval** (in seconds) - Suggested frequency for status checks
 * All booking details
 
-**Important:** Always include an `Idempotency-Key` header to prevent duplicate bookings if there's a network error.
+**Important:** Always include an `Idempotency-Key` header to prevent duplicate bookings if there's a network error. Any unique string is accepted; UUID v4 is recommended. Re-use the same key to safely retry a failed request.
 
 **Understanding Booking Status:**
 
@@ -346,9 +347,9 @@ You have four options for handling pending bookings, depending on how much contr
 
 **Format options:**
 
-* `json`: Structured data for your own rendering
-* `html`: Ready-to-use HTML snippet for web pages
-* `markdown`: Text-based format for simpler emails
+* `json`: Returns an array of `{ type, value }` pairs (e.g., `{ "type": "booking_reference", "value": "HX123456" }`). Use these fields to build your own confirmation page.
+* `html`: Returns a `{ text }` object containing a ready-to-use HTML snippet for web pages.
+* `markdown`: Returns a `{ text }` object containing text-based format for simpler emails.
 
 **Why use this?** The formatted confirmation includes product-specific instructions. It's optimized for customer-facing display.
 
@@ -381,6 +382,8 @@ You have four options for handling pending bookings, depending on how much contr
 
 ### Stage 7: List Bookings (Alternative Lookup)
 
+> This endpoint will be available in a later phase.
+
 **Endpoint:** `GET /v2/bookings/parking?partner_reference={your-reference}`
 
 **Purpose:** Find bookings using YOUR reference
@@ -447,7 +450,7 @@ You have four options for handling pending bookings, depending on how much contr
 * Confirmation of changes
 * Receipt of any charges/refunds
 
-**Important:** The amendment token works the same as the price guarantee token.
+**Important:** The amendment token is short-lived, like the price guarantee token. Using an expired token will return a `422 Unprocessable Entity` error — re-request the amendment quote to get a fresh token.
 
 **Typical workflow:**
 
@@ -502,7 +505,7 @@ You have four options for handling pending bookings, depending on how much contr
 * Confirmation of cancellation
 * Final refund amounts
 
-**Important:** Cancellations cannot be undone. The customer would need to create a new booking.
+**Important:** The cancellation token is short-lived. Using an expired token will return a `422 Unprocessable Entity` error — re-request the cancellation quote to get a fresh token. Cancellations cannot be undone; you would need to create a new booking.
 
 **Typical workflow:**
 
diff --git a/site/partner/v2/problems/bad-request.md b/site/partner/v2/problems/bad-request.md
index e2210f62..fa89889f 100644
--- a/site/partner/v2/problems/bad-request.md
+++ b/site/partner/v2/problems/bad-request.md
@@ -33,3 +33,5 @@ The request was malformed or missing required parameters. Check the `errors` arr
 ## How to resolve
 
 Review the `errors` array to identify which fields need correcting. Each error includes a `field` name and a `message` describing the validation failure.
+
+> **Note:** The `errors` array is always present in every error response. It will contain field-level details when applicable, or be empty (e.g., for 500 errors).
diff --git a/site/partner/v2/webhook-integration-guide.md b/site/partner/v2/webhook-integration-guide.md
index 976f9e28..fda933af 100644
--- a/site/partner/v2/webhook-integration-guide.md
+++ b/site/partner/v2/webhook-integration-guide.md
@@ -1,4 +1,4 @@
-# APIConnect Partner API v2 - Event Notifications
+# APIConnect (Partner API 2026) - Event Notifications
 
 Version: 1.0 Last Updated: 2026-01-29