Get Bed Availability
POST
/api/v1/external-app/get-bed-availability-for-property
Last modified:2026-05-03 12:38:55
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
propertyId | number | Yes | The ID of the property to check availability for. Obtain from Get Property Listings |
channelId | number | No | The channel ID to scope availability to. Obtain from Get Channels |
startDateTime | datetime | Yes | The desired move-in date and time (ISO 8601 format with timezone, e.g. 2026-07-18T15:40:41+05:30) |
endDateTime | datetime | Yes | The desired move-out date and time (ISO 8601 format with timezone, e.g. 2026-09-18T15:40:41+05:30) |
What's Returned
availability array, with one entry per room type. Each entry includes:| Field | Description |
|---|---|
roomTypeId | ID of the room type |
roomTypeName | Display name of the room type |
bedCount | Number of beds per room in this room type |
totalBeds / occupiedBeds / availableBeds | Overall bed counts across the property |
totalMaleBeds / occupiedMaleBeds / availableMaleBeds | Bed counts for male-allocated beds |
totalFemaleBeds / occupiedFemaleBeds / availableFemaleBeds | Bed counts for female-allocated beds |
roomsWithVacancyCount | A breakdown of rooms grouped by number of available beds (e.g. {"0": 2, "1": 5, "2": 15} means 2 rooms are full, 5 rooms have 1 vacancy, 15 rooms have 2 vacancies) |
maleRoomsWithVacancyCount | Same breakdown for male-allocated rooms |
femaleRoomsWithVacancyCount | Same breakdown for female-allocated rooms |
Authentication
Authorization header. Obtain one via the Credential Refresh endpoint.Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://server.wardenera.com/api/v1/external-app/get-bed-availability-for-property' \
--header 'User-Agent: insomnia/11.4.0' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"propertyId": 412,
"channelId": 32,
"startDateTime": "2026-07-18T15:40:41+05:30",
"endDateTime": "2026-09-18T15:40:41+05:30"
}'Response Response Example
{
"availability": [
{
"roomTypeId": 1385,
"roomTypeName": "Twin Sharing Room",
"bedCount": 2,
"totalFemaleBeds": 32,
"occupiedFemaleBeds": 1,
"availableFemaleBeds": 31,
"femaleRoomsWithVacancyCount": {
"0": 0,
"1": 1,
"2": 15
},
"totalMaleBeds": 32,
"occupiedMaleBeds": 1,
"availableMaleBeds": 31,
"maleRoomsWithVacancyCount": {
"0": 0,
"1": 1,
"2": 15
},
"totalBeds": 32,
"occupiedBeds": 1,
"availableBeds": 31,
"roomsWithVacancyCount": {
"0": 0,
"1": 1,
"2": 15
}
},
{
"roomTypeId": 1386,
"roomTypeName": "Triple Sharing Room",
"bedCount": 3,
"totalFemaleBeds": 39,
"occupiedFemaleBeds": 0,
"availableFemaleBeds": 39,
"femaleRoomsWithVacancyCount": {
"0": 0,
"1": 0,
"2": 0,
"3": 13
},
"totalMaleBeds": 48,
"occupiedMaleBeds": 0,
"availableMaleBeds": 48,
"maleRoomsWithVacancyCount": {
"0": 0,
"1": 0,
"2": 0,
"3": 16
},
"totalBeds": 48,
"occupiedBeds": 0,
"availableBeds": 48,
"roomsWithVacancyCount": {
"0": 0,
"1": 0,
"2": 0,
"3": 16
}
},
{
"roomTypeId": 1628,
"roomTypeName": "Private Room",
"bedCount": 1,
"totalFemaleBeds": 13,
"occupiedFemaleBeds": 0,
"availableFemaleBeds": 13,
"femaleRoomsWithVacancyCount": {
"0": 0,
"1": 13
},
"totalMaleBeds": 13,
"occupiedMaleBeds": 0,
"availableMaleBeds": 13,
"maleRoomsWithVacancyCount": {
"0": 0,
"1": 13
},
"totalBeds": 13,
"occupiedBeds": 0,
"availableBeds": 13,
"roomsWithVacancyCount": {
"0": 0,
"1": 13
}
}
],
"message": "Fetched all Bed Availability"
}Modified at 2026-05-03 12:38:55