Download OpenAPI specification:Download
Serverless booking platform API documentation
Sends an OTP code to the user's phone number for password reset. No authentication required.
| phoneNumber required | string Phone number (without country code) |
{- "phoneNumber": "555123456"
}Verifies OTP and resets the user's password. No authentication required.
| phoneNumber required | string Phone number (without country code) |
| otpCode required | string 4-digit OTP code |
| newPassword required | string New password (min 8 chars, must contain letter and number) |
{- "phoneNumber": "555123456",
- "otpCode": "4444",
- "newPassword": "newPassword123"
}Verifies the user's phone number using the OTP code sent via SMS
| phone required | string Phone number (without country code) |
| otpCode required | string 4-digit OTP code |
{- "phone": "555123456",
- "otpCode": "4444"
}Updates the user's phone number and sends a new OTP for verification
| phoneNumber required | string New phone number (without country code) |
| countryCode required | string Country code with + |
{- "phoneNumber": "555987654",
- "countryCode": "+995"
}Changes the user's password. Requires current password verification.
| currentPassword required | string Current password |
| newPassword required | string New password (min 8 chars, must contain letter and number) |
{- "currentPassword": "oldPassword123",
- "newPassword": "newPassword123"
}Creates a temporary booking lock to prevent double bookings. Automatically deleted after 10 minutes.
| propertyId required | string Property ID |
| rentalType required | string Enum: "DAILY" "HOURLY" |
| checkIn required | string For DAILY - date only (2025-06-01), For HOURLY - full datetime (2025-06-01T14:00:00Z) |
| checkOut required | string For DAILY - date only (2025-06-03), For HOURLY - full datetime (2025-06-01T17:00:00Z) |
| guests required | number |
{- "rentalType": "DAILY",
- "checkIn": "2025-06-01",
- "checkOut": "2025-06-03",
- "guests": 2
}Sends an OTP code to the guest's phone number. No authentication required.
| id required | string Booking ID |
| phoneNumber required | string Guest phone number |
{- "phoneNumber": "555123456"
}Verifies OTP, creates client record, and changes booking status to PENDING. No authentication required.
| id required | string Booking ID |
| phoneNumber required | string Guest phone number |
| otpCode required | string 4-digit OTP code |
| firstName required | string Guest first name |
| lastName required | string Guest last name |
{- "phoneNumber": "555123456",
- "otpCode": "4444",
- "firstName": "John",
- "lastName": "Doe"
}Declines a booking with PENDING status. Requires authentication. Host must own the property.
| id required | string Booking ID |
| reason | string Optional reason for declining |
{- "reason": "Property is not available for this date"
}Changes booking dates. Uses same validation as block endpoint. Requires authentication. Host must own the property.
| id required | string Booking ID |
| rentalType required | string Enum: "DAILY" "HOURLY" |
| checkIn required | string New check-in date/datetime |
| checkOut required | string New check-out date/datetime |
| guests | number Updated guest count (optional) |
{- "rentalType": "DAILY",
- "checkIn": "2025-06-05",
- "checkOut": "2025-06-08",
- "guests": 3
}Extends booking end date/time. Requires authentication. Host must own the property.
| id required | string Booking ID |
| newCheckOut | string New check-out date/datetime |
| additionalHours | number Additional hours to extend (for hourly rentals) |
{- "newCheckOut": "2025-06-10",
- "additionalHours": 2
}Cancels a confirmed booking. Requires authentication. Host must own the property.
| id required | string Booking ID |
| reason | string Optional cancellation reason |
{- "reason": "Property maintenance required"
}Refunds a booking (automatic payment only). Requires authentication. Host must own the property.
| id required | string Booking ID |
| amount | number Partial refund amount (optional, full refund if not specified) |
{- "amount": 50
}