Huurkalender Availability API

Endpoint

GET https://www.huurkalender.nl/api/calendar/{property_id}.json

Quick Examples

Check specific dates:

https://www.huurkalender.nl/api/calendar/1041.json?checkin=2026-01-18&checkout=2026-01-25

Check duration (nights):

https://www.huurkalender.nl/api/calendar/1041.json?date=2026-01-18&nights=3

Check today availability (default):

https://www.huurkalender.nl/api/calendar/1041.json

Response Format

✅ Available:

{
  "property_id": "1041",
  "checkin": "2026-01-18",
  "checkout": "2026-01-25",
  "nights": 3,
  "available": true,
  "message": "Available for 3 nights",
  "calendar_url": "https://www.huurkalender.nl/vacancy/calendar-1041.html",
  "booking_url": "https://www.huurkalender.nl/vacancy/booking/nieuw-1041.html?book_start=2026-01-18&book_end=2026-01-25"
}

❌ Not Available:

{
  "property_id": "1041",
  "checkin": "2026-01-18",
  "checkout": "2026-01-25",
  "nights": 3,
  "available": false,
  "calendar_url": "https://www.huurkalender.nl/vacancy/calendar-1041.html",
  "booking_url": "https://www.huurkalender.nl/vacancy/booking/nieuw-1041.html?book_start=2026-01-18&book_end=2026-01-25",
  "error": {
    "code": "UNAVAILABLE",
    "message": "Property is not available for selected dates"
  }
}

Error Codes

Code	Meaning
INVALID_ID	Property ID is invalid or missing
INVALID_DATE	Date format error (use YYYY-MM-DD)
PAST_DATE	Cannot book in the past
UNAVAILABLE	Dates are already booked
MINIMUM_STAY_NOT_MET	Too few nights (check minimum stay)
INVALID_ARRIVAL_DAY	Check-in not allowed on this weekday
INVALID_DEPARTURE_DAY	Check-out not allowed on this weekday

Test the API Now

Today availability (2025-12-29):
https://www.huurkalender.nl/api/calendar/1041.json

Specific dates (3 nights):
https://www.huurkalender.nl/api/calendar/1041.json?checkin=2026-01-28&checkout=2026-01-31

Duration based (5 nights):
https://www.huurkalender.nl/api/calendar/1041.json?date=2026-01-05&nights=5

Important Notes

All dates must be YYYY-MM-DD format
The available field is your primary indicator (true/false)
Use booking_url to redirect users to the booking page
Use calendar_url to show the visual calendar
Availability changes in real-time as bookings are made
API validates minimum stay, arrival/departure rules automatically

Parameter Reference

Parameter	Required	Format	Example
checkin	No	YYYY-MM-DD	2026-01-28
checkout	No	YYYY-MM-DD	2026-02-04
date	No	YYYY-MM-DD	2026-01-18
nights	No	Integer	3

If no parameters provided, checks today's availability (checkin and checkout on same day).

Questions or Suggestions?

If you have any questions about the API, need assistance with integration, or have suggestions for improvements, please contact us:

service@huurkalender.nl