Booking API - Developer Guide

StoRegister API Documentation
StoRegister - Contact Book

Booking API

Booking API includes endpoints related to bookings, providing details on property, storage sizes, associated pricing, saving booking activities, reservations, retrieving insurance information, and fetching details about reservations and booking activities.

Retrieve List of Properties

The List of Property endpoint allows users to retrieve a list of properties available in the system. This information includes details such as property ID, name, address, geographical coordinates, contact information, and images. The API response also provides pagination information for large result sets.

Explore endpoints

Retrieve Property by ID

The List of Property endpoint allows users to retrieve property details by ID through a GET request. It returns a single result, i.e., a property object, only if the provided ID matches an existing property; otherwise, it returns null. The information includes details such as property ID, name, address, geographical coordinates, contact information, and images.

Explore endpoints

Size and Price Listing for Property

The Size and Price Listing for a Property Retrieval API endpoint furnishes detailed information on the sizes available, their respective pricing, and various variants for a specific property. This information, categorized by storage type and category, aids in decision-making for renting or booking storage boxes based on factors such as discounts, availability, and distinct pricing for the same size.

Explore endpoints

Pre-Booking Quote Retrieval

The Pre-Booking Quote Retrieval API endpoint offers comprehensive information on quotes for requested storage boxes. The quote comes in two variations: for the prorated period from the move-in date to the last invoice cycle and for a complete invoice cycle. The primary details include property details and storage box specifics, providing a quick overview for decision-making when booking.

Explore endpoints

Save Booking Activity

The Save Booking Activity endpoint allows the creation of a booking activity to facilitate the move-in process. This activity serves as an intermediary step to store tenant information, and subsequent additions such as insurance, services, merchandise, and discounts can be associated with this primary key. The booking activity acts as a central identifier in managing leads through the pipeline to finalize deals.

Explore endpoints

Booking Activity and Quote Retrieval

The Booking Activity and Quote Retrieval API endpoint provides detailed information on tenant activity and quotes for requested storage boxes, including selected add-ons such as insurance, service, merchandise items, and applicable discounts. The quote is available in two variations: for the prorated period from the move-in date to the last invoice cycle and for a complete invoice cycle. The primary details encompass tenant information, property details, and storage box specifics, providing a quick overview for booking inquiries.

Explore endpoints

Save Reservation and Booking Activity

The Save Reservation and Booking Activity endpoint allows the creation of a booking activity to facilitate the move-in process and reserve the storage box. This activity serves as an intermediary step to store tenant information along with the reservation. Subsequent additions such as insurance, services, merchandise, and discounts can be associated with this primary key. The booking activity acts as a central identifier in managing leads through the pipeline to finalize deals, while the reservation ensures the storage box is reserved for the tenant.

Explore endpoints

Get Reservation Details by ID

The Get Reservation Details by ID endpoint provides comprehensive information about a specific reservation and its associated booking activity. This includes primary details about tenant activity, quotes for requested storage boxes, and details on selected add-ons such as insurance, service, merchandise items, and applicable discounts. The quote is available in two variations: for the prorated period from the move-in date to the last invoice cycle and for a complete invoice cycle. The primary details encompass tenant information, property details, and storage box specifics, offering a quick overview for booking inquiries.

Explore endpoints

List of Insurance Plan with Coverage By Booking ID

The Insurance List endpoint provides a list of insurance options tailored to specific booking activities, considering the size of the storage box, whether in terms of area or volume. The list is fetched based on the associated booking ID.

Explore endpoints

List of Insurance Plans with Coverage By Property and Storge type ID

The Insurance List endpoint provides a list of insurance options tailored to specific sizes respective to the property and Storge type ID, considering the size of the storage box, whether in terms of area or volume. The list is fetched based on the associated property and Storge type ID. If you pass zero to areaOrVolume, it will return all the insurance options on the associated property and Storge type ID irrespective of the size filter.

Explore endpoints

Link Insurance Plan and Coverage to Booking Activity

This endpoint links the proposed insurance coverage to an existing booking activity. If any insurance is already linked, it will be switched to the newly proposed insurance coverage.

Explore endpoints

Identity Document List By Booking ID

The Identity Document Type List endpoint provides a list of Identity Document options tailored to specific booking activities, considering the size of the storage box, whether in terms of area or volume. The list is fetched based on the associated booking ID.

Explore endpoints

Save Booking Identity Document

The Save Booking Identity Document API provides a secure endpoint to store the client's identity document on the server associated with the booking ID within the booking flow. Using a POST request, clients can submit identity documents as part of the booking process for future reference. The API supports multipart/form-data with a defined boundary.

Explore endpoints

Generate Pre-filled Contract Document by Booking ID

This endpoint generates a pre-filled contract document based on the provided booking activity ID. The generated document includes comprehensive information such as client details, property information, storage box details, payment terms, and other relevant information. The PDF document is created for viewing purposes and can be accessed through the provided URLs.

Explore endpoints

Store Client Signature for Future Move-In

This endpoint enables the storage of the client's signature in temporary memory for subsequent move-in processing. It proves particularly useful after the successful completion of the payment process. It's essential to note that the client signature will be permanently deleted upon the successful move-in or within one day, as part of compliance with data protection regulations. This practice ensures that no personal information is retained on the server for an extended period.

Explore endpoints

Booking Document Download

The Booking Document Download API enables clients to retrieve specific documents related to a booking by specifying a unique identifier known as the asset ID during the booking flow. This endpoint facilitates the download of various files, including tenant identity documents or prefilled contract documents without a client signature, solely for preview purposes.

Explore endpoints

Card Payment Intent Request Generation by Booking ID

This endpoint generates a payment intent request for card payments and facilitates seamless integration with various payment gateways based on the booking ID. It returns the payment intent along with UI-related keys for loading the respective payment gateway (e.g., Stripe, Lyra, Brain Tree). The response includes comprehensive details for setting up the payment gateway form, incorporating necessary UI integration elements. These details encompass client information, business specifics of the storage center, and property information where the client intends to rent. In the case of multiple payment gateway options configured for the specific property, the endpoint returns the one associated with the property's default payment gateway. The property data.paymentGateway will return the key of the payment gateway, and based on this key, information will exist in the response payload.

Explore endpoints

Stripe Payment Confirmation for Rental Move-in

This endpoint validates a successful payment intent ID from the Stripe payment gateway and initiates the creation of a rental contract, invoice, receipt voucher, and charges entry for the specified booking ID. The resulting contract will include signed documents, addons, and any applicable discounts saved during the move-in flow. The API returns the rental contract ID upon successful completion of the move-in process.

Explore endpoints

Lyra Payment Confirmation for Rental Move-in

This endpoint validates a successful POST request with content type 'application/x-www-form-urlencoded' received from the Lyra payment gateway after a successful payment redirection. It expects the same POST data (formData["kr-answer"]) and initiates the creation of a rental contract, invoice, receipt voucher, and charges entry for the specified booking ID. The resulting contract includes signed documents, addons, and any applicable discounts saved during the move-in flow. The API returns the rental contract ID upon successful completion of the move-in process.

Explore endpoints

BrainTree Payment Confirmation for Rental Move-in

This endpoint receives the nonce from the BrainTree UI after a successful card save process. The API processes the nonce and charges the card for the respective move-in proforma invoice (i.e., quote shared during the move-in process). If the payment using the nonce is successful, it initiates the creation of a rental contract, invoice, receipt voucher, and charges entry for the specified booking ID. The resulting contract includes signed documents, addons, and any applicable discounts saved during the move-in flow. The API returns the rental contract ID upon successful completion of the move-in process.

Explore endpoints