Raw schema
{
"type": "object",
"properties": {
"postcode": {
"type": "string",
"description": "Full UK postcode of the property, for example M14 5RF. Partial postcodes are not accepted.",
"minLength": 5
},
"asking_price": {
"type": "number",
"description": "Asking price in GBP.",
"minimum": 10000,
"maximum": 20000000
},
"property_type": {
"type": "string",
"enum": [
"flat",
"terraced",
"semi",
"detached"
],
"description": "Type of property."
},
"bedrooms": {
"type": "integer",
"description": "Number of bedrooms, 1 to 6.",
"minimum": 1,
"maximum": 6
},
"tenure": {
"type": "string",
"enum": [
"freehold",
"leasehold"
],
"description": "Freehold or leasehold.",
"default": "freehold"
},
"epc_rating": {
"type": "string",
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G"
],
"description": "EPC rating, if known."
},
"monthly_rent": {
"type": "number",
"description": "Expected monthly rent in GBP. Omit to use the ONS average for the area and bedroom count.",
"minimum": 1,
"maximum": 50000
},
"service_charge_monthly": {
"type": "number",
"description": "Monthly service charge in GBP (leasehold flats).",
"minimum": 0,
"maximum": 5000,
"default": 0
},
"ground_rent_annual": {
"type": "number",
"description": "Annual ground rent in GBP.",
"minimum": 0,
"maximum": 10000,
"default": 0
},
"deposit_pct": {
"type": "number",
"description": "Deposit as a percentage of the price.",
"minimum": 0,
"maximum": 100,
"default": 25
},
"mortgage_rate": {
"type": "number",
"description": "Annual mortgage rate as a percentage.",
"minimum": 0,
"maximum": 15,
"default": 4.5
},
"agent_fee_pct": {
"type": "number",
"description": "Letting agent fee as a percentage of rent. Pass 0 if the landlord self-manages.",
"minimum": 0,
"maximum": 30,
"default": 12
},
"repairs_pct": {
"type": "number",
"description": "Repairs allowance as a percentage of rent.",
"minimum": 0,
"maximum": 30,
"default": 5
},
"void_months": {
"type": "number",
"description": "Expected empty months per year.",
"minimum": 0,
"maximum": 6,
"default": 1
},
"ownership_type": {
"type": "string",
"enum": [
"personal",
"company"
],
"description": "Held personally (Section 24 applies) or through a limited company.",
"default": "personal"
},
"tax_band": {
"type": "string",
"enum": [
"basic",
"higher",
"additional"
],
"description": "The landlord's income tax band: basic (20%), higher (40%) or additional (45%).",
"default": "higher"
}
},
"required": [
"postcode",
"asking_price",
"property_type",
"bedrooms"
],
"additionalProperties": false
}