Get Room Type Listings
GET
/api/v1/external-app/get-room-type-listings
Last modified:2026-05-03 12:38:58
id returned here is used in subsequent calls such as Get Bed Availability and Get Plan Options.Query Parameters
Pagination
| Parameter | Type | Default | Description |
|---|---|---|---|
page | number | 0 | Page number (zero-indexed) |
per_page | number | 50 | Number of results per page (max: 10000) |
Filtering
q parameter. Multiple filters can be combined using $$ as a separator.q=<filterKey><operator><value>q=<filter1>$$<filter2>$$<filter3>Available Filter Keys
| Filter Key | Type | Description |
|---|---|---|
searchText | string | Search by room type name (partial match) |
id | number | Filter by exact room type ID |
propertyId | number | Filter room types belonging to a specific property |
category | enum | Filter by room type category. Allowed values: Residential, Utility |
createdAt | datetime | Filter by creation date |
updatedAt | datetime | Filter by last updated date |
Operators
| Operator | Meaning |
|---|---|
:= | Exact match |
~= | Contains (partial match) |
>= | Greater than or equal |
<= | Less than or equal |
!= | Not equal |
Filter Examples
# Get all room types for a specific property
GET /api/v1/external-app/get-room-type-listings?q=propertyId:=462
# Get only Residential room types for a property
GET /api/v1/external-app/get-room-type-listings?q=propertyId:=462$$category:=Residential
# Search by name
GET /api/v1/external-app/get-room-type-listings?q=searchText~=Deluxe
# Get room types created after a specific date
GET /api/v1/external-app/get-room-type-listings?q=createdAt>=2026-01-01Authentication
Authorization header. Obtain one via the Credential Refresh endpoint.Request
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://server.wardenera.com/api/v1/external-app/get-room-type-listings?q=id:=1385' \
--header 'User-Agent: insomnia/11.4.0' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"roomTypes": [
{
"id": 1654,
"propertyId": 412,
"name": "Amenities",
"description": "<p>Built for student life, this campus property offers a balanced living experience with both private and shared amenities. Residents enjoy the comfort of essential personal facilities along with access to common spaces and shared services that make day-to-day living easier, more social, and more dependable.</p>",
"category": "Utility",
"rent": null,
"bedCount": 1,
"photos": [
{
"id": 287287,
"status": "Ready",
"type": "Image",
"name": "1773071502268Whisk_70e74078b3a6003bb394c50a7a750c8edr.jpeg",
"extension": "jpeg",
"contentType": "image/jpeg",
"tags": null,
"paymentId": null,
"transactionId": null,
"contractId": null,
"taskId": null,
"propertyId": null,
"roomTypeId": 1654,
"amenityId": null,
"bookingId": null,
"logoBrandId": null,
"wordmarkBrandId": null,
"logoLegalEntityId": null,
"wordmarkLegalEntityId": null,
"url": "https://d4jiabh6qs3x1.cloudfront.net/company_11/room_types_1654/1773071502268Whisk_70e74078b3a6003bb394c50a7a750c8edr.jpeg?Expires=1778400456&Key-Pair-Id=K16RJR5G26NUQ&Signature=M8AtenmjUnSbHVXr4cPFEZ6tdT6U9r1h~kKqHFOyLNor4Z8Gk3zWwvOpwMNC2OFpMD3TYoirVtaKUhWehcjei4FWdhxjvrzzgjuPx2SyZ-tdWpD6NVoW7dJRDUi8gQhhqhgyuLYgWyXnVRxg0tYlQGu1ko9J1nmTMU~hdTbheMakgv3fE9uYnY9V-n1CjTjP4pwo0fwmVI7butw65eyGvW5YZh4vKBPXzuvNoSzSr7kwUVtgrrXdF~s2l~vFkTWhB5Sww5U61F1arpWSCobQ8u1aMTlXV7imtsdyjMUOts29WZIvcHhOeXb6x5nSJpW5dsdV6uRbtojCos5Egw~vmg__",
"path": "company_11/room_types_1654/1773071502268Whisk_70e74078b3a6003bb394c50a7a750c8edr.jpeg",
"uploadUrl": "https://arden-production.s3.ap-south-1.amazonaws.com/company_11/room_types_1654/1773071502268Whisk_70e74078b3a6003bb394c50a7a750c8edr.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXYKJWREF7AJWZEAM%2F20260309%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20260309T155253Z&X-Amz-Expires=60&X-Amz-Signature=3f0f685453e8d040a33e0a620707bd360ba2deea69d6019abc278cdf14d960fd&X-Amz-SignedHeaders=host&x-id=PutObject",
"expiresAt": "2026-03-16T20:22:54+05:30",
"createdById": 64081,
"updatedById": 64081,
"createdAt": "2026-03-09T21:22:53+05:30",
"updatedAt": "2026-03-09T21:22:53+05:30"
},
{
"id": 287288,
"status": "Ready",
"type": "Image",
"name": "1773071502275Whisk_c27f639396611b8ae2443fbeead773eddr.png",
"extension": "png",
"contentType": "image/png",
"tags": null,
"paymentId": null,
"transactionId": null,
"contractId": null,
"taskId": null,
"propertyId": null,
"roomTypeId": 1654,
"amenityId": null,
"bookingId": null,
"logoBrandId": null,
"wordmarkBrandId": null,
"logoLegalEntityId": null,
"wordmarkLegalEntityId": null,
"url": "https://d4jiabh6qs3x1.cloudfront.net/company_11/room_types_1654/1773071502275Whisk_c27f639396611b8ae2443fbeead773eddr.png?Expires=1778400456&Key-Pair-Id=K16RJR5G26NUQ&Signature=ZiVz~Ifew0dgb~4ROPUQDLffiBBmKgwYvDB0lHuofrZ5AyJYjJidzWy51ok0-SS7dPb0s2UN9~LMA8CydVv6nJ2y5h~o-NCgGt759zYizs7eZHIvXEk1RDod6vxFiyxIyZd70mZSH72n3khc2ynE0YGluXtyF--WaYr73LUj8BKP7xFHni3vnBdQokRG1JIzB1KT3VhlS4c1uGMljWUQVYGVl8UZd9b7Zhytbmkzidmsnpylhxd6SDJnB8lekAgD9BkSs-5Zwab8lUYtfsW1Qqc5yYovYX8~~TWrqmsgKx79Efa1gtNyzolrpDCWD9luKvjnReQhr9BfK4wDbTcc7w__",
"path": "company_11/room_types_1654/1773071502275Whisk_c27f639396611b8ae2443fbeead773eddr.png",
"uploadUrl": "https://arden-production.s3.ap-south-1.amazonaws.com/company_11/room_types_1654/1773071502275Whisk_c27f639396611b8ae2443fbeead773eddr.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAXYKJWREF7AJWZEAM%2F20260309%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20260309T155253Z&X-Amz-Expires=60&X-Amz-Signature=616d513741fe22783d581ee3f7b0aa43e1a91e69fb2f81bf1b2fbb2720d524a7&X-Amz-SignedHeaders=host&x-id=PutObject",
"expiresAt": "2026-03-16T20:22:54+05:30",
"createdById": 64081,
"updateModified at 2026-05-03 12:38:58