---
title: "Retrieves availability calendar data for all properties associated with the authenticated user for a given date range."
method: GET
path: "/v2/availability"
tags: ["Availability"]
---

# Retrieves availability calendar data for all properties associated with the authenticated user for a given date range.

`GET /v2/availability`

Retrieves availability calendar data for all properties associated with the authenticated user for a given date range.

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `includeDetails` boolean

## Response `200`

OK

- LodgifyApiPublicReservationsModelsV2AvailabilityCalendarDto[]
  - `user_id` integer — The unique identifier of the user who owns the property.
  - `property_id` integer — The unique identifier of the property.
  - `room_type_id` integer — The unique identifier of the room type.
  - `periods` LodgifyApiPublicReservationsModelsV2AvailabilityPeriodDto[], nullable — A collection of availability periods for the calendar.
    - `start` string — Start date of the period.
    - `end` string — End date of the period.
    - `available` integer — Number of available units for this period.
    - `closed_period` LodgifyApiPublicReservationsModelsV2AvailabilityClosedPeriodAvailabilityDto — Represents the availability details for a closed period.
      - `id` integer — The unique identifier for the closed period availability.
    - `bookings` LodgifyApiPublicReservationsModelsV2AvailabilityBookingAvailabilityDto[], nullable — Collection of bookings associated with this period.
      - `id` integer — The unique identifier of the booking.
      - `status` string, nullable — The current status of the booking.
    - `channel_calendars` LodgifyApiPublicReservationsModelsV2AvailabilityChannelCalendarAvailabilityDto[], nullable — Collection of channel calendar availability details for this period.
      - `id` integer — The unique identifier for the channel calendar availability.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/lodgify/apis/lodgify-public-api-v1.md) · [All operations](https://skmtc.net/lodgify/apis/lodgify-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lodgify/lodgify-public-api-v1/versions/ddf40757d411/schema)