LIDAR Status

LIDAR Status reports whether the elevation (LIDAR/DSM) data selected for a design is out of date relative to the imagery selected for that same design, along with the capture date of each and the resolution of the imagery.

Use it before running AI Roof to predict output quality. A design whose elevation data no longer matches its imagery, typically because the building changed after the elevation data was captured, is likely to produce a poorer roof model.

What "out of date" means here

This is a comparison between the two sources, not a judgement about whether either one is current.

Two sources captured on the same day agree with each other even if both are several years old, and that design will report up_to_date. Read capture_date alongside the verdict to judge absolute age. The two signals answer different questions:

out_of_date.status answers "does the elevation data still match the imagery?"
imagery.capture_date and lidar.capture_date answer "how old is this data?"

Interpreting the response

out_of_date.status is one of:

up_to_date — the elevation data matches the imagery. Expect normal AI Roof quality.
out_of_date — the elevation data no longer matches the imagery. Expect a poorer roof model, and consider sourcing newer data first.
unavailable — no verdict could be produced. This is an answer, not an error, and the endpoint still returns 200.

When status is unavailable, reason explains why:

lidar_data_unavailable — the imagery or elevation data for this design could not be identified or is not yet usable, so there is nothing to compare. If the project was created recently, wait for the imagery_lidar_completed event and try again.
computation_failed — the comparison could not be completed. Retrying may succeed.

reason is null for any status other than unavailable.

Metadata availability

Capture date and resolution depend on the provider and on how old the record is, so any of these fields may be null:

Imagery reports capture_date and resolution (in centimetres per pixel) where the provider supplies them.
Elevation data reports capture_date only. Resolution is not exposed because stored point spacing may have been downsampled, which would make the number misleading.
For Aurora LIDAR flights spanning several days, capture_date is the start of the capture window.

Please be aware

This endpoint reports on the imagery and elevation data currently selected for the design. Changing the active selection can change the result.
A result of up_to_date is not a guarantee of AI Roof success. It indicates the two data sources are consistent, which is one input to quality among several.