Size and Price Listing for Property

Size and Price Listing for Property API Endpoint
StoRegister - Login

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.

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.

GET
/v1/search/storage/{storageInfoId}/property/{propertyInfoId}/user-type/{taxUserTypeInfoId}/storageGroup/{storageGroupInfoId}/period/{paymentPeriod}/price/list
Request Content Type
application/json
Response Content Type
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 where true denotes success, and false 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 is null.
  • 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.