--- updatedAt: 2026-04-30T10:24:55.000Z agentTools: projectIndex: https://booking-api-docs.guesty.com/llms.txt --- # Create inquiry for reservation based on quote Create a request for a reservation to be confirmed by the Guesty user based on a quote. Pre-SCA Stripe tokens (starting with `tok_...`) are NOT SUPPORTED. The API supports only Stripe SCA tokens (starting with `pm_...`). > ❗ Important > > Before using the Booking Engine (BE) API reservation endpoints, ensure your Guesty account is properly activated by following these steps: > 1. Activate Manual Source (skip this step if you already have direct reservations in Guesty account): > - Create a manual reservation directly in the Guesty UI. This step is required to activate the "Manual" booking source in your account. > 2. Activate BE API Source: > - Create your first reservation using the Booking Engine API endpoints. > - This step is essential to initialize the BE API source, which allows you to set up additional fees, taxes, auto payments and automated messages. # OpenAPI definition ```json { "openapi": "3.0.0", "paths": { "/api/reservations/quotes/{quoteId}/inquiry": { "post": { "operationId": "createInquiryReservationFromQuote", "summary": "Create inquiry for reservation based on quote", "description": "Create a request for a reservation to be confirmed by the Guesty user based on a quote. Pre-SCA Stripe tokens (starting with `tok_...`) are NOT SUPPORTED. The API supports only Stripe SCA tokens (starting with `pm_...`).\n> ❗ Important\n>\n> Before using the Booking Engine (BE) API reservation endpoints, ensure your Guesty account is properly activated by following these steps:\n> 1. Activate Manual Source (skip this step if you already have direct reservations in Guesty account):\n> - Create a manual reservation directly in the Guesty UI. This step is required to activate the \"Manual\" booking source in your account.\n> 2. Activate BE API Source:\n> - Create your first reservation using the Booking Engine API endpoints.\n> - This step is essential to initialize the BE API source, which allows you to set up additional fees, taxes, auto payments and automated messages.", "parameters": [ { "name": "quoteId", "required": true, "in": "path", "description": "ID of quote", "schema": { "example": "5d6e7a7ebf8e3800207735ae", "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ratePlanId": { "type": "string", "description": "Rate plan ID. Ensure you supply one of the rate plan IDs returned in the quote payload. Attempts to use any other string will result in an error.", "example": "5bf544a600a9b000389f81d8" }, "reservedUntil": { "type": "number", "enum": [ -1, 12, 24, 36, 48, 72 ], "description": "Time in hours to reserve the reservation for. Valid values: -1, 12, 24, 36, 48, 72", "example": 12, "default": -1 }, "ccToken": { "type": "string", "description": "payment token id, see tokenization guide https://booking-api-docs.guesty.com/docs/tokenizing-payment-methods", "example": "pm_1KTRn22eZvKYlo2CkHIARaGo" }, "guest": { "type": "object", "properties": { "firstName": { "type": "string", "description": "Name of the guest", "example": "Jhon" }, "lastName": { "type": "string", "description": "Surname of the guest", "example": "Dou" }, "email": { "type": "string", "description": "Email of the guest", "example": "jhon.dou@guesty.com" }, "phone": { "type": "string", "description": "Phone number of the guest", "example": "380111111111" }, "address": { "type": "object", "properties": { "street": { "type": "string", "example": "1000 5th Ave" }, "city": { "type": "string", "example": "New York" }, "country": { "type": "string", "example": "United State" }, "countryCode": { "type": "string", "example": "US" }, "zipCode": { "type": "string", "example": "10028" }, "state": { "type": "string", "example": "New York" } } } }, "required": [ "firstName", "lastName", "email" ] }, "policy": { "type": "object", "properties": { "privacy": { "type": "object", "properties": { "version": { "type": "number", "description": "Policy version number", "example": 1 }, "dateOfAcceptance": { "type": "string", "format": "date-time", "description": "Date of acceptance in ISO format" }, "isAccepted": { "type": "boolean" } } }, "termsAndConditions": { "type": "object", "properties": { "dateOfAcceptance": { "type": "string", "format": "date-time", "description": "Date of acceptance in ISO format" }, "isAccepted": { "type": "boolean" } } }, "marketing": { "type": "object", "properties": { "isAccepted": { "type": "boolean" } } } } } }, "required": [ "ratePlanId", "guest" ] } } } }, "responses": { "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "description": "ID of reservation", "example": "5d6e7a7ebf8e3800207735ae" }, "status": { "type": "string", "enum": [ "reserved" ] }, "platform": { "type": "string", "enum": [ "direct" ] }, "createdAt": { "type": "string", "example": "11/7/2021, 3:57:29 PM" }, "guestId": { "type": "string", "example": "5e384c9fc2700d002670b61b" } }, "required": [ "_id", "status", "platform", "createdAt", "guestId" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "data": { "type": "object", "properties": { "requestId": { "type": "string" }, "moreDetails": { "type": "object" } }, "required": [ "requestId" ] } }, "required": [ "code", "message", "data" ] } } } } } }, "401": { "description": "Not authorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "data": { "type": "object", "properties": { "requestId": { "type": "string" }, "moreDetails": { "type": "object" } }, "required": [ "requestId" ] } }, "required": [ "code", "message", "data" ] } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "data": { "type": "object", "properties": { "requestId": { "type": "string" }, "moreDetails": { "type": "object" } }, "required": [ "requestId" ] } }, "required": [ "code", "message", "data" ] } } } } } }, "404": { "description": "Quote not found" }, "429": { "description": "Too many requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "data": { "type": "object", "properties": { "requestId": { "type": "string" }, "moreDetails": { "type": "object" } }, "required": [ "requestId" ] } }, "required": [ "code", "message", "data" ] } } } } } } }, "security": [ { "bearerAuth": [] } ], "tags": [ "Reservation quote" ] } } }, "info": { "title": "Booking Engine API", "description": "Booking Engine API", "version": "1.0", "contact": {} }, "servers": [ { "url": "https://booking.guesty.com/" } ], "components": { "securitySchemes": { "bearerAuth": { "type": "apiKey", "in": "header", "name": "authorization" } } }, "security": [ { "bearerAuth": [] } ] } ```