Get Contract

This endpoint is used to get contract details of agoda channel.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/agoda/contract/retrive

Header

app-id: c2l0****20=
Authorization: Basic M0****W0

Header	Type	Required	Description
app-id	string	Yes	Your application ID. Required for authentication.
Authorization	string	Yes	Your API key. for authorization. Required for authentication.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

hotel_id alphanumeric (Required)

The unique property ID as assigned by the provider upon creation of the property.

---

channel_hotel_id string (Required)

The existing Agoda channel hotel ID for the property to be updated.

---

Sample Request

{
    "hotel_id": "AWSTEST",
    "channel_hotel_id": "77048595"
}

---

Response

Sample Success Response

{
    "Status": "Success",
    "Data": {
        "contract_code": "89",
        "content": "\n## AGODA GENERAL TERMS AND CONDITIONS \n\n*These updated General Terms and Conditions (version 7.0) effective from 21 February 2025.*\n\nBy using Agoda services to list and offer reservations, and ancillary services at your property, you have a binding legal agreement with Agoda. In addition, by using Agoda services you agree that all other prior agreements relating to the same services shall be overwritten by this agreement, save where you and Agoda have mutually agreed in writing otherwise provided that such mutual agreement does not contradict the terms of this agreement. In the event of a conflict between any prior agreements and this agreement, the terms of this agreement shall prevail. \n\nYour agreement for Agoda services includes these general terms and conditions, supplementary terms applicable to specific services, and applicable policies published on Agoda’s platform. This agreement governs your relationship with Agoda and your use of Agoda’s online accommodation listing and reservation facilitations services, ancillary services, and related systems, and software. Additional terms for certain services will supplement this agreement and will also apply to those services. If there is any conflict between this agreement and the additional terms that apply to certain services, the additional terms will prevail unless they expressly provide otherwise....."
    },
    "Message": "Contract retrieved successfully",
    "Ruid": "4ba57339-823f-11f0-9723-21938e81cb20"
}

Sample Error Response 1

{
    "Status": "Fail",
    "Errors": [
        {
            "Code": "573",
            "ShortText": "channel-mapping not found for this property!"
        }
    ],
    "Message": ""
}

Sample Error Response 2

{
    "Status": "Fail",
    "Errors": [],
    "Message": "Authorization Failed: User does not have rights for Hotel id: 4746650",
    "Ruid": "7b7d9647-945e-11f0-bd04-4b6b47f97c98"
}

---

Response Body Element

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

Will be always "Fail" in case of an error response.

---

Data object

The response data, the root element.

---

Message string

The message in the response.

---

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.