Get a site
Get one site by your externalId.
Authorization
AuthorizationrequiredBearer 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.
application/json- body
externalId*stringThe externalId you submitted.
At most 1024 bytes.
Success
application/json- response
A property submitted for measurement. Measurement fields are set only when status is
SITE_STATUS_COMPLETED, and only those that tier includes.
externalId?stringYour identifier for the property, as you submitted it.
address?The address as you submitted it.
status?SiteStatusWhere the site is in measurement.
"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?stringLink 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?numberArea of the parcel boundary, in square feet.
doublesurfaces?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?stringWhen you submitted the site.
date-timetier?ResultTierThe tier chosen in CreateSite.
"RESULT_TIER_IMAGE""RESULT_TIER_IMAGE_AND_SEGMENTS""RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK"shareUrl?stringRead-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?AiModelAI_MODEL_AUTO until the scan picks a model, then the model that ran. Never unspecified.
"AI_MODEL_AUTO""AI_MODEL_RESIDENTIAL""AI_MODEL_COMMERCIAL_FAST""AI_MODEL_COMMERCIAL_MAKROS"propertyBoundary?PropertyBoundaryThe property boundary the site was created with. Never unspecified.
"PROPERTY_BOUNDARY_OFFICIAL""PROPERTY_BOUNDARY_ESTIMATED"updatedAt?stringWhen 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.
date-timerevision?stringStarts at 1 and increases on every change that moves updatedAt. Compare it to tell
whether a site changed since you last read it.
int64curl -X POST \ 'https://app.getduranta.com/duranta.api.public.v1.SiteService/GetSite' \ -H 'Content-Type: application/json' \ -d '{ "externalId": "PROP-000001"}'{ "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"}