API Documentation

Welcome to the Cytora API documentation. You'll find comprehensive guides to explain what Cytora can provide and developer documentation how to integrate Cytora APIs in your processes. And if there is anything missing or confusing, feel free to raise a question in the discussion. Again welcome! Hope you enjoy it!

Property API

All the necessary property information you need in 1 API call

The Property API provides all the necessary data when you review or underwrite the property. The API collects information about the unit, building and area around the building to improve your accuracy and efficiency.
Depending on the address information that you have received, the Property API will match to a valid address and provide you all the property information which you have selected.

Address Types

The Property API supports address information of three different types:

  • Property resolution with an address
    By providing the address information of the property in the fullAddress as an input parameter the API will try to match to an address, even if the address is incomplete.
  • Property resolution with geographic coordinates
    By providing geographic coordinates - latitude & longitude - as an input parameter the API will try to match to an address, even if the coordinates are not that precise.
  • Property resolution with a Unique Property Reference Number
    By providing the UPRN as an input parameter, the API will match to an address.

Data Menu

You can select from the data menu which attributes you would like to receive for each address. For more information about the data source, coverage, update frequency and other information for each attribute, please see each individual page.

AttributeDescriptionExamples
Adjacent RiskAn indication of the risks adjacent to the propertyAdjacent risk: Hotel/Motel
Distance: 4 meter
Basement PresenceA flag to indicate whether a basement is presentBasement present: True
Building HeightsThe height of the buildingHeight without roof: 12m
Height with roof: 15m
Construction MaterialsThe structure/wall material and roof materialConstruction material: masonry
Roof material: metal
Construction YearThe year the building was constructed or refurbishedConstruction year: 1975
CrimesA count of crimes that have occurred nearby, also aggregated by type of crime per yearArson and criminal damage: 10
Theft: 5
Vehicle crime: 3
Fire EventsA list of commercial property's fire events with date, location and severityFire event date: 20/11/2011
Cause: fault in equipment
Estimated damage: 20 m^2
Fire RiskThe Cytora proprietary Fire Risk score, algorithmically determined from a multitude of fire related rating factorsCytora fire score: C
Key drivers: Distance to fire station (positive); Arson crime level (negative); occupancy (negative)
Fire Service StatisticsTypical fire service response times, headcounts and proportions of staff employed full-time/part-time/retained/non-retainedAverage response time: 455s
Number of Firefighters compared to the average: 1.15
Number of Fire appliances compared to the average: 0.6
Flood RiskThe risk of flood-related lossFlood score: C
Flood risk: 0.00000005 £ per year per £ insured
Floor AreaThe floor area of the buildingBuilding floor area: 1234 m^2
Floor CountThe number of floors within a buildingFloor count: 5
Listed BuildingA flag to indicate the listed status and grade, along with a link to the relevant website entryListed building grade: II
Multi-OccupancyThe property usage of all units within a same buildingOffices: 25
Warehousing: 3
Bars: 2
Restaurants: 2
Gyms: 1
Property UsageThe property usage type (what the property is used for)Primary property usage: Commercial
Secondary property usage: Retail
Tertiary property usage: Shop / Showroom
Roof TypeThe type of roofRoof type: flat
Sprinkler PresenceIndicates whether the building was identified to have at least one sprinkler (True) or no sprinklers (False)Sprinkler presence: True
Windstorm RiskThe risk of windstorm-related lossWindstorm score: D
Annual loss costs: 0.00000005 £ per sum insured

Updated 24 days ago


Property API


All the necessary property information you need in 1 API call

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.