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 Property Listings

GET
/api/v1/external-app/get-property-listings
Last modified:2026-05-03 12:38:52
Returns a list of all properties belonging to your company. Supports filtering, sorting, and pagination via query parameters.

Query Parameters#

Pagination#

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

Filtering#

Filters are passed via the q parameter as a query string. 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 across name, type, addressStreet, addressCity, addressCountry, and id
idnumberFilter by exact property ID
namestringFilter by property name
typestringFilter by property type (e.g. Mix)
areaLocationIdnumberFilter by area/locality location ID
cityLocationIdnumberFilter by city location ID
latitidefloatFilter by location latitude
longitudefloatFilter by location longitude

Operators#

OperatorMeaning
:=Exact match
~=Contains (partial match)
>=Greater than or equal
<=Less than or equal
!=Not equal

Filter Examples#

# Filter by name (partial match)
GET /api/v1/external-app/get-property-listings?q=name~=Aston

# Filter by exact property ID
GET /api/v1/external-app/get-property-listings?q=id:=462

# Combine multiple filters
GET /api/v1/external-app/get-property-listings?q=name~=Aston$$type:=Mix

Sorting#

ParameterTypeOptionsDefault
sortstringcreatedAt, updatedAt, name, type, addressCityname
orderstringasc, descasc

Additional Parameters#

ParameterTypeDescription
channelIdnumberFilter pricing (startingPrice, minPrice, maxPrice) by a specific channel's rates

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 ********************
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-property-listings' \
--header 'User-Agent: insomnia/11.4.0' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "properties": [
        {
            "id": 462,
            "status": "Live",
            "companyId": 11,
            "brandId": 2,
            "legalEntityId": 22,
            "legalEntity": {
                "id": 22,
                "name": "NISHTA DOZE AND DINE LLP",
                "logo": [],
                "wordmark": [],
                "data": {
                    "addressStreet": "B 505, Titanium Business Park",
                    "addressCountry": "India",
                    "addressCity": "Ahmedabad",
                    "addressState": "Gujarat",
                    "addressPincode": "380007",
                    "pan": "AAYFN4706A",
                    "gstin": "24AAYFN4706A1ZC",
                    "cin": "U74999UR2020PTC010632",
                    "phone": "+913879328892",
                    "email": "info@cirkle.co.in"
                },
                "channelId": null,
                "companyId": 11,
                "isDeleted": false,
                "createdById": 8091,
                "updatedById": 8091,
                "createdAt": "2025-07-24T18:03:09+05:30",
                "updatedAt": "2026-03-17T12:20:01+05:30"
            },
            "rentAgreementTemplateId": null,
            "rentAgreementAddendumTemplateId": null,
            "photos": [],
            "type": "Mix",
            "residentType": "Both",
            "name": "The Aston - Japandi",
            "description": null,
            "genders": "Any",
            "totalFloors": 1,
            "addressStreet": "2 Kay Poh Road",
            "addressCountry": "India",
            "addressCity": "Singapore",
            "addressPincode": "248973",
            "addressState": "River Valley",
            "locationId": null,
            "onboardingStep": 2,
            "info": {
                "rentalStructure": {
                    "description": "",
                    "photos": []
                },
                "paymentPlan": {
                    "description": "",
                    "photos": []
                },
                "wifi": {
                    "description": "",
                    "photos": []
                },
                "mess": {
                    "description": "",
                    "photos": []
                },
                "payments": {
                    "description": "",
                    "photos": []
                },
                "whatsappNumber": "+917899119911"
            },
            "note": null,
            "localization": {
                "countryCode": "sg",
                "currency": "SGD",
                "language": "en",
                "timezone": "Asia/Singapore",
                "translations": {}
            },
            "bookingAutoDiscardConfig": {
                "isActive": false,
                "expirySeconds": {
                    "No Beds Assigned": null,
                    "No Payment Done": null,
                    "Reservation Payment Pending": null,
                    "Check-In Payment Pending": null
                }
            },
            "createdById": 8091,
            "updatedById": 8091,
            "createdAt": "2026-04-10T14:43:36+05:30",
            "updatedAt": "2026-04-13T14:09:57+05:30",
            "statusKey": 2,
            "amenities": [],
            "amenityIds": [],
            "excludedAmenities": [],
            "excludedAmenityIds": [],
            "amenityConnections": [],
            "fullAddress": "2 Kay Poh Road, Singapore, River Valley, 248973",
            "startingPrice": 100,
            "minPrice": 100,
            "maxPrice": 3500,
            "location": null,
            "settings": {
                "maxAdvanceBookingDays": 30
            }
        },
        {
            "id": 454,
            "status": "Live",
            "companyId": 11,
            "brandId": 5,
            "legalEntityId": 22,
            "legalEntity": {
                "id": 22,
                "name": "NISHTA DOZE AND DINE LLP",
                "logo": [],
                "wordmark": [],
                "data": {
                    "addressStreet": "B 505, Titanium Business Park",
                    "addressCountry": "India",
                    "addressCity": "Ahmedabad",
                    "addressState": "Gujarat",
                    "addressPincode": "380007",
                    "pan": "AAYFN4706A",
                    "gstin": "24AAYFN4706A1ZC",
                    "cin": "U74999UR2020PTC010632",
                    "phone": "+913879328892",
                    "email": "info@cirkle.co.in"
                },
                "channelId": null,
                "companyId": 11,
                "isDeleted": false,
                "createdById": 8091,
                "updatedById": 8091,
                "createdAt": "2025-07-24T18:03:09+05:30",
                "updatedAt": "2026-03-17T12:20:01+05:30"
            },
            "rentAgreementTemplateId": null,
            "rentAgreementAddendu
Modified at 2026-05-03 12:38:52
Previous
Booking Engine
Next
Get Bed Availability
Built with