In this API Documentation, you will find detailed information on how to use the Travconn API, including which request methods (GET, POST, etc.) to use, required parameters, and response formats.
Before getting started, make sure you have the correct endpoint URL, a valid username, password, and API key.
POST Get Token
This is the basic JWT token authorization and requires Email-Password combination in the request body and an ApiKey Header. This request returns an access_token which is valid for seven (7) hours.
HEADERS
| ApiKey | your_key |
BODY Raw(json)
{
"Email":"your_email@sample.com",
"Password":"your_password"
}POST Price Search
This request needs a Bearer Token at Authorization header which was provided by Get Token request. To receive faster responses, it is recommended to perform queries on a hotel basis.
MANDATORY FIELDS
- BeginDate = The check-in date of the reservation must be entered.
- EndDate =The check-out date of the reservation must be entered.
- Pax = Number of Pax (Adults)
- Hotel = It is possible to search for one or more hotels by specifying their Hotel IDs. perform a region-based search, leave the Hotel ID field empty. This will allow you to search based on the specified region.
AUTHORIZATION Bearer Token
| Token | <token> |
Request Example (json)
{
"OperatorId": 0,
"BeginDate": "2024-07-02",
"EndDate": "2024-07-03",
"Pax": 2,
"Childs": 0,
"ChildInfo": [],
"RemainderQuotaCheck": true,
"SaleDate": "2024-06-04",
"IsAvailable": true,
"WithoutInformation": true,
"Hotellist":[3005],
"RoomTypeId": 0,
"MainregionId":0,
"SubregionId":0,
"RegionId":0,
"BoardCode":"",
"WithoutStop":false
}POST Insert Reservation
This request needs a Bearer Token at Authorization header which was provided by Get Token request.
AUTHORIZATION Bearer Token
| Token | <token> |
PARAMS
| Voucher No | {your voucher number} |
| Quota Alert | false |
| Voucher Control | false |
Request Example (json)
[
{
"AdditionalServices": [],
"CheckinDate": "2024-07-01",
"CheckOutDate": "2024-07-08",
"HotelId": 234,
"OperatorId": 0,
"Adult": 2,
"Child": 0,
"BoardId": 1,
"ContractId": 102311,
"RoomTypeId": 987,
"GroupId": 0,
"GroupName": "",
"Customers": [
{
"Title": "Mr",
"FirstName": "Test",
"LastName": "Test",
"BirthDate": "2000-06-10",
"PassNo": "",
"PassSerial": "",
"PhoneNumber": "",
"Address": "",
"RecId": 0,
"Age": 24,
"SourceId": "3",
"IsArrivalTransfer": 0,
"IsDepartureTransfer": 0
},
{
"Title": "Mrs",
"FirstName": "Test2",
"LastName": "Test2",
"BirthDate": "2000-06-10",
"PassNo": "",
"PassSerial": "",
"PhoneNumber": "",
"Address": "",
"RecId": 0,
"Age": 24,
"SourceId": "4",
"IsArrivalTransfer": 0,
"IsDepartureTransfer": 0
}
],
"Remark": "sample string 11",
"Description": "sample string 12",
"B2bUserName": "",
"B2bPrice": 0,
"WithTransfer": false,
"ArrTransfer": false,
"DepTransfer": false,
"ArrTransferType":0,
"DepTransferType": 0,
"AirPortId": 0,
"TransferPrice":0,
"TransferCurrency": "",
"CurrencyRemark": "",
"RoomType": 23,
"RecId": "fbcb6c16-e972-4291-84a3-636e2e61ee10",
"ArrivalFlightId": 0,
"DepartureFlightId": 0,
"FlightPrice": 0,
"ArrivalFlightPrice": 0,
"DepartureFlightPrice": 0,
"Number": 30,
"ReservationId": 0,
"HotelRemark": "",
"TransferRemark": "",
"ReservationDetailId": 0,
"Amount": 1918.0,
"DailyDetail": [],
"HotelRoomCode": "",
"SourceId": "6",
"ImportType": 0,
"TransId": "",
"OrderId": "",
"SaleDate": "2024-06-10",
"Code3": "",
"Code2": "1",
"Code1": "2",
"SourceOrderId": "5",
"BuySaleDate": "2024-06-10",
"ReservationRemark": "sample string 45",
"IsReservationChanged": false,
"IsBabyFree": false,
"CheckContract": true,
"AdditionalServiceRemark": "",
"PasifReservationId": 0,
"PasifHotelId": 0,
"B2BTourPacketId": 0,
"B2BTourPacketPrice": 0
}
]The IsArrival and IsDeparture parameters in the Customer section indicate whether the passenger has a transfer or not. A value of 0 means no transfer, while a value of 1 means the passenger has a transfer.
POST Get Reservations
This request needs a Bearer Token at Authorization header which was provided by Get Token request.
AUTHORIZATION Bearer Token
| Token | <token> |
Request Example (json)
{
"RecId": 1,
"VoucherNo": "",
"SourceId": "",
"ConfirmStatus": 0,
"HotelId": 0,
"OrderId": ""
}Confirm Status
| Value | Explanation |
|---|---|
| 1 | Confirm |
| 2 | Not Confirm |
| 3 | Pending (The reservation has been recorded, but no action has been taken regarding the confirmation yet.) |
| 4 | Send (The hotel has been notified for reservation confirmation, and a response is awaited.) |
POST Get Region List
This request needs a Bearer Token at Authorization header which was provided by Get Token request.
StartFragmenAllows for a search based on the region (e.g., Antalya, Alanya, Kemer).
AUTHORIZATION Bearer Token
| Token | <token> |
Request Example (json)
curl --location 'http://domain.com/integration/Lists/GetRegionList'GET Get SubRegion List
This request needs a Bearer Token at Authorization header which was provided by Get Token request.
StartFragmeAllows for a search based on the subregion within a larger region (e.g., Beldibi, Göynük, Tekirova within the Kemer region)
AUTHORIZATION Bearer Token
| Token | <token> |
Request Example (json)
curl --location 'http://domain.com/integration/Lists/GetSubRegionList'GET Get Hotel List
This request needs a Bearer Token at Authorization header which was provided by Get Token request.
AUTHORIZATION Bearer Token
| Token | <token> |
PARAMS
| IsActive | true |
Request Example (json)
curl --location 'http://domain.com/integration/Lists/GetHotelList?IsActive=true'GET Get RoomType List
This request needs a Bearer Token at Authorization header which was provided by Get Token request.
AUTHORIZATION Bearer Token
| Token | <token> |
PARAMS
| HotelId | HotelId |
Request Example (json)
curl --location 'http://domain.com/integration/Lists/GetRoomTypeList?HotelId=3005'GET Get BoardList
This request needs a Bearer Token at Authorization header which was provided by Get Token request.
AUTHORIZATION Bearer Token
| Token | <token> |
Request Example (json)
curl --location 'http://domain.com/integration/Lists/GetBoardList'POST Cancel Request
Booking cancellation requests can be sent using this method.
AUTHORIZATION Bearer Token
| Token | <token> |
Request Example (json)
{
"Voucher":"VoucherNr123",
"HotelName":"Hotel Name ",
"CheckinDate":"2024-07-09",
"CheckoutDate":"2024-07-16",
"Customers":["Name1 Surname1 ","Name2 Surname2"]
}
Responce Example
Cancel request has been received. Please follow up the cancel confirmationBack to main page www.travconn.com