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

Property usage

  • 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

Crimes

  • 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

Building height

  • buildingHeightWithRoof
  • buildingHeightWithoutRoof

The height of the building

GB

Height: 12m

Core

Number of floors

  • 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

Cytora Fire Risk

  • 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

  • floorAreaBuilding

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

Basement presence

  • basementPresent

A flag to indicate estimated presence of basement

GB

Basement present: True

Proprietary

Roof type

  • roofType

The type of roof

England, Wales

Roof type: flat

Advanced

Flood Risk Score

  • floodRiskScore
  • floodAnnualisedLossCost
  • floodRiskDrivers

The risk of flood-related loss

UK

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

Core

Windstorm Risk Score

  • windstormRiskScore
  • windstormAnnualisedLossCost

The risk of windstorm-related loss

GB

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

Core

Construction year

  • constructionYear
  • constructionYearBandings

The year the building was constructed or refurbished

GB

Construction year: 1975

Advanced

Listed building

  • listedBuildingGrade

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

UK

listedBuildingGrade: II

Advanced

Fire events

  • fireEvents

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

UK

fire event date: 20/11/2011
cause: fault in equipment
estimated damage: 20 m^2

Advanced

Adjacent risk

  • adjacentRisks

An indication of the risks adjacent to the property

GB

Adjacent fireworks factories: 5
Adjacent oil companies: 2

Proprietary

Fire service statistics

  • fireResponseTime
  • fireServiceStatistics

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

  • sprinklersPresent

A flag to indicate the presence of at least one sprinkler

GB

Sprinkler presence: True

Proprietary

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