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

Credential Refresh

GET
/api/v1/external-app/credential-refresh
Last modified:2026-05-04 13:20:04
Warden uses an OAuth 2.0 strategy to secure all API access.
Use your provided Warden-Id and Warden-Secret as request headers to call this endpoint. These credentials are sensitive and should be kept secret — they are exclusively used to obtain an Access Token and should never be exposed publicly or used in any other API call.
A successful call returns an accessToken which is valid for 15 minutes. Include this token as a Bearer Token in the Authorization header for all subsequent API requests.
Once the token expires, simply call this endpoint again to generate a new one.

Headers Required#

HeaderDescription
Warden-IdYour unique Warden identifier
Warden-SecretYour secret key

Request

Header Params

Responses

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://server.wardenera.com/api/v1/external-app/credential-refresh' \
--header 'User-Agent: insomnia/11.4.0' \
--header 'Warden-Id: seOMa8jaGonyxSfH' \
--header 'Warden-Secret: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwZXJtaXNzaW9uSWQiOjk4MTM3LCJ1c2VySWQiOjMxOTY5LCJpc3N1ZWRBdCI6Njk4LCJpYXQiOjE3NzgyNTA2MTksImV4cCI6MzMzMzU4NTA2MTl9._adR571p02F-8WzenfuM237mInMlMQDs24LVo2N9rRo'
Response Response Example
{
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOjMxOTY5LCJwZXJtaXNzaW9uSWQiOjk4MTM3LCJhY2Nlc3NJZCI6MzAxOTcyLCJpc3N1ZWRBdCI6MTc3ODI1MDY0OCwiaWF0IjoxNzc4MjUwNjQ4LCJleHAiOjE3NzgzMzcwNDh9.GXak0DYynmIluRMZA-sOVFE1NrrGAPj-pZBckQoCu0c",
    "message": "Access Token successfully generated"
}
Modified at 2026-05-04 13:20:04
Previous
Auth
Next
Booking Engine
Built with