Property measurement

Get a site

Get one site by your externalId.

POST
/duranta.api.public.v1.SiteService/GetSite

Authorization

Authorizationheaderrequired

Bearer token with the sites:scan scope. You get it in exchange for an API key: see Authentication, or press Try in Playground, which takes your key and gets the token for you.

Request body

application/json
  1. body
externalId*string

The externalId you submitted. At most 1024 bytes.

Response

Success

application/json
  1. response

A property submitted for measurement. Measurement fields are set only when status is SITE_STATUS_COMPLETED, and only those that tier includes.

externalId?string

Your identifier for the property, as you submitted it.

address?

The address as you submitted it.

status?SiteStatus

Where the site is in measurement.

One of"SITE_STATUS_ACCEPTED""SITE_STATUS_ISSUE""SITE_STATUS_COMPLETED""SITE_STATUS_FAILED"
error?

Set when status is SITE_STATUS_ISSUE or SITE_STATUS_FAILED. code is one of ADDRESS_NOT_FOUND (the address does not resolve to a location), PARCEL_AMBIGUOUS (the address lookup services place the address on different parcels with no majority; use FindParcels and CreateParcelSite), PARCEL_NOT_FOUND (no parcel at the location), INSUFFICIENT_CREDITS (the credit balance is below zero; send the site again once credits are added), or SCAN_FAILED (the scan could not produce measurements).

appUrl?string

Link to the property in the Duranta app, for a person to review or correct it. Requires a Duranta login to open.

location?

Geocoded point for the address.

parcelAreaSqFt?number

Area of the parcel boundary, in square feet.

Formatdouble
surfaces?array<>

Every surface type the scan reports. Tree and shrub canopy overlap the surfaces beneath them, so the areas can sum to more than the parcel. Set from RESULT_TIER_IMAGE_AND_SEGMENTS up.

boundary?

The parcel outline the scan was clipped to, as a GeoJSON MultiPolygon. Set by GetSite from RESULT_TIER_IMAGE_AND_SEGMENTS up.

image?

The measurement map. Set by GetSite for every tier, unless the site has no parcel to draw.

submittedAt?string

When you submitted the site.

Formatdate-time
tier?ResultTier

The tier chosen in CreateSite.

One of"RESULT_TIER_IMAGE""RESULT_TIER_IMAGE_AND_SEGMENTS""RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK"
shareUrl?string

Read-only public link to the measurement map, no login needed. Anyone with the link can open it. Set for RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK once the site is completed. Moving the site to a lower tier revokes the link.

aiModel?AiModel

AI_MODEL_AUTO until the scan picks a model, then the model that ran. Never unspecified.

One of"AI_MODEL_AUTO""AI_MODEL_RESIDENTIAL""AI_MODEL_COMMERCIAL_FAST""AI_MODEL_COMMERCIAL_MAKROS"
propertyBoundary?PropertyBoundary

The property boundary the site was created with. Never unspecified.

One of"PROPERTY_BOUNDARY_OFFICIAL""PROPERTY_BOUNDARY_ESTIMATED"
updatedAt?string

When the site last changed in a way you can see: a scan result, a status change, a tier change, or a correction made in the Duranta app.

Formatdate-time
revision?string

Starts at 1 and increases on every change that moves updatedAt. Compare it to tell whether a site changed since you last read it.

Formatint64
Get a site
curl -X POST \  'https://app.getduranta.com/duranta.api.public.v1.SiteService/GetSite' \  -H 'Content-Type: application/json' \  -d '{  "externalId": "PROP-000001"}'
Response
{  "externalId": "PROP-000001",  "address": {    "line1": "2910 Mall Dr",    "city": "Eau Claire",    "region": "WI",    "postalCode": "54701",    "country": "US"  },  "appUrl": "https://app.getduranta.com/...",  "submittedAt": "2026-06-05T17:39:02Z",  "updatedAt": "2026-06-05T17:39:02Z",  "revision": "1",  "status": "SITE_STATUS_ACCEPTED",  "tier": "RESULT_TIER_IMAGE"}