Warden API
  1. API
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. API

Get Channels

GET
/api/v1/external-app/get-channels
Last modified:2026-05-03 12:27:38
Returns a list of channels configured for your company. A channel in Warden represents a source or partner through which bookings are made — such as a corporate client, an educational institution, or an online travel agent. The id returned here is used as the channelId in the booking flow.

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 exact channel name or id
idnumberFilter by exact channel ID
typeenumFilter by channel type. Allowed values: Corporate Entity, Educational Institute, Affiliate Partner, Online Travel Agents
isActivebooleanFilter by active status (true or false)
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 active channels
GET /api/v1/external-app/get-channels?q=isActive:=true

# Get channels of a specific type
GET /api/v1/external-app/get-channels?q=type:=Corporate Entity

# Combine filters
GET /api/v1/external-app/get-channels?q=type:=Affiliate Partner$$isActive:=true

Sorting#

ParameterTypeOptionsDefault
sortstringcreatedAt, updatedAtcreatedAt
orderstringasc, descdesc

Authentication#

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

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
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-channels' \
--header 'User-Agent: insomnia/11.4.0' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "channels": [
        {
            "id": 38,
            "status": "Draft",
            "isActive": true,
            "type": "Corporate Entity",
            "name": "Lagom Innovations",
            "companyId": 11,
            "primaryContactUserId": 28606,
            "isBookingEngineChannel": false,
            "bookingAutoDiscardConfig": {
                "isActive": false,
                "expirySeconds": {
                    "No Beds Assigned": 259200,
                    "Check-In Payment Pending": 864000,
                    "Reservation Payment Pending": 2592000
                }
            },
            "isDeleted": false,
            "createdAt": "2026-03-11T12:16:55+05:30",
            "updatedAt": "2026-03-11T13:29:06+05:30",
            "createdById": 87937,
            "updatedById": 87937,
            "rate": {
                "id": 191,
                "companyId": 11,
                "channelId": 38,
                "name": "Lagom Innovations",
                "description": "Auto generated rate for this channel",
                "isDeleted": false,
                "createdById": 87937,
                "updatedById": 87937,
                "createdAt": "2026-03-11T12:16:56+05:30",
                "updatedAt": "2026-03-11T12:16:56+05:30"
            },
            "legalEntity": {
                "id": 48,
                "name": "Lagom Innovations",
                "logo": [],
                "wordmark": [],
                "data": {
                    "addressStreet": "16C, Sector 6, HSR Layout",
                    "addressCountry": "India",
                    "addressCity": "Bengaluru",
                    "addressState": "Karnataka",
                    "addressPincode": "560083"
                },
                "channelId": 38,
                "companyId": 11,
                "isDeleted": false,
                "createdById": 87937,
                "updatedById": 87937,
                "createdAt": "2026-03-11T12:16:56+05:30",
                "updatedAt": "2026-03-11T13:29:06+05:30"
            },
            "primaryContactUser": {
                "phone": "+919880436756",
                "id": 28606,
                "isPhoneVerified": true,
                "isEmailVerified": false,
                "emailVerificationToken": null,
                "registerMethod": "PHONE",
                "name": "Amulya Srinivas",
                "email": "amulya.s+apptest@wardenera.com",
                "gender": "Female",
                "photos": [],
                "createdById": 10635,
                "createdAt": "2026-01-22T16:03:01+05:30",
                "updatedAt": "2026-01-22T16:03:01+05:30",
                "isTestAccount": false
            },
            "rateId": 191,
            "legalEntityId": 48,
            "company": {
                "id": 11,
                "onboardingStep": 1,
                "status": "Active",
                "name": "Lagom Innovations",
                "bedCapacity": "51-200",
                "createdById": 121,
                "updatedById": 2506,
                "createdAt": "2023-06-29T12:41:23.000Z",
                "updatedAt": "2026-04-13T09:55:49.000Z",
                "statusTransitions": [
                    {
                        "status": "New",
                        "datetime": "2023-07-04T06:50:30.000Z",
                        "message": "Created on Onboarding",
                        "addedById": 121,
                        "addedByName": "Sanket Kaushal"
                    },
                    {
                        "status": "Seeding",
                        "datetime": "2023-07-04T06:50:30.000Z",
                        "message": "Seeding initiated by the server",
                        "addedById": 1,
                        "addedByName": "Server"
                    },
                    {
                        "status": "Requested",
                        "datetime": "2023-07-04T06:51:24.000Z",
                        "message": "due to env.release being: Closed Beta",
                        "addedById": 1,
                        "addedByName": "Server"
                    },
                    {
                        "status": "Demo",
                        "datetime": "2023-07-04T06:55:51.000Z",
                        "message": "Company moved to Demo state",
                        "addedById": 3,
                        "addedByName": "Lakshay Raj"
                    }
                ],
                "settings": {
                    "selectedPaymentMethods": [
                        "UPI",
                        "NEFT",
                        "Cash",
                        "Online",
                        "Cheque",
                        "IMPS",
                        "Debit Card",
                        "Credit Card",
                        "Wallet",
                        "Net Banking",
                        "Bank Deposit",
                        "Transfer",
          
Modified at 2026-05-03 12:27:38
Previous
Get Company Details
Next
Get Bookings
Built with