In this API, we expect some details from the client to be sent in request and based on that request we verify Travel Agent user and return verified Travel Agent information for properties in which it is created. The API can return data in JSON formats. The web service responds to HTTP GET requests.
You need to take eZee Reservation to use this API.
URI Request
Request parameters are supplied by appending a question mark (?) to the base URI, followed by a sequence of parameter names and values separated by an ampersand (&).
End Point URL
[BaseUrl]/booking/reservation_api/listing.php?APIKey=[APIKey]&request_type=[request_type]&username=[username]&password=[password]&groupcode=[groupcode]
Header
Parameter
| Name | Data Type | Description | Example |
| [BaseUrl] * | – | Live server URL | https://live.ipms247.com/ |
| [Request_Type] * | – | Use Keyword “VerifyUser” | |
| [Hotel_Code] * | INT(11) | Unique Hotel code | XXXX |
| [API_KEY] * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXX |
| [username] * | VARCHAR(300) | Pass travel agent user name | XXXXXXXXX |
| [password] * | VARCHAR(300) | Pass base_64 encoded encrypted password. Here’s the online tool for base_64 encoded encryption | base64_encode($x) |
| [groupcode] * | VARCHAR(300) | Unique group code for each registered chain of properties. | XXXXX |
Request
https://live.ipms247.com/booking/reservation_api/listing.php?APIKey=XX&request_type=VerifyUser&username=XX&password=XX&groupcode=XX
Response
| Name | Data Type | Description | Example |
| contactunkid | Integer(20) | Unique contact id | xxxxxxxxxxxx |
| salutation | String | Salutation of user | 301, 404 etc |
| business_name | String | Name of business | Reservation already processed |
| name | String | User name | Jhon |
| address | String | Address of user | 3817 Sugar Camp Road |
| city | String | City name | New York |
| state | String | State name | New York |
| zipcode | Integer | zipcode | 123456 |
| country | String | Country name | USA |
| phone | Integer | Phone number | 123456789 |
| mobile | Integer | Mobile number | 1234567890 |
| String | Email id | PamalaWHam@rhyta.com | |
| isusercreated | String | Is user created | 1 or 0 |
Success
"contact_detail":{
"26":{"contact_detail":{"contactunkid":"2600000000001612","salutation":"Mr.","business_name":"OLX","name":"Maximum","address":null,"city":null,"state":null,"zipcode":null,"country":"India","phone":null,"mobile":null,"email":"Maximum@gmail.com","isusercreated":"1"}},
"1023":{"contact_detail":{"contactunkid":"102300000000000844","salutation":"Mr.","business_name":"OLX","name":"Maximum","address":null,"city":null,"state":null,"zipcode":null,"country":"India","phone":null,"mobile":null,"email":"Maximum@gmail.com","isusercreated":"1"}},
"3419":{"contact_detail":{"contactunkid":"341900000000000098","salutation":"Mr.","business_name":"OLX","name":"Maximum","address":null,"city":null,"state":null,"zipcode":null,"country":"India","phone":null,"mobile":null,"email":"Maximum@gmail.com","isusercreated":"1"}}
Error Codes
| Error Code | Error Name |
| HotelCodeEmpty | Hotel code is empty. |
| NORESACC1 | This request is valid for Reservation Account only. You may not have opted for Reservation Account Or Groups Code and Authentication are invalid. |
| UNAUTHREQ | Unauthorized request. This request is not valid for this hotel code. |
| 2 | Cannot Parse Request |
| DBConnectError | Database not connected. |
| BadRequest | Bad request type. |
| -1 | No Data found. |
| APIACCESSDENIED | Your property doesn’t have access to API integration or Key is incorrect. Please contact support for this. |
| INVUSEPASS | Invalid Username and Password. |
| UnknownError | Unknown Error |
| InvalidHotelCode | Invalid Hotel code.Please check your property code. |