Booking List API

Bu metod, mevcut rezervasyonları konaklama tarihi, oluşturma tarihi, rezervasyon referansı veya misafir e-postası ile sorgulamak için kullanılır.

Booking list, aşağıda açıklanan request ve response şeklini kullanır. Tarih filtreleri rezervasyon ve konaklama tarihi alanlarına uygulanır. bookingReferenceID, rezervasyon için mevcut referanslarla eşleştirilir. emailId gönderilirse, uygun olduğunda dönen rezervasyon verisi üzerinde uygulanır. Sayfalama mevcut sonuç setine uygulanır; limit ve page, istenen sayfa boyutu ve sayfa numarasıdır.

Endpoint

POST https://mg.mescogo.com/gw/api/booking/book-list

Özellik	Değer
URI	BaseURL/api/booking/book-list
Method	POST
Content-Type	application/json

Request Parametreleri

Parametre	Tip	Açıklama
FromDate	string	Konaklama başlangıç tarihi filtresi. Format: YYYY-MM-DD. ToDate ile birlikte zorunludur.
ToDate	string	Konaklama bitiş tarihi filtresi. Format: YYYY-MM-DD. FromDate ile birlikte zorunludur.
CreatedFrom	string	Opsiyonel rezervasyon oluşturma başlangıç tarihi filtresi. Format: YYYY-MM-DD.
CreatedTo	string	Opsiyonel rezervasyon oluşturma bitiş tarihi filtresi. Format: YYYY-MM-DD.
bookingReferenceID	string	Opsiyonel rezervasyon referansı filtresi. Gösterilen property casing aynı kalmalıdır.
emailId	string	Opsiyonel misafir e-posta filtresi. Gösterilen property casing aynı kalmalıdır.
limit	integer	Sayfalama kullanılırken sayfa başına kayıt sayısı. Varsayılan: 10.
page	integer	Sayfalı rezervasyon listesinde sayfa numarası. Varsayılan: 1.

bookingReferenceID, rezervasyon tanımlayıcısı, onay numarası veya müşteri agency reference değeri olarak gönderilebilir.

Authorization

Bu endpoint, diğer booking endpoint'leri ile aynı API client credentials kullanılarak Basic Authorization header gerektirir.

Örnek Request

{
  "FromDate": "2026-06-01",
  "ToDate": "2026-06-30",
  "CreatedFrom": "",
  "CreatedTo": "",
  "bookingReferenceID": "",
  "emailId": "",
  "limit": 10,
  "page": 1
}

Başarılı Response

{
  "Status": {
    "Code": 200,
    "Description": ""
  },
  "BookingDetail": [
    {
      "Index": 1,
      "BookingId": "1531561",
      "ConfirmationNo": "1531561",
      "BookingDate": "18.05.2026",
      "Currency": "USD",
      "AgencyName": "",
      "BookingPrice": "250.5",
      "TripName": "",
      "HotelCode": "26090",
      "CheckInDate": "2026-06-01",
      "CheckOutDate": "2026-06-05",
      "ClientReferenceNumber": "REQ-10023"
    }
  ]
}

Response Parametreleri

Parametre	Tip	Açıklama
Status	object	Response status
Status.Code	integer	API durum kodu
Status.Description	string	Response açıklaması
BookingDetail	object list	Eşleşen rezervasyon satırları
BookingDetail[].Index	integer	Satır index'i
BookingDetail[].BookingId	string	Rezervasyon tanımlayıcısı
BookingDetail[].ConfirmationNo	string	Onay numarası
BookingDetail[].BookingDate	string	Rezervasyon işlem tarihi
BookingDetail[].Currency	string	Rezervasyon para birimi
BookingDetail[].AgencyName	string	Varsa acente adı
BookingDetail[].BookingPrice	string	Varsa rezervasyon tutarı
BookingDetail[].TripName	string	Varsa gezi adı
BookingDetail[].HotelCode	string	MescoMG otel kodu
BookingDetail[].CheckInDate	string	Konaklama başlangıç tarihi
BookingDetail[].CheckOutDate	string	Konaklama bitiş tarihi
BookingDetail[].ClientReferenceNumber	string	Varsa müşteri referansı

Hata Durumları

FromDate veya ToDate boş ya da YYYY-MM-DD formatında değilse API HTTP 200 ile aşağıdaki payload'u döner:

{
  "StatusCode": 500,
  "Message": "FromDate and ToDate Field Format should be YYYY-MM-DD",
  "Error": "Error"
}

List/search işleminin bir bölümü başarısız olursa response başarıyla işlenen satırları içerebilir.

Kullanılabilir response hazırlanmadan işlem başarısız olursa API HTTP 200 ile aşağıdaki payload'u döner:

{
  "StatusCode": 500,
  "Message": "An error occurred during processing",
  "Error": "An error occurred during processing"
}