Size and Price Listing for Property
Size and Price Listing for Property API EndpointSize 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.
The Size and Price Listing endpoint retrieves a comprehensive list of sizes and their corresponding prices, categorized by storage type and category, for a specified property. The data includes details on rental prices, booking prices, total box count, and available box count. It facilitates informed decisions on whether to proceed with renting or booking storage boxes.
/v1/search/storage/{storageInfoId}/property/{propertyInfoId}/user-type/{taxUserTypeInfoId}/storageGroup/{storageGroupInfoId}/period/{paymentPeriod}/price/list
application/json
application/json
Request Header
-
Authorization: X-API-Key string required
X-API-Key is a string of letters and numbers used to authenticate and control access to the API. It can be generated in the StoRegister management application.
URL Query Parameters:
-
propertyInfoId unique-identifier required
propertyInfoId refers to the ID of the specific property. -
storageInfoId unique-identifier required
storageInfoId refers to type ID of storage (e.g., "Unit Storage", "Container Storage"). -
taxUserTypeInfoId unique-identifier required
taxUserTypeInfoId refers to type ID of the user (e.g., "General", "Business", "Student"). -
storageGroupInfoId int required
storageGroupInfoId refers to the grouping category ID for unit sizes (e.g., "Small", "Medium", "Large").. -
paymentPeriod string required
paymentPeriod refers to payment period KEY for the list of supported payment period (e.g., "Monthly", "Quartely").
Response Payload:
-
succeeded boolean
Indicates whether the request to retrieve tenant activity and quotes for storage boxes was successful. It is a boolean value wheretrue
denotes success, andfalse
indicates failure. -
status string
Describes the status of the request to retrieve tenant activity and quotes. It is a string providing additional information about the status. -
data object | null
Upon success, this property contains detailed information on tenant activity and quotes for requested storage boxes. The information includes 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. If the request is not successful, the value isnull
. -
errors array
Holds error information if applicable. It is an array containing error details in case there are issues with retrieving tenant activity and quotes.
object: data
-
property object
Details about the property (refer to Property Details section). -
storage object
Details about the storage (refer to Storage Details section). -
propertySizePriceData object
Details about the size and its associated price based on its storage category (refer to Storage Size and Price Details section).
Property Details
Details about the property, including property name, address, city, latitude, longitude, postal code, country, and contact number.
object: data.property
-
id unique-identifier
Unique identifier for the property. -
name string
Name of the property. -
address string
Street address of the property. -
city string
City where the property is located. -
latitude float
Latitude coordinate of the property location. -
longitude float
Longitude coordinate of the property location. -
postalCode string
Postal code of the property location. -
country object
Country where the property is located. -
countryISOCode2 string
ISO code (2 characters) for the country of the property. -
googlePlaceId string
Google Place ID associated with the property location. -
contactNumber string
Contact number for the property. -
propertyImageList null or array
List of property images or null if not available. -
propertyOfficeOpeningHoursInfoList null or array
List of information about property office opening hours or null if not available (refer to the Property Working Hours section for details).
Property Working Hours
Information about the working hours of the property, including opening and closing times for each day of the week.
array data.property.propertyOfficeOpeningHoursInfoList
-
dayOfWeek integer
Day of the week represented as an integer (0 for Sunday, 1 for Monday, ..., 6 for Saturday). The value -1 represents public holidays. -
week string
Name of the day of the week in French. -
firstTimeSlot string
Opening and closing time of the first time slot, if applicable. -
secondTimeSlot string
Opening and closing time of the second time slot, if applicable. -
isClosed boolean
Indicates whether the property is closed on the specified day.
Storage Details
Information about the storage, including storage box ID and name.
object: data.storage
-
id unique-identifier
Unique identifier for the storage box. -
name string
Name of the storage box.
Storage Size and Price Details
Information about 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.
object: data.propertySizePriceData
-
id string
Unique identifier for the property size and price data. -
name string
Name of the property. -
storageInfoId string
Unique identifier for the storage information associated with the property. -
storageInfoName string
Name of the storage box associated with the property. -
storageInfoDimensionType string
Dimension type of the storage box. -
sizes array
List of storage sizes and details (refer to Storage Size Details section).
object: storageSizeGroupInfo
-
storageSizeGroupInfoId number
Identifier for the storage size group. -
storageSizeGroupInfoName string
Name of the storage size group. -
width number
Width of the storage size. -
length number
Length of the storage size. -
height number
Height of the storage size. -
surface number
Surface area of the storage size. -
scaleMetrics string
Metrics used for scale (e.g., 'm' for meters). -
sizeMetrics string
Metrics used for size (e.g., 'AREA'). -
availableCount number
Count of available storage sizes. -
storageSpaceSizeInfoId string
Identifier for the storage space size information. -
storageSizeImageAssetInfoId string
Identifier for the storage size image asset. -
storageSizeImageInfoPath string
Path to the storage size image.
Storage Size Details
-
storageSizeGroupInfoId int
Identifier for the storage size group. -
storageCategory array
List of storage categories and details (refer to Storage Category Details section).
Storage Category Details
-
id string
Identifier for the storage category. -
price array
List of prices for the storage category (refer to Price Details section).
Booking and Rental Price Details
object: bookingPrice and rentalPrice
-
discountInfoId string
Identifier for the discount information. -
discountPropertyInfoId string
Identifier for the associated property information. -
discountDescription null|string
Description of the discount (null if not available). -
taxablePrice object
Taxable price details (refer to Taxable Price Details section). -
tax object
Tax details (refer to Tax Details section). -
taxAmount object
Tax amount details (refer to Tax Amount Details section). -
netAmount object
Net amount details (refer to Net Amount Details section). -
discountAmount object
Discount amount details (refer to Discount Amount Details section). -
payableAmount object
Payable amount details (refer to Payable Amount Details section).
Price Details
Information about 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.
object: taxablePrice , taxAmount , netAmount , discountAmount and payableAmount
-
rentalPrice object
Rental price details (refer to Rental Price Details section). -
bookingPrice object
Booking price details (refer to Booking Price Details section).
Tax Details
-
name string
Name of the tax. -
taxPercentage number
Tax percentage. -
taxPercentageFormatted string
Formatted tax percentage.
Request Header
Authorization: X-API-Key --api-key--
API Response
{
"data":{
"property":{
"id":"a99c4590-9475-404e-bcbd-6cba2e2b5e16",
"name":"Chalets",
"address":"1234 rue des Chalets",
"city":"Toulouse",
"latitude":0.00,
"longitude":0.00,
"postalCode":"31000",
"country":{
"id":82,
"name":"France"
},
"region": {
"id": 216,
"name": "Occitania"
},
"countryISOCode2":"FR",
"googlePlaceId":"--place-id",
"contactNumber":"+33 0522243838",
"propertyImageList":[
"property.jpg"
],
"propertyOfficeOpeningHoursInfoList":[
{
"dayOfWeek": 0,
"week": "dimanche",
"firstTimeSlot": null,
"secondTimeSlot": null,
"isClosed": true
},
{
"dayOfWeek": 1,
"week": "lundi",
"firstTimeSlot": "09:00 To 12:30",
"secondTimeSlot": "13:30 To 19:00",
"isClosed": false
},
{
"dayOfWeek": 2,
"week": "mardi",
"firstTimeSlot": "09:00 To 12:30",
"secondTimeSlot": "13:30 To 19:00",
"isClosed": false
},
{
"dayOfWeek": 3,
"week": "mercredi",
"firstTimeSlot": "09:00 To 12:30",
"secondTimeSlot": "13:30 To 19:00",
"isClosed": false
},
{
"dayOfWeek": 4,
"week": "jeudi",
"firstTimeSlot": "09:00 To 12:30",
"secondTimeSlot": "13:30 To 19:00",
"isClosed": false
},
{
"dayOfWeek": 5,
"week": "vendredi",
"firstTimeSlot": "09:00 To 12:30",
"secondTimeSlot": "13:30 To 19:00",
"isClosed": false
},
{
"dayOfWeek": 6,
"week": "samedi",
"firstTimeSlot": "09:00 To 12:30",
"secondTimeSlot": "13:30 To 19:00",
"isClosed": false
},
{
"dayOfWeek": -1,
"week": null,
"firstTimeSlot": null,
"secondTimeSlot": null,
"isClosed": true
}
]
},
"storage":{
"id":"47fa29c4-738a-42dc-bcb3-6dba1ee7e38e",
"name":"Box"
},
"propertySizePriceData":[
{
"id":"a99c4590-9475-404e-bcbd-6cba2e2b5e16",
"name":"Chalets",
"city":null,
"country":null,
"countryInfoISOCode2":null,
"zipCode":null,
"addressLine1":null,
"addressInfoLatitude":0,
"addressInfoLongitude":0,
"strorageInfoId":"47fa29c4-738a-42dc-bcb3-6dba1ee7e38e",
"storageInfoName":"Box",
"storageInfoDimensionType":"BOX",
"sizes":[
{
"storageSizeGroupInfoId":2,
"storageSizeGroupInfoName":"Small",
"width":2,
"length":2,
"height":2,
"surface":4,
"scaleMetrics":"m",
"sizeMetrics":"AREA",
"availableCount":20,
"storageSpaceSizeInfoId":"e9c7f096-e719-4c03-8d03-239de36a772f",
"storageSizeImageAssetInfoId":"badc5485-efce-438b-a0a0-9676689a3655",
"storageSizeImageInfoPath":"./storagebox-4m.jpg",
"storageCategory":[
{
"id":"fb1660c7-4d43-4637-aad8-5e547e6455ef",
"name":"Box",
"price":[
{
"rentalPrice":{
"discountInfoId":null,
"discountPropertyInfoId":null,
"discountDescription":null,
"taxablePrice":{
"price":25,
"formattedPrice":"25,00 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":5,
"formattedPrice":"5,00 €"
},
"netAmount":{
"price":30,
"formattedPrice":"30,00 €"
},
"discountAmount":null,
"payableAmount":{
"price":30,
"formattedPrice":"30,00 €"
}
},
"bookingPrice":{
"discountInfoId":null,
"discountPropertyInfoId":null,
"discountDescription":null,
"taxablePrice":{
"price":27.083,
"formattedPrice":"27,08 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":5.42,
"formattedPrice":"5,42 €"
},
"netAmount":{
"price":32.5,
"formattedPrice":"32,50 €"
},
"discountAmount":null,
"payableAmount":{
"price":32.5,
"formattedPrice":"32,50 €"
}
},
"availableSpaceForRent":3,
"availableSpaceForBook":10
},
{
"rentalPrice":{
"discountInfoId":"c453ea01-2e9e-4636-977f-c64555f86f20",
"discountPropertyInfoId":"6ae2c911-55a0-41fd-875c-529d846c25e0",
"discountDescription":null,
"taxablePrice":{
"price":25,
"formattedPrice":"25,00 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":5,
"formattedPrice":"5,00 €"
},
"netAmount":{
"price":30,
"formattedPrice":"30,00 €"
},
"discountAmount":{
"price":3,
"formattedPrice":"3,00 €"
},
"payableAmount":{
"price":27,
"formattedPrice":"27,00 €"
}
},
"bookingPrice":{
"discountInfoId":null,
"discountPropertyInfoId":null,
"discountDescription":null,
"taxablePrice":{
"price":27.083,
"formattedPrice":"27,08 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":5.42,
"formattedPrice":"5,42 €"
},
"netAmount":{
"price":32.5,
"formattedPrice":"32,50 €"
},
"discountAmount":null,
"payableAmount":{
"price":32.5,
"formattedPrice":"32,50 €"
}
},
"availableSpaceForRent":0,
"availableSpaceForBook":1
}
]
}
]
},
{
"storageSizeGroupInfoId":2,
"storageSizeGroupInfoName":"Small",
"width":2,
"length":4,
"height":4,
"surface":8,
"scaleMetrics":"m",
"sizeMetrics":"AREA",
"availableCount":20,
"storageSpaceSizeInfoId":"f491d3e3-b615-41af-b50b-b1735bed682f",
"storageSizeImageAssetInfoId":"1bc8c06e-7f61-42eb-a842-41cb2336da48",
"storageSizeImageInfoPath":"./storagebox-8m.jpg",
"storageCategory":[
{
"id":"fb1660c7-4d43-4637-aad8-5e547e6455ef",
"name":"Box",
"price":[
{
"rentalPrice":{
"discountInfoId":null,
"discountPropertyInfoId":null,
"discountDescription":null,
"taxablePrice":{
"price":75,
"formattedPrice":"75,00 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":15,
"formattedPrice":"15,00 €"
},
"netAmount":{
"price":90,
"formattedPrice":"90,00 €"
},
"discountAmount":null,
"payableAmount":null
},
"bookingPrice":{
"discountInfoId":null,
"discountPropertyInfoId":null,
"discountDescription":null,
"taxablePrice":{
"price":81.25,
"formattedPrice":"81,25 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":16.25,
"formattedPrice":"16,25 €"
},
"netAmount":{
"price":97.5,
"formattedPrice":"97,50 €"
},
"discountAmount":null,
"payableAmount":{
"price":97.5,
"formattedPrice":"97,50 €"
}
},
"availableSpaceForRent":8,
"availableSpaceForBook":10
},
{
"rentalPrice":{
"discountInfoId":null,
"discountPropertyInfoId":null,
"discountDescription":null,
"taxablePrice":{
"price":79.167,
"formattedPrice":"79,17 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":15.83,
"formattedPrice":"15,83 €"
},
"netAmount":{
"price":95,
"formattedPrice":"95,00 €"
},
"discountAmount":null,
"payableAmount":{
"price":95,
"formattedPrice":"95,00 €"
}
},
"bookingPrice":{
"discountInfoId":null,
"discountPropertyInfoId":null,
"discountDescription":null,
"taxablePrice":{
"price":87.5,
"formattedPrice":"87,50 €"
},
"tax":{
"name":"VAT",
"taxPercentage":20,
"taxPercentageFormatted":"20,00 %"
},
"taxAmount":{
"price":17.5,
"formattedPrice":"17,50 €"
},
"netAmount":{
"price":105,
"formattedPrice":"105,00 €"
},
"discountAmount":null,
"payableAmount":{
"price":105,
"formattedPrice":"105,00 €"
}
},
"availableSpaceForRent":4,
"availableSpaceForBook":10
}
]
}
]
}
],
"googlePlaceId":null,
"contactNumberDialingCode":0,
"contactNumber":null
}
]
},
"succeeded":true,
"status":"SUCCESS",
"errors":null
}
Error Codes
-
INVALID_PARAM_PROPERTY_INFO_ID
INVALID_PARAM_PROPERTY_INFO_ID refers to invalid property ID. -
INVALID_PARAM_STORAGE_INFO_ID
INVALID_PARAM_STORAGE_INFO_ID refers to invalid storage ID. -
INVALID_PARAM_TAX_USER_TYPE_ID
INVALID_PARAM_TAX_USER_TYPE_ID refers to invalid user type. -
UNABLE_TO_RETREIVE_STORAGE_SIZE_PRICE_INFO_DETAILS
UNABLE_TO_RETREIVE_STORAGE_SIZE_PRICE_INFO_DETAILS means unable to retreive size price details. -
NO_RECORDS_FOUND
NO_RECORDS_FOUND means there is no relevant information found. -
FAILED
FAILED refers to an unsuccessful API call. -
SOMETHING_WENT_WRONG
SOMETHING_WENT_WRONG refers to technical glitch. Please contact administrator.