Skip to main content
SpaPortal API date fields use ISO 8601 calendar dates in YYYY-MM-DD format. Examples: 
2026-04-01
2026-04-21
Date fields do not include a time or time zone.

​
Common fields

FieldMeaning
date_fromArrival date, start date, or the beginning of a search range in API v1.
date_toDeparture date, end date, or the end of a search range in API v1.
dateFromTarget API v2 equivalent of date_from.
dateToTarget API v2 equivalent of date_to.

​
Booking dates

For booking and price requests, date_from is the arrival date and date_to is the departure date. The departure date must be after the arrival date.

​
Availability ranges

Availability endpoints can also use date_from and date_to as a search range. When a range is omitted, the endpoint chooses defaults based on the nearest available booking period. Check the endpoint reference for endpoint-specific defaults.