Add Bookings

POST

/{{orgId}}/settings/api-config

Use this endpoint to push one or more bookings into the Zeal Reconfirmation Portal.

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200Accepted

application/json

Body

🟠403Invalid API Key

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST '/{{orgId}}/settings/api-config' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "bookings": [
    {
      "BookingCode": "BK-992834",
      "BookingStatus": "CONFIRMED",
      "BookingDate": "2026-01-20T10:30:00Z",
      "CheckIn": "2026-06-15T14:00:00Z",
      "CheckOut": "2026-06-20T11:00:00Z",
      "Source": "MobileApp",
      "ChannelId": "CH-77",
      "Price": 1250.50,
      "Refundable": true,
      "Priority": 1,
      "Rating": 5,
      "TimeZone": "GMT+4",
      "Agency": {
        "Name": "Global Travel Agency",
        "ReferenceNo": "REF-12345"
      },
      "Supplier": {
        "Name": "HotelDirect Pro",
        "ReferenceNo": "SUPP-882",
        "HCN": "HCN9901"
      },
      "Hotel": {
        "Name": "The Grand Oasis",
        "Country": "United Arab Emirates",
        "City": "Dubai",
        "Address": "123 Palm Jumeirah, Crescent Rd",
        "PostalCode": "00000",
        "Latitude": "25.1124",
        "Longitude": "55.1390",
        "ContactDetails": {
          "Phone": ["+97140000000"],
          "Email": ["reservations@grandoasis.com"]
        }
      },
      "Guest": {
        "LeadName": "John Doe",
        "Country": "USA",
        "City": "New York",
        "Nationality": "American",
        "TotalRooms": 1,
        "Adults": 2,
        "Childs": 1,
        "Infants": 0,
        "GuestNames": ["John Doe", "Jane Doe", "Jimmy Doe"],
        "RoomStructure": [
          {
            "RoomType": "Deluxe Sea View",
            "BoardType": "All Inclusive",
            "Adults": 2,
            "Childs": 1,
            "GuestNames": ["John Doe", "Jane Doe", "Jimmy Doe"]
          }
        ],
        "AllGuests": [
          {
            "Title": "Mr",
            "Name": "John",
            "LastName": "Doe",
            "Age": 35,
            "Type": "ADULT",
            "Gender": "Male",
            "Email": "john.doe@example.com",
            "Phones": "+15551234567"
          }
        ]
      },
      "Remarks": {
        "Internal": "High priority VIP guest",
        "Special": "Late check-in requested"
      }
    }
  ]
}'

Response Example

200 - Example

{
    "status": "ACCEPTED",
    "message": "Bookings have been successfully queued for processing.",
    "data": {
        "traceId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
        "bookingsCount": 5,
        "organizationId": "org-12345"
    },
    "meta": {
        "requestId": "req-abc123",
        "timestamp": "2026-01-21T14:30:00.000Z"
    }
}

Modified at 2026-01-21 09:45:26

Sync updates