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!

Data menu

The data menu below presents the high-level characteristics of the data that Cytora makes available via the Property API. For detailed information such as attribute names or data limitations, refer to the specific dataset section.

Data categories

  • Core - Information about properties and companies that is typically used in underwriting processes, such as Property Usage and Trade Code.
  • Advanced - Information about properties and companies that is either difficult to acquire in machine readable format, such as Listed Building Status or CQC Rating, or not traditionally used in Underwriting, such as Socioeconomic Indices.
  • Proprietary - Information about properties and companies that is difficult to acquire and unique to Cytora, enriched and enhanced using our engineering and modelling capabilities, such as Fire Risk Scores and Adjacent Risk.
Dataset
Attributes
Description
Coverage
Examples
Data Category
  • primaryPropertyUsage
  • secondaryPropertyUsage
  • tertiaryPropertyUsage
  • quaternaryPropertyUsage

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

GB

Tertiary classification code: 03
Tertiary classification description: Prison

Core

Multi-occupancy

  • multiOccupancy

The distribution of property usage classification types within a building

GB

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

Advanced

  • crimesCountAntisocialBehaviour
  • crimesCountBicycleTheft
  • crimesCountBurglary
  • crimesCountCriminalDamageAndArson
  • crimesCountDrugs
  • crimesCountOther
  • crimesCountOtherThefts
  • crimesCountPossessionOfWeapons
  • crimesCountPublicOrder
  • crimesCountRobbery
  • crimesCountShoplifting
  • crimesCountTheftFromThePerson
  • crimesCountVehicleCrime
  • crimesCountViolenceAndSexualOffence

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

UK

Arson and Criminal Damage: 10
Theft: 5
Vehicle crime: 3

Core

  • buildingHeightWithRoof
  • buildingHeightWithoutRoof

The height of the building

GB

Height: 12m

Core

  • floorCount

The estimated number of floors

GB

Estimated floors: 5

Proprietary

Construction material

  • constructionMaterial
  • roofMaterial

The structure/wall material and roof material

GB

Known structure material: masonry Known roof material: masonry

Proprietary

  • fireRiskScore
  • fireRiskDrivers

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

GB

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

Proprietary

Floor area

Available soon

The floor area of the property unit and of the building

England, Wales

Unit floor area: 123 m^2
Building floor area: 1234 m^2

Core

  • basementPresent

A flag to indicate estimated presence of basement

GB

Basement present: True

Proprietary

Roof type

Available soon

The type of roof

England, Wales

Roof type: flat

Advanced

Flood Risk Score

Available soon

The risk of flood-related loss

UK

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

Core

Windstorm Risk Score

Available soon

The risk of windstorm-related loss

GB

Windstorm score: D
Windstorm risk 0.00000005 £ per year per £ insured

Core

Construction year

Available soon

The year the building was constructed or refurbished

GB

Construction year: 1975

Advanced

Listed building

Available soon

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

UK

listedBuildingGrade: II

Advanced

Adjacent risk

Available soon

An indication of the risks adjacent to the property

GB

Adjacent fireworks factories: 5
Adjacent oil companies: 2

Proprietary

Distance to fire station

Available soon

The distance to the nearest fire station

GB

Distance to nearest fire station: 2.4 km

Proprietary

Health and Safety Executive notices and prosecutions register

Available soon

A flag to indicate a company's HSE record, along with details of any infraction

GB

Notices served: 1
Notice date: 2019-01-01
Notice breaches: Health and Safety at Work Act 1974 Section 2 / 1
Notice status: Complied

Advanced

Subsidence risk scores

Available soon

The risk of subsidence-related loss

GB

tbd

Core

Ground floor elevation

Available soon

The altitude above sea-level

GB

Ground floor elevation: 54 m

Core

CQC reports

Available soon

Compiled report ratings and descriptions of CQC regulated institutions

England, Wales

CQC rating: Needs improvement
CQC web link: https://www...

Advanced

Ofsted reports

Available soon

Compiled report ratings and descriptions of Ofsted related institutions

England, Wales

Ofsted rating: Needs improvement
Ofsted web link: https://www..

Advanced

Local fire service statistics

Available soon

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

England

Mean response time: 455s
Fire service headcount: 150
Full-time: 35
Part-time: 40
Retained: 40
Non-retained: 35

Core

Sprinkler presence

Available soon

A flag to indicate the presence of at least one sprinkler

GB

Sprinkler presence: True

Proprietary

Company trade code

Available soon

The "UK SIC 2007" trade code

GB

Trade code: 82990 Trade code description: Other business support service activities

Core

Local socioeconomic indices

Available soon

Relative rank of the LSOA against all others in terms of the multiple indices of deprivation: income; employment; education; health; crime; housing; environment; skills; geography.

England

Overall index rank: 1234
Income rank: 4981
Employment rank: 20219 ...

Advanced

County Court Judgements, Fines and Orders Register

Available soon

The full CCJ register along with status, dates and fine amounts.

GB

County court judgment date: 2019-01-01
County Court Judgment status: Paid
County Court Judgment amount: £15,000

Core

Company turnover

Available soon

The estimated turnover

GB

Company turnover: £1,234,567

Core

Company credit score

Available soon

The credit score

GB

Company credit score: A+

Core

Updated about a month ago


Data menu


Suggested Edits are limited on API Reference Pages

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