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.

Attribute

Description

Examples

Adjacent Risk

An indication of the risks adjacent to the property

Adjacent risk: Hotel/Motel
Distance: 4 meter

Basement Presence

A flag to indicate whether a basement is present

Basement present: True

Building Heights

The height of the building

Height without roof: 12m
Height with roof: 15m

Construction Materials

The structure/wall material and roof material

Construction material: masonry
Roof material: metal

Construction Year

The year the building was constructed or refurbished

Construction year: 1975

Crimes

A count of crimes that have occurred nearby, also aggregated by type of crime per year

Arson and criminal damage: 10
Theft: 5
Vehicle crime: 3

Fire Events

A list of commercial property's fire events with date, location and severity

Fire event date: 20/11/2011
Cause: fault in equipment
Estimated damage: 20 m^2

Fire Risk

The Cytora proprietary Fire Risk score, algorithmically determined from a multitude of fire related rating factors

Cytora fire score: C
Key drivers: Distance to fire station (positive); Arson crime level (negative); occupancy (negative)

Fire Service Statistics

Typical fire service response times, headcounts and proportions of staff employed full-time/part-time/retained/non-retained

Average response time: 455s
Number of Firefighters compared to the average: 1.15
Number of Fire appliances compared to the average: 0.6

Flood Risk

The risk of flood-related loss

Flood score: C
Flood risk: 0.00000005 £ per year per £ insured

Floor Area

The floor area of the building

Building floor area: 1234 m^2

Floor Count

The number of floors within a building

Floor count: 5

Listed Building

A flag to indicate the listed status and grade, along with a link to the relevant website entry

Listed building grade: II

Multi-Occupancy

The property usage of all units within a same building

Offices: 25
Warehousing: 3
Bars: 2
Restaurants: 2
Gyms: 1

Property Usage

The property usage type (what the property is used for)

Primary property usage: Commercial
Secondary property usage: Retail
Tertiary property usage: Shop / Showroom

Roof Type

The type of roof

Roof type: flat

Sprinkler Presence

Indicates whether the building was identified to have at least one sprinkler (True) or no sprinklers (False)

Sprinkler presence: True

Windstorm Risk

The risk of windstorm-related loss

Windstorm score: D
Annual loss costs: 0.00000005 £ per sum insured

Updated 4 months 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.