Retrieve Cancellation Policy API

---

Endpoint

POST

https://connect.su-api.com/SUAPI/jservice/OTA_CancellationPolicy

---

Attributes

hotelid alphanumeric (Required)

Specifies the required node hotelid contains the IT provider's hotel id for which the provider wishes to add mapping information.

---

Sample Request

{
    "hotelid": "TestProp1"
}

---

Response

Success Response

{
    "success": true,
    "data": {
        "rate_info": [
            {
                "policy_id": 362,
                "policy_name": "Fully refundable Fixed",
                "policy_type": "Fully Refundable",
                "status": "1"
            },
            {
                "policy_id": 361,
                "policy_name": "Fully refundable",
                "policy_type": "Fully Refundable",
                "status": "1"
            },
            {
                "policy_id": 355,
                "policy_name": "new package validity policy",
                "policy_type": "Fully Refundable",
                "status": "1"
            },
            {
                "policy_id": 354,
                "policy_name": "Cancel Policy gzuncompress",
                "policy_type": "Partially Refundable",
                "status": "1"
            },
            {
                "policy_id": 351,
                "policy_name": "NEW POLICY 111 222",
                "policy_type": "Non Refundable",
                "status": "1"
            },
            {
                "policy_id": 350,
                "policy_name": "Flexible",
                "policy_type": "Fully Refundable",
                "status": "1"
            },
            {
                "policy_id": 349,
                "policy_name": "Non Refundable",
                "policy_type": "Non Refundable",
                "status": "1"
            },
            {
                "policy_id": 348,
                "policy_name": "Test Flexible 1",
                "policy_type": "Non Refundable",
                "status": "1"
            },
            {
                "policy_id": 347,
                "policy_name": "CP Resr",
                "policy_type": "Non Refundable",
                "status": "1"
            },
            {
                "policy_id": 346,
                "policy_name": "1111111",
                "policy_type": "Non Refundable",
                "status": "1"
            },
            {
                "policy_id": 344,
                "policy_name": "new test",
                "policy_type": "Non Refundable",
                "status": "1"
            },
            {
                "policy_id": 273,
                "policy_name": "AAAAd",
                "policy_type": "Fully Refundable",
                "status": "1"
            },
            {
                "policy_id": 269,
                "policy_name": "Partial Refundable 1",
                "policy_type": "Partially Refundable",
                "status": "1"
            }
        ],
        "currency_code": "INR"
    },
    "message": "cancellation policy data fetched succesfully"
}

400 - Error Response

---

Success Response - Body Elements

---

data object

Contains cancellation policy details for the property.

---

rate_info array

List of cancellation policies configured for the hotel.

---

Each object contains:

policy_id number

Unique identifier of the cancellation policy.

---

policy_name string

Name of the cancellation policy.

---

policy_type string

Type of cancellation policy.

Possible values:

• Fully Refundable

• Partially Refundable

• Non Refundable

---

status string

Indicates whether the policy is active.

Possible values:

• "1" → Active

• "0" → Inactive

---

currency_code string

ISO currency code applicable to the cancellation policies (for example, INR).

---

message string

Message describing the result of the request.

---

Errors Response - Body Elements

Status string

Indicates the result of the API call, which will be always "Failed" in case of an error response.

---

Errors array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

ShortText string

A short description of the error.