Deadline Cases
How We Calculate the Deadline Timezone
Case 1 ✅
If the Seller provides a complete deadline with timezone information in their API response, we use that data to convert the deadline to UTC-0.
Example:
- For a rate with a check-in date of 25/08/2022:
- If the Seller returns the deadline as
2022-08-24T09:00:00.00+03
, we will convert and return it as2022-08-24T06:00:00Z
in theDeadline
node.
- If the Seller returns the deadline as
Case 2 ✅
If the Seller does not provide a complete deadline with timezone information in their API response but confirms their working timezone via a Support Case, we use that timezone to convert the deadline to UTC-0.
For a rate with a check-in date of 25/08/2022, where the Seller operates in UTC+5:
- Example 1: If the Seller provides
2022-08-24T09:00:00.00
, we will return2022-08-24T04:00:00Z
in theDeadline
node. - Example 2: If the Seller specifies
DaysBefore:1
, we will return2022-08-23T19:00:00Z
. - Example 3: If the Seller provides
23/08/2022
, we will return2022-08-22T19:00:00Z
. - Example 4: If the Seller provides
HoursPriorCheckIn:48
, we will return2022-08-22T19:00:00Z
.
Case 3 ✅
If the Seller states (via a Support Case) that their timezone is unknown or based on the Buyer’s timezone, we apply a +14-hour buffer to the Deadline
node as a precautionary measure to avoid penalties.
For a rate with a check-in date of 25/08/2022:
- Example 1: If the Seller provides
2022-08-24T09:00:00.00
, we will return2022-08-23T19:00:00Z
. - Example 2: If the Seller specifies
DaysBefore:1
, we will return2022-08-23T10:00:00Z
. - Example 3: If the Seller provides
23/08/2022
, we will return2022-08-22T10:00:00Z
. - Example 4: If the Seller provides
HoursPriorCheckIn:48
, we will return2022-08-22T10:00:00Z
.
Example: Cancellation Policy Interpretation
The deadline is the specific date and time when a cancellation policy starts to apply. After this point, penalties will be charged if the booking is canceled.
Given the following cancellation policies for a booking with check-in on 2025-11-20:
"cancelPolicy": {
"refundable": true,
"cancelPenalties": [
{
"deadline": "2025-11-02T09:00:01Z",
"penaltyType": "IMPORT",
"currency": "EUR",
"value": 431.96
},
{
"deadline": "2025-11-16T09:00:01Z",
"penaltyType": "IMPORT",
"currency": "EUR",
"value": 863.92
}
]
}
- Before 2025-11-02 09:00 UTC → No penalty applies.
- From 2025-11-02 09:00 UTC to 2025-11-16 09:00 UTC → Penalty of €431.96.
- From 2025-11-16 09:00 UTC onwards → Penalty of €863.92.