Roof Age is a Nearmap API product that predicts the roof installation date and therefore age of both residential and commercial roofs. Predictions are generated using Nearmap aerial imagery, Gen 6 AI data, and third-party sources including climate records, building permits, and assessor year-built data to arrive at an accurate age estimation. More details on how roof age is calculated are available here.

You can use this API to retrieve roof age data that includes roof instances, age and type. You can augment this with information about roof condition, materials, objects and so on, using Roof Age API in conjunction with the AI Feature API.

Note: This API is currently available for US properties only.

Key Features

• AOI-based analysis: Estimates age for all roofs within a defined area of interest.
• AI-powered: Leverages machine learning trained on visual indicators (material degradation, condition, architectural features) and third-party data.
• Latest-data endpoint: A dedicated endpoint always returns the most recently processed result without requiring you to manage resource IDs.

Output format: GeoJSON

Endpoints

• v1 /ai/roofage/v1/resources/{resourceId}.{fileFormat} endpoint returns roof age data for a specific historical resource. The resourceId must first be obtained via the v1 /ai/roofage/v1/resources/latest.{fileFormat} endpoint.
• v1 /ai/roofage/v1/resources/latest.{fileFormat} endpoint returns the most recent roof age analysis data for the supplied AOI. Use this endpoint in standard workflows where you want the latest available data. The response includes a resourceId that can be passed to the versioned endpoint if you need to retrieve the same result later.

Combining with the AI Feature API

Roof Age data can be enriched with additional roof attributes such as condition, materials, and detected objects by calling the AI Feature API for the same AOI. Use the parcel polygon as a consistent AOI across both requests.