Warden API
  1. Booking Engine
Warden External API
  • Warden External API
  • Auth
    • Credential Refresh
      GET
  • Booking Engine
    • Get Property Listings
      GET
    • Get Bed Availability
      POST
    • Get Room Type Listings
      GET
    • Get Plan Options for Channel and Room Types
      POST
    • Generate Plan for Channel and Room Types
      POST
    • Create Booking
      PUT
  • API
    • Get Company Details
      GET
    • Get Channels
      GET
    • Get Bookings
      GET
    • Get Residents
      GET
    • Get Payments
      GET
    • Get Transactions
      GET
  1. Booking Engine

Get Room Type Listings

GET
/api/v1/external-app/get-room-type-listings
Last modified:2026-05-03 12:38:58
Returns a list of room types across your properties. Use this alongside Get Property Listings to understand the room type inventory available at each property. The id returned here is used in subsequent calls such as Get Bed Availability and Get Plan Options.

Query Parameters#

Pagination#

ParameterTypeDefaultDescription
pagenumber0Page number (zero-indexed)
per_pagenumber50Number of results per page (max: 10000)

Filtering#

Filters are passed via the q parameter. Multiple filters can be combined using $$ as a separator.
Syntax: q=<filterKey><operator><value>
Combining filters: q=<filter1>$$<filter2>$$<filter3>

Available Filter Keys#

Filter KeyTypeDescription
searchTextstringSearch by room type name (partial match)
idnumberFilter by exact room type ID
propertyIdnumberFilter room types belonging to a specific property
categoryenumFilter by room type category. Allowed values: Residential, Utility
createdAtdatetimeFilter by creation date
updatedAtdatetimeFilter by last updated date

Operators#

OperatorMeaning
:=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-01

Authentication#

This endpoint requires a valid Bearer Token in the Authorization header. Obtain one via the Credential Refresh endpoint.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Header Params

Responses

🟢200
application/json
Body

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,
                    "update
Modified at 2026-05-03 12:38:58
Previous
Get Bed Availability
Next
Get Plan Options for Channel and Room Types
Built with