Create a site
Submit one property for measurement. Duranta looks the address up with several services and measures the parcel most of them place it on. When they disagree with no majority, the site gets PARCEL_AMBIGUOUS and is not measured or charged: choose the parcel with FindParcels and CreateParcelSite, see [Choosing the parcel](/parcels/).
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*stringYour identifier for the property. It is the key for every later call. Submitting the same
externalId again with the same address returns the current site and does not start a
second scan, unless the site is SITE_STATUS_FAILED, which is scanned again; a changed
address starts a new one. An externalId that already exists with a different aiModel,
propertyBoundary or boundary fails with already_exists; use a new externalId.
At most 1024 bytes.
address*US street address. line1, city, region and postalCode are required.
tier*ResultTierThe results this site includes. Submitting the same externalId again with a different
tier switches the site to that tier; with the same address, this does not start a new
scan. A tier that is not enabled for your workspace fails with permission_denied; contact
Duranta to enable it.
"RESULT_TIER_IMAGE""RESULT_TIER_IMAGE_AND_SEGMENTS""RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK"aiModel?AiModelThe AI model, fixed when the site is created. Leave it out for AI_MODEL_AUTO. When the
externalId already exists, leaving it out keeps the site's model, and a different value
fails with already_exists: use a new externalId to scan with another model.
"AI_MODEL_AUTO""AI_MODEL_RESIDENTIAL""AI_MODEL_COMMERCIAL_FAST""AI_MODEL_COMMERCIAL_MAKROS"propertyBoundary?PropertyBoundaryThe property boundary, fixed when the site is created. Leave it out for
PROPERTY_BOUNDARY_OFFICIAL. Resubmitting an existing externalId works like aiModel.
"PROPERTY_BOUNDARY_OFFICIAL""PROPERTY_BOUNDARY_ESTIMATED"boundary?|A custom scan area, fixed when the site is created. A GeoJSON Polygon or MultiPolygon
with [longitude, latitude] WGS 84 coordinates, the same shape as boundary in the
result. Duranta measures exactly this area instead of the property boundary it looks up
for the address; the address is still required. Use it for office parks, HOA grounds and
other multi-parcel sites. The first ring of a polygon is the outer edge and the others are
holes. A ring that is not closed is closed for you. The area must be larger than zero and
at most 2 square kilometers (about 494 acres), with at most 5000 vertices in total, and
rings must not cross themselves. Anything else fails with invalid_argument. It cannot be
combined with PROPERTY_BOUNDARY_ESTIMATED. Leave it out to use the property boundary.
When the externalId already exists, leaving it out keeps the site's area, the same
polygon is accepted, and a different one fails with already_exists; use a new
externalId to scan another area. The address of such a site can still be corrected.
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/CreateSite' \ -H 'Content-Type: application/json' \ -d '{ "externalId": "PROP-000001", "address": { "line1": "2910 Mall Dr", "city": "Eau Claire", "region": "WI", "postalCode": "54701", "country": "US" }, "tier": "RESULT_TIER_IMAGE"}'{ "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"}