Short-term lets: data collection specification
Data collection specification and example XML schema for the collection of licencing data for short-term lets.
Description of premises
This section gives the details for the fields related to the description of premisesand describes each of the variables to be exported, their names, the acceptable responses, the values to be returned for those responses, and the automatic validation checks which will be performed by the ProcXed system when they are uploaded.
Type of premises
XML Tag:
PremisesType
Description:
Type of building, construction or otherwise that the short term let relates to.
Format
List (two digits codes with leading zeros)
Validation
Mandatory (Optional if application is invalid)
|
Type of dwelling |
Code |
Description |
|
Detached house |
01 |
Detached house |
|
Semi-detached house |
02 |
Semi-detached house |
|
Terraced house |
03 |
Terraced House |
|
Self-contained flat |
04 |
Self-contained flat |
|
Unconventional dwelling |
05 |
Unconventional dwellings such as yurts , camping pods, caravans (excluding those located within licenced caravan sites) used mainly for holiday lets – ie. any accommodation requiring a licence that is not a dwelling or house |
Type of Short Term Let
XML Tag:
LettingType
Description:
Type of short term let that the property will be using. Home sharing is when a room or bed at the property is let out and the owner is still nominally living at the property. Home letting is when the whole primary dwelling of the owner is let out (for example, while they are away on holiday or working on an oil rig). Secondary letting is when a property that is let out is not the primary dwelling of the owner or another person. Second homes that are used by owners and not let out are not included.
Format
List (two digits codes with leading zeros)
Validation
Mandatory (Optional if application is invalid)
|
Type of short term let |
Code |
Description |
|
Home sharing |
01 |
Part of the owner’s primary residence is let out whilst they are present |
|
Home letting |
02 |
All of part of the owner’s primary residence is let out whilst they are absent |
|
Home sharing and letting |
03 |
Licence allowing for a mix of both home sharing and home letting |
|
Secondary letting |
04 |
An owners non-primary residence is let out (entire premises) |
EPC rating
XML Tag:
EPC
Description:
The latest valid Energy Performance Certificate letter rating for the property, if available.
Format
List (single character from A to G)
Validation
Mandatory (Optional when a property does not have a valid EPC, for example where only a room within a building is being let, or for certain types of dwellings not covered by EPC regulations)
|
EPC Rating |
|
A |
|
B |
|
C |
|
D |
|
E |
|
F |
|
G |
Accommodation units on premises
XML Tag:
AccommodationUnitsOnPremises
Description:
How many separately lettable short term letting accommodation units are at the licensed address. Camping pods or yurts in a field are each individual accommodation units at the premises of the field. Multiple rooms in a bed and breakfast also count as multiple accommodation units on the same premises. Multiple flats in a block of flats, each let out separately are considered separate premises and separate accommodation units, each requiring a separate licence. A whole home being let out would count as a single premises.
Format
Integer
Validation
Mandatory (Optional if application is invalid)
Must be one, or greater
Maximum occupancy
XML Tag:
MaximumOccupancy
Description:
Number of guests permitted to reside on the premises.
Format
Integer
Validation
Mandatory (Optional if application is invalid)
Must be greater than 0
Number of bedrooms
XML Tag:
NumberOfBedrooms
Description:
Number of bedrooms available for let in the short term let.
Format
Integer
Validation
Mandatory (Optional if application is invalid)
Must be greater than 0
Contact
Email: housingstatistics@gov.scot
There is a problem
Thanks for your feedback