Property measurement

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/).

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

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

Your 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*ResultTier

The 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.

One of"RESULT_TIER_IMAGE""RESULT_TIER_IMAGE_AND_SEGMENTS""RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK"
aiModel?AiModel

The 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.

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

The property boundary, fixed when the site is created. Leave it out for PROPERTY_BOUNDARY_OFFICIAL. Resubmitting an existing externalId works like aiModel.

One of"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.

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
Create a site
curl -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"}'
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"}