{"openapi":"3.1.0","info":{"title":"Duranta API","version":"v1","description":"The Duranta API lets your systems send customers into a Duranta workspace and\nmeasure properties from aerial imagery.\n\n## Requests and responses\n\nEvery call is an HTTPS `POST` with a JSON body, reads included. Any HTTP client works,\nand you can generate a typed client from this OpenAPI document.\n\n```http title=\"Every request\"\nPOST https://app.getduranta.com/duranta.api.public.v1.<Service>/<Method>\nContent-Type: application/json\nAuthorization: Bearer <access_token>\n```\n\nFor example, to read one site:\n\n```bash\ncurl https://app.getduranta.com/duranta.api.public.v1.SiteService/GetSite \\\n  -H \"Authorization: Bearer $TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"externalId\": \"PROP-000001\"}'\n```\n\n### Conventions\n\n- JSON field names are camelCase.\n- Enum values are strings such as `CUSTOMER_KIND_COMMERCIAL`.\n- Timestamps are RFC 3339 strings in UTC, such as `2026-06-05T17:42:10Z`.\n- 64-bit integers, such as `serverRevision`, are JSON strings.\n- Bytes, such as an image, are base64 strings.\n- Fields that are empty, zero or false are left out of responses. Treat a missing\n  field as its empty value.\n- A request with an unknown field or an enum value that isn't listed fails with\n  `invalid_argument` and a message naming the field. A field we retire is marked\n  deprecated and still accepted until the next version.\n- Ignore response fields and enum values you don't recognize: we add them without a new\n  version.\n- Request bodies are limited to 5 MiB.\n\n## Versions\n\nThe version is part of every path, as in `duranta.api.public.v1`. Within a version we\nonly make additive changes: new fields, new enum values, new operations. Anything\nthat could break a working integration ships as a new version, `duranta.api.public.v2`.\n\n## Authentication\n\nThe API uses the OAuth 2.0 client credentials grant, for a backend that works with\none Duranta workspace.\n\n### Get a token\n\nCreate a key in **Settings → API** in the Duranta app. You get a **client ID** and a\n**client secret**; the same page shows the **workspace ID** they are tied to. If you\ndon't see the API tab, ask your Duranta account manager to enable the API for your\nworkspace. Then exchange the key for a token:\n\n```bash\ncurl https://logto.app.getduranta.com/oidc/token \\\n  -u \"$CLIENT_ID:$CLIENT_SECRET\" \\\n  -d grant_type=client_credentials \\\n  -d resource=https://public.api.getduranta.com \\\n  -d organization_id=$WORKSPACE_ID \\\n  -d scope=sites:scan\n```\n\n`resource` and `organization_id` are required. A token without them does not work\nwith this API.\n\nThe dialog that shows your client secret has this command ready to copy, with your\nvalues filled in. To try calls without writing code, press **Try in Playground** on\nany operation page, or use the playground in **Settings → API**. Both take your key\nand get the token for you.\n\n### Use the token\n\nSend the returned `access_token` as `Authorization: Bearer <access_token>`. The token\nnames the workspace, so no other header is needed. There is no refresh token: when\n`expires_in` runs out, request a new token the same way. Reuse one token for all\ncalls until then; don't request a token per call. Keep the client secret on your\nserver.\n\n### Scopes\n\nAsk for the scope of each service you call. A token without it gets\n`permission_denied`.\n\n| Scope | Grants |\n|---|---|\n| `customers:import` | `CustomerService` |\n| `sites:scan` | `SiteService` |\n\n## Sandbox\n\nBuild and test your integration in the [sandbox](/sandbox/), a separate environment with\nthe same API. Ask your Duranta account manager for a sandbox login.\n\n## Errors\n\nA call either fails as a whole with an HTTP error, or succeeds with some records\nrejected. The two are reported differently.\n\n**A rejected record** is a normal result. The call returns HTTP 200 and the result\ncarries an `error` object with a stable string `code` and a readable `message`. Fix\nthe data and send the record again.\n\n**A failed call** returns an HTTP error status and a JSON body:\n\n```json\n{\n  \"code\": \"unauthenticated\",\n  \"message\": \"invalid API credential\"\n}\n```\n\nBranch on the HTTP status or on `code`. `message` is for people, not for parsing.\n\n| HTTP | Code | Meaning | Retry? |\n|---|---|---|---|\n| 400 | `invalid_argument` | A field is missing or malformed. `message` names it. | No, fix the request |\n| 401 | `unauthenticated` | The credential is missing, expired or invalid. | After getting a new token |\n| 403 | `permission_denied` | The credential lacks the scope for this call, or, for `SiteService`, the workspace does not have the API or Site Scanner enabled or the requested `tier` is not enabled for it. | No |\n| 404 | `not_found` | No site with this `externalId`. | No |\n| 409 | `already_exists` | The `idempotencyKey` was already used with a different request. | No, use a new key |\n| 429 | `resource_exhausted` | The request body is too large. | No, send a smaller request |\n| 503 | `unavailable` | Temporary problem on our side. | Yes, with backoff |\n| 504 | `deadline_exceeded` | The call did not finish in time. | Yes, with backoff |\n| 500 | `internal` | Unexpected error. | Yes, with backoff |\n\n## Retries and idempotency\n\nA call can time out after the server has done the work, so writes are safe to\nretry. `UpsertCustomer` takes an `idempotencyKey`: repeat the call with the same key\nand the same record and you get the original response, with nothing written twice.\n`CreateSite` is keyed by your `externalId`: submitting the same id with the same\naddress again returns the current site and does not start a second scan, unless the\nsite's status is `SITE_STATUS_FAILED`: then the scan runs again.\n\n## Pagination\n\n`ListSites` returns up to `pageSize` items and a `nextPageToken`. Pass it as\n`pageToken` to get the next page; an empty `nextPageToken` means the last page."},"servers":[{"url":"https://app.getduranta.com","description":"Production"}],"security":[{"oauth2":[]}],"tags":[{"name":"CustomerService","x-displayName":"Customers","description":"Create and update customers from your system. Requires the `customers:import` scope."},{"name":"SiteService","x-displayName":"Sites","description":"Measure properties from aerial imagery. Requires the `sites:scan` scope.\n\n1. Call `CreateSite` with one address and a result `tier`. The site starts in\n   `SITE_STATUS_ACCEPTED` while the address is checked and the scan runs in the background.\n2. Poll `GetSite` until the status changes, or call `ListSites` to check many sites at\n   once. An address that cannot be used ends in `SITE_STATUS_ISSUE`.\n3. Call `GetSite` for the result. The tier decides what it includes.\n\n**Polling for changes.** Every site has `updatedAt` and `revision`. They change on a scan\nresult, a status change, a tier change, and a correction made in the Duranta app. To read\nonly what changed, call `ListSites` with `updatedSince` set to the last `updatedAt` you\nsaw and `orderBy` set to `SITE_ORDER_UPDATED_ASC`. Page with `nextPageToken`, and save\nthe `updatedAt` of the last site you processed for the next poll. Set `updatedSince` a\nminute earlier than that: a change can become visible slightly after its `updatedAt`. Skip\nsites whose `revision` you already have.\n\n| Tier | The result includes |\n|---|---|\n| `RESULT_TIER_IMAGE` | The measurement map as an inline base64 image in `image.data`. |\n| `RESULT_TIER_IMAGE_AND_SEGMENTS` | The map, plus every surface with its area, perimeter, polygon count and geometry, and the parcel boundary. |\n| `RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK` | All of the above, plus `shareUrl`: a read-only map link that opens without a Duranta login. |\n\nTiers will be priced differently. A workspace can request the tiers Duranta has\nenabled for it; a higher tier is refused with `permission_denied`.\n\n`CreateSite` also takes two optional settings, the same as \"AI model\" and \"Property\nboundary\" in the Duranta app. They are fixed when the site is created. Resubmitting an\nexisting `externalId` without them keeps the site's settings; with a different value it\nfails with `already_exists`, so use a new `externalId` to scan with other settings.\n\n| `aiModel` | Measures with |\n|---|---|\n| `AI_MODEL_AUTO` (default) | Aidan classifies the property as residential or commercial, then runs Residential for residential properties. Commercial properties run Commercial - Fast below 5 acres and Commercial - Makros above 5 acres. |\n| `AI_MODEL_RESIDENTIAL` | Aidan Residential: semantic segmentation for residential properties. |\n| `AI_MODEL_COMMERCIAL_FAST` | Aidan Commercial - Fast: instance segmentation, optimized for speed and smaller properties. |\n| `AI_MODEL_COMMERCIAL_MAKROS` | Aidan Commercial - Makros (beta): instance segmentation, optimized for accuracy. Slower. |\n\n| `propertyBoundary` | Limits the scan to |\n|---|---|\n| `PROPERTY_BOUNDARY_OFFICIAL` (default) | The official county property boundary. |\n| `PROPERTY_BOUNDARY_ESTIMATED` | The service area Duranta estimates from the imagery. |\n\n**Custom boundary.** For a site that is not one parcel, such as an office park or an HOA,\nsend `boundary`: a GeoJSON `Polygon` or `MultiPolygon` with `[longitude, latitude]`\ncoordinates. Duranta measures exactly that area, up to 2 square kilometers, instead of\nthe parcel it looks up for the address. It is fixed when the site is created, like the\nsettings above, and cannot be combined with `PROPERTY_BOUNDARY_ESTIMATED`. The result\nreturns it as `boundary` and `parcelAreaSqFt`."},{"name":"WebhookService","description":"Get called when something happens instead of polling. Duranta sends each event as an HTTPS POST\n with a JSON body `{\"id\", \"type\", \"timestamp\", \"data\"}` and the Standard Webhooks headers\n `webhook-id`, `webhook-timestamp` and `webhook-signature`; verify the signature with the secret\n from `CreateWebhookEndpoint`. Answer with a 2xx status within 15 seconds. Anything else, including\n redirects, is retried up to 8 attempts over about 27 hours. The `data.site` of a site event is the\n same `Site` that `ListSites` returns. Requires the `sites:scan` scope."}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth 2.0 client credentials. On the token request, send your `organization_id`\nand this `resource`:\n\n```text\nhttps://public.api.getduranta.com\n```","flows":{"clientCredentials":{"tokenUrl":"https://logto.app.getduranta.com/oidc/token","scopes":{"customers:import":"Create and update customers.","sites:scan":"Submit properties for measurement and read the results."}}}}},"schemas":{"connect.error":{"type":"object","properties":{"code":{"type":"string","examples":["not_found"],"enum":["canceled","unknown","invalid_argument","deadline_exceeded","not_found","already_exists","permission_denied","resource_exhausted","failed_precondition","aborted","out_of_range","unimplemented","internal","unavailable","data_loss","unauthenticated"],"description":"The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]."},"message":{"type":"string","description":"A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client."},"details":{"type":"array","items":{"$ref":"#/components/schemas/connect.error_details.Any"},"description":"A list of messages that carry the error details. There is no limit on the number of messages."}},"title":"Connect Error","additionalProperties":true,"description":"Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation"},"connect.error_details.Any":{"type":"object","properties":{"type":{"type":"string","description":"A URL that acts as a globally unique identifier for the type of the serialized message. For example: `type.googleapis.com/google.rpc.ErrorInfo`."},"value":{"type":"string","format":"byte","description":"The Protobuf message, serialized as bytes and base64-encoded. The specific message type is identified by the `type` field."},"debug":{"type":"object","title":"Debug","additionalProperties":true,"description":"Deserialized error detail payload. The 'type' field indicates the schema. This field is for easier debugging and should not be relied upon for application logic."}},"additionalProperties":true,"description":"Contains an arbitrary serialized message along with a @type that describes the type of the serialized message, with an additional debug field for ConnectRPC error details."},"duranta.api.public.v1.AiModel":{"type":"string","title":"AiModel","enum":["AI_MODEL_AUTO","AI_MODEL_RESIDENTIAL","AI_MODEL_COMMERCIAL_FAST","AI_MODEL_COMMERCIAL_MAKROS"],"description":"The AI model that measures a site, as in the Duranta app's \"AI model\" setting. Numbered like\n data.AiModelType."},"duranta.api.public.v1.CreateParcelSiteRequest":{"type":"object","properties":{"externalId":{"type":"string","description":"Your identifier for the property, as in `CreateSite`. Reuse the `externalId` of a site that\n ended with `PARCEL_AMBIGUOUS`: it is measured on this parcel and keeps its identifier. Any\n other `externalId` that already exists with a different parcel, `aiModel` or\n `propertyBoundary`, or that was created by `CreateSite`, fails with `already_exists`.\nAt most 1024 bytes."},"parcelId":{"type":"string","description":"The `parcelId` from `FindParcels`. An unknown one fails with `not_found`.\nAt most 256 bytes."},"address":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PostalAddress"}],"description":"US street address of the property, stored with the site and shown in the Duranta app. It\n is not looked up again. `line1`, `city`, `region` and `postalCode` are required."},"tier":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.ResultTier"}],"description":"As in `CreateSite`."},"aiModel":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.AiModel"}],"description":"As in `CreateSite`."},"propertyBoundary":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PropertyBoundary"}],"description":"As in `CreateSite`. `PROPERTY_BOUNDARY_ESTIMATED` estimates the service area around this\n parcel."}},"title":"CreateParcelSiteRequest","required":["externalId","parcelId","address","tier"]},"duranta.api.public.v1.CreateSiteRequest":{"type":"object","properties":{"externalId":{"type":"string","description":"Your identifier for the property. It is the key for every later call. Submitting the same\n `externalId` again with the same address returns the current site and does not start a\n second scan, unless the site is `SITE_STATUS_FAILED`, which is scanned again; a changed\n address starts a new one. An `externalId` that already exists with a different `aiModel`,\n `propertyBoundary` or `boundary` fails with `already_exists`; use a new `externalId`.\nAt most 1024 bytes."},"address":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PostalAddress"}],"description":"US street address. `line1`, `city`, `region` and `postalCode` are required."},"tier":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.ResultTier"}],"description":"The results this site includes. Submitting the same `externalId` again with a different\n tier switches the site to that tier; with the same address, this does not start a new\n scan. A tier that is not enabled for your workspace fails with `permission_denied`; contact\n Duranta to enable it."},"aiModel":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.AiModel"}],"description":"The AI model, fixed when the site is created. Leave it out for `AI_MODEL_AUTO`. When the\n `externalId` already exists, leaving it out keeps the site's model, and a different value\n fails with `already_exists`: use a new `externalId` to scan with another model."},"propertyBoundary":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PropertyBoundary"}],"description":"The property boundary, fixed when the site is created. Leave it out for\n `PROPERTY_BOUNDARY_OFFICIAL`. Resubmitting an existing `externalId` works like `aiModel`."},"boundary":{"description":"A custom scan area, fixed when the site is created. A GeoJSON `Polygon` or `MultiPolygon`\n with `[longitude, latitude]` WGS 84 coordinates, the same shape as `boundary` in the\n result. Duranta measures exactly this area instead of the property boundary it looks up\n for the address; the address is still required. Use it for office parks, HOA grounds and\n other multi-parcel sites. The first ring of a polygon is the outer edge and the others are\n holes. A ring that is not closed is closed for you. The area must be larger than zero and\n at most 2 square kilometers (about 494 acres), with at most 5000 vertices in total, and\n rings must not cross themselves. Anything else fails with `invalid_argument`. It cannot be\n combined with `PROPERTY_BOUNDARY_ESTIMATED`. Leave it out to use the property boundary.\n When the `externalId` already exists, leaving it out keeps the site's area, the same\n polygon is accepted, and a different one fails with `already_exists`; use a new\n `externalId` to scan another area. The address of such a site can still be corrected.","oneOf":[{"type":"object","required":["type","coordinates"],"properties":{"type":{"const":"Polygon"},"coordinates":{"type":"array","description":"Rings, each a closed list of [longitude, latitude] positions.","items":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}}}}},{"type":"object","required":["type","coordinates"],"properties":{"type":{"const":"MultiPolygon"},"coordinates":{"type":"array","description":"Polygons, each a list of rings, each ring a closed list of [longitude, latitude] positions.","items":{"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}}}}}}]}},"title":"CreateSiteRequest","required":["externalId","address","tier"]},"duranta.api.public.v1.CreateWebhookEndpointRequest":{"type":"object","properties":{"url":{"type":"string","description":"The HTTPS URL to send events to. It must resolve to a public address. User info and plain\n HTTP are rejected.\nAt most 2048 bytes."},"description":{"type":"string","description":"Your note about what the endpoint is for.\nAt most 256 bytes."}},"title":"CreateWebhookEndpointRequest","required":["url"]},"duranta.api.public.v1.CreateWebhookEndpointResponse":{"type":"object","properties":{"endpoint":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.WebhookEndpoint"}]},"secret":{"type":"string","description":"The signing secret, `whsec_` followed by base64. It is shown only here: store it now. Use it\n to verify the `webhook-signature` header of every event, as described by the Standard Webhooks\n specification."}},"title":"CreateWebhookEndpointResponse"},"duranta.api.public.v1.CustomerKind":{"type":"string","title":"CustomerKind","enum":["CUSTOMER_KIND_RESIDENTIAL","CUSTOMER_KIND_COMMERCIAL"],"description":"Whether the customer is a household (`CUSTOMER_KIND_RESIDENTIAL`) or a business\n (`CUSTOMER_KIND_COMMERCIAL`)."},"duranta.api.public.v1.CustomerRecord":{"type":"object","properties":{"externalId":{"type":"string","description":"Your identifier for the customer. Later records with the same `externalId` update this\n customer.\nAt most 1024 bytes."},"givenName":{"type":"string","description":"At most 256 bytes."},"familyName":{"type":"string","description":"At most 256 bytes."},"companyName":{"type":"string","description":"Required when `kind` is `CUSTOMER_KIND_COMMERCIAL` and must be empty when it is\n `CUSTOMER_KIND_RESIDENTIAL`. Otherwise the record is rejected with `VALIDATION_FAILED`.\nAt most 512 bytes."},"email":{"type":"string","description":"At most 320 bytes."},"phone":{"type":"string","description":"At most 64 bytes."},"address":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PostalAddress"}]},"sourceRevision":{"type":["string","null"],"description":"Your version of this record, such as an update timestamp or ETag from your system. Duranta\n only compares it for equality. Once a customer has one stored, a record without it is\n rejected with `SOURCE_REVISION_REQUIRED`, and a stored one sent with different data is\n rejected with `SOURCE_REVISION_REUSED`.\nAt most 1024 bytes."},"kind":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.CustomerKind"}],"not":{"enum":[]},"description":"Required on every record, updates included. A `kind` that differs from the stored one is\n rejected with `KIND_CONFLICT`; it is never changed silently."}},"title":"CustomerRecord","required":["externalId"],"description":"One customer from your system. On update, an empty `givenName`, `familyName`, `email` or\n `phone` keeps the stored value. Sending `address` replaces the whole stored address; leaving\n it out keeps it."},"duranta.api.public.v1.CustomerUpsertOutcome":{"type":"string","title":"CustomerUpsertOutcome","enum":["CUSTOMER_UPSERT_OUTCOME_CREATED","CUSTOMER_UPSERT_OUTCOME_UPDATED","CUSTOMER_UPSERT_OUTCOME_UNCHANGED","CUSTOMER_UPSERT_OUTCOME_FAILED"],"description":"What the upsert did: `CUSTOMER_UPSERT_OUTCOME_CREATED`, `CUSTOMER_UPSERT_OUTCOME_UPDATED`,\n `CUSTOMER_UPSERT_OUTCOME_UNCHANGED` (the record matches what is stored), or\n `CUSTOMER_UPSERT_OUTCOME_FAILED` (the record was rejected, and `error` says why)."},"duranta.api.public.v1.CustomerUpsertResult":{"type":"object","properties":{"externalId":{"type":"string","description":"The `externalId` of the record you sent."},"customer":{"type":"string","description":"The customer's resource name, such as `customers/{id}`. Empty when the record was rejected."},"outcome":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.CustomerUpsertOutcome"}]},"serverRevision":{"type":"string","format":"int64","description":"Duranta's revision of the customer after this upsert. It only increases. Not set when the\n record was rejected."},"error":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.ItemError"}],"description":"Why the record was rejected. Set only when `outcome` is `CUSTOMER_UPSERT_OUTCOME_FAILED`."}},"title":"CustomerUpsertResult","description":"The outcome of one upsert. It reports what happened, never the stored customer data."},"duranta.api.public.v1.DeleteWebhookEndpointRequest":{"type":"object","properties":{"id":{"type":"string","description":"The `id` of the endpoint.\nAt most 64 bytes."}},"title":"DeleteWebhookEndpointRequest","required":["id"]},"duranta.api.public.v1.DeleteWebhookEndpointResponse":{"type":"object","title":"DeleteWebhookEndpointResponse"},"duranta.api.public.v1.FindParcelsRequest":{"type":"object","properties":{"address":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PostalAddress"}],"description":"US street address. `line1`, `city`, `region` and `postalCode` are required."}},"title":"FindParcelsRequest","required":["address"]},"duranta.api.public.v1.FindParcelsResponse":{"type":"object","properties":{"parcels":{"type":"array","items":{"$ref":"#/components/schemas/duranta.api.public.v1.Parcel"},"description":"The parcels the address may be on, most likely first. Empty when the address does not\n resolve to a parcel. More than one means the address lookup services disagree: pick the\n right parcel, for example by its location, and pass its `parcelId` to `CreateParcelSite`."}},"title":"FindParcelsResponse"},"duranta.api.public.v1.GetSiteRequest":{"type":"object","properties":{"externalId":{"type":"string","description":"The `externalId` you submitted.\nAt most 1024 bytes."}},"title":"GetSiteRequest","required":["externalId"]},"duranta.api.public.v1.ItemError":{"type":"object","properties":{"code":{"type":"string","description":"A stable value to branch on. For customers: `SOURCE_REVISION_REUSED`,\n `SOURCE_REVISION_REQUIRED`, `VALIDATION_FAILED`, `LIFECYCLE_CONFLICT` or `KIND_CONFLICT`.\n For sites, see `error` on the site."},"message":{"type":"string","description":"A readable explanation, for people rather than for parsing."}},"title":"ItemError","description":"Why a record was rejected."},"duranta.api.public.v1.LatLng":{"type":"object","properties":{"latitude":{"type":"number","format":"double","description":"Decimal degrees, WGS 84."},"longitude":{"type":"number","format":"double","description":"Decimal degrees, WGS 84."}},"title":"LatLng","description":"A point on the map."},"duranta.api.public.v1.ListSitesRequest":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.SiteStatus"}],"description":"Only sites in this status. Leave it out to list sites in every status."},"pageSize":{"type":"integer","maximum":100,"minimum":0,"format":"int32","description":"Up to 100 sites per page, 50 when not set."},"pageToken":{"type":"string","description":"The `nextPageToken` from the previous page.\nAt most 1024 bytes."},"updatedSince":{"allOf":[{"$ref":"#/components/schemas/google.protobuf.Timestamp"}],"description":"Only sites changed after this time, compared to `updatedAt`. Leave it out for all sites."},"orderBy":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.SiteOrder"}],"description":"Leave it out for `SITE_ORDER_SUBMITTED_DESC`. Send the same `orderBy` with every\n `pageToken` of one listing."}},"title":"ListSitesRequest"},"duranta.api.public.v1.ListSitesResponse":{"type":"object","properties":{"sites":{"type":"array","items":{"$ref":"#/components/schemas/duranta.api.public.v1.Site"},"description":"In the order of `orderBy`, without polygons or images. Use `GetSite` for those."},"nextPageToken":{"type":"string","description":"Pass as `pageToken` to get the next page. Empty on the last page."}},"title":"ListSitesResponse"},"duranta.api.public.v1.ListWebhookDeliveriesRequest":{"type":"object","properties":{"endpointId":{"type":"string","description":"The `id` of the endpoint.\nAt most 64 bytes."},"pageSize":{"type":"integer","maximum":100,"minimum":0,"format":"int32","description":"Up to 100 deliveries per page, 50 when not set."},"pageToken":{"type":"string","description":"The `nextPageToken` from the previous page.\nAt most 1024 bytes."}},"title":"ListWebhookDeliveriesRequest","required":["endpointId"]},"duranta.api.public.v1.ListWebhookDeliveriesResponse":{"type":"object","properties":{"deliveries":{"type":"array","items":{"$ref":"#/components/schemas/duranta.api.public.v1.WebhookDelivery"},"description":"Newest first. Deliveries are kept for 30 days."},"nextPageToken":{"type":"string","description":"Pass as `pageToken` to get the next page. Empty on the last page."}},"title":"ListWebhookDeliveriesResponse"},"duranta.api.public.v1.ListWebhookEndpointsRequest":{"type":"object","title":"ListWebhookEndpointsRequest"},"duranta.api.public.v1.ListWebhookEndpointsResponse":{"type":"object","properties":{"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/duranta.api.public.v1.WebhookEndpoint"}}},"title":"ListWebhookEndpointsResponse"},"duranta.api.public.v1.Parcel":{"type":"object","properties":{"parcelId":{"type":"string","description":"Duranta's identifier for the parcel. Pass it to `CreateParcelSite` to measure this parcel."},"location":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.LatLng"}],"description":"A point inside the parcel."},"areaSqM":{"type":"number","format":"double","description":"Area of the parcel, in square meters."}},"title":"Parcel","description":"A parcel an address may be on."},"duranta.api.public.v1.PostalAddress":{"type":"object","properties":{"line1":{"type":"string","description":"Street address.\nAt most 1024 bytes."},"line2":{"type":"string","description":"Apartment, suite or unit.\nAt most 1024 bytes."},"city":{"type":"string","description":"At most 256 bytes."},"region":{"type":"string","description":"State, province or region: an ISO 3166-2 subdivision code such as `WI`, or its name.\nAt most 128 bytes."},"postalCode":{"type":"string","description":"ZIP or postal code.\nAt most 64 bytes."},"country":{"type":"string","description":"ISO 3166-1 country code such as `US`, or its name.\nAt most 128 bytes."}},"title":"PostalAddress","description":"A postal address."},"duranta.api.public.v1.PropertyBoundary":{"type":"string","title":"PropertyBoundary","enum":["PROPERTY_BOUNDARY_OFFICIAL","PROPERTY_BOUNDARY_ESTIMATED"],"description":"The limits Aidan measures within, as in the Duranta app's \"Property boundary\" setting.\n Numbered like data.PropertyBoundaryMode."},"duranta.api.public.v1.ResultTier":{"type":"string","title":"ResultTier","enum":["RESULT_TIER_IMAGE","RESULT_TIER_IMAGE_AND_SEGMENTS","RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK"],"description":"The results a site includes, chosen in `CreateSite`. Each tier includes everything in the\n tiers below it, and tiers will be priced differently. `RESULT_TIER_IMAGE` is available to every\n workspace; Duranta enables the higher tiers per workspace."},"duranta.api.public.v1.SendTestEventRequest":{"type":"object","properties":{"endpointId":{"type":"string","description":"The `id` of the endpoint.\nAt most 64 bytes."}},"title":"SendTestEventRequest","required":["endpointId"]},"duranta.api.public.v1.SendTestEventResponse":{"type":"object","properties":{"eventId":{"type":"string","description":"The `eventId` of the delivery. Find it in `ListWebhookDeliveries`."}},"title":"SendTestEventResponse"},"duranta.api.public.v1.Site":{"type":"object","properties":{"externalId":{"type":"string","description":"Your identifier for the property, as you submitted it."},"address":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PostalAddress"}],"description":"The address as you submitted it."},"status":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.SiteStatus"}],"description":"Where the site is in measurement."},"error":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.ItemError"}],"description":"Set when `status` is `SITE_STATUS_ISSUE` or `SITE_STATUS_FAILED`. `code` is one of\n `ADDRESS_NOT_FOUND` (the address does not resolve to a location), `PARCEL_AMBIGUOUS` (the\n address lookup services place the address on different parcels with no majority; use\n `FindParcels` and `CreateParcelSite`), `PARCEL_NOT_FOUND` (no parcel at the location),\n `INSUFFICIENT_CREDITS` (the credit balance is below zero; send the site again once credits\n are added), or `SCAN_FAILED` (the scan could not produce measurements)."},"appUrl":{"type":"string","description":"Link to the property in the Duranta app, for a person to review or correct it.\n Requires a Duranta login to open."},"location":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.LatLng"}],"description":"Geocoded point for the address."},"parcelAreaSqFt":{"type":"number","format":"double","description":"Area of the parcel boundary, in square feet."},"surfaces":{"type":"array","items":{"$ref":"#/components/schemas/duranta.api.public.v1.SurfaceArea"},"description":"Every surface type the scan reports. Tree and shrub canopy overlap the surfaces beneath\n them, so the areas can sum to more than the parcel. Set from\n `RESULT_TIER_IMAGE_AND_SEGMENTS` up."},"boundary":{"description":"The parcel outline the scan was clipped to, as a GeoJSON MultiPolygon. Set by `GetSite`\n from `RESULT_TIER_IMAGE_AND_SEGMENTS` up.","type":"object","required":["type","coordinates"],"properties":{"type":{"const":"MultiPolygon"},"coordinates":{"type":"array","description":"Polygons, each a list of rings, each ring a closed list of [longitude, latitude] positions.","items":{"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}}}}}},"image":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.SiteImage"}],"description":"The measurement map. Set by `GetSite` for every tier, unless the site has no parcel to\n draw."},"submittedAt":{"allOf":[{"$ref":"#/components/schemas/google.protobuf.Timestamp"}],"description":"When you submitted the site."},"tier":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.ResultTier"}],"description":"The tier chosen in `CreateSite`."},"shareUrl":{"type":"string","description":"Read-only public link to the measurement map, no login needed. Anyone with the link can\n open it. Set for `RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK` once the site is completed.\n Moving the site to a lower tier revokes the link."},"aiModel":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.AiModel"}],"description":"`AI_MODEL_AUTO` until the scan picks a model, then the model that ran. Never unspecified."},"propertyBoundary":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.PropertyBoundary"}],"description":"The property boundary the site was created with. Never unspecified."},"updatedAt":{"allOf":[{"$ref":"#/components/schemas/google.protobuf.Timestamp"}],"description":"When the site last changed in a way you can see: a scan result, a status change, a tier\n change, or a correction made in the Duranta app."},"revision":{"type":"string","format":"int64","description":"Starts at 1 and increases on every change that moves `updatedAt`. Compare it to tell\n whether a site changed since you last read it."}},"title":"Site","description":"A property submitted for measurement. Measurement fields are set only when `status` is\n `SITE_STATUS_COMPLETED`, and only those that `tier` includes."},"duranta.api.public.v1.SiteImage":{"type":"object","properties":{"contentType":{"type":"string","description":"MIME type, such as `image/jpeg`."},"data":{"type":"string","format":"byte","description":"The aerial photo with the measured surfaces and the parcel outline drawn over it, as a\n base64 string."}},"title":"SiteImage","description":"The measurement map."},"duranta.api.public.v1.SiteOrder":{"type":"string","title":"SiteOrder","enum":["SITE_ORDER_SUBMITTED_DESC","SITE_ORDER_UPDATED_ASC"],"description":"The order `ListSites` returns sites in."},"duranta.api.public.v1.SiteStatus":{"type":"string","title":"SiteStatus","enum":["SITE_STATUS_ACCEPTED","SITE_STATUS_ISSUE","SITE_STATUS_COMPLETED","SITE_STATUS_FAILED"],"description":"Where a site is in measurement: `SITE_STATUS_ACCEPTED` (queued or being measured),\n `SITE_STATUS_ISSUE` (the address or parcel could not be used, and `error` says why),\n `SITE_STATUS_COMPLETED` (measurements are set), or `SITE_STATUS_FAILED` (the scan could not\n produce measurements, and `error` says why)."},"duranta.api.public.v1.SurfaceArea":{"type":"object","properties":{"type":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.SurfaceType"}],"description":"The surface class."},"areaSqFt":{"type":"number","format":"double","description":"Area in square feet."},"geometry":{"description":"Every polygon of this type as one GeoJSON MultiPolygon with [longitude, latitude]\n coordinates (WGS 84). Set only by `GetSite`.","type":"object","required":["type","coordinates"],"properties":{"type":{"const":"MultiPolygon"},"coordinates":{"type":"array","description":"Polygons, each a list of rings, each ring a closed list of [longitude, latitude] positions.","items":{"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}}}}}},"perimeterFt":{"type":"number","format":"double","description":"Total outline length of every polygon of this type, holes included, in feet. For thin\n surfaces such as fences and hedges this is about twice their length."},"segmentCount":{"type":"integer","description":"How many separate polygons of this type the scan found."},"areaExclTreesSqFt":{"type":["number","null"],"format":"double","description":"Lawn only: the part of `areaSqFt` not under tree canopy, in square feet; unset otherwise."}},"title":"SurfaceArea","description":"The measured area of one surface class."},"duranta.api.public.v1.SurfaceType":{"type":"string","title":"SurfaceType","enum":["SURFACE_TYPE_LAWN","SURFACE_TYPE_BEDS","SURFACE_TYPE_TREES","SURFACE_TYPE_SURFACES","SURFACE_TYPE_POOLS","SURFACE_TYPE_HEDGES","SURFACE_TYPE_BUILDINGS","SURFACE_TYPE_PARKING_LOTS","SURFACE_TYPE_SIDEWALKS","SURFACE_TYPE_GROUND","SURFACE_TYPE_FENCE","SURFACE_TYPE_BUSHES_OR_SHRUBS","SURFACE_TYPE_GAS_STATION_CANOPY","SURFACE_TYPE_CAR_WASH","SURFACE_TYPE_DRIVEWAYS"],"description":"A measured surface class. New values may be added; ignore values you don't recognize."},"duranta.api.public.v1.UpsertCustomerRequest":{"type":"object","properties":{"record":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.CustomerRecord"}],"description":"The customer to create or update."},"idempotencyKey":{"type":"string","description":"A unique key for this call, such as a UUID. Retrying with the same key and the same record\n returns the original response, with nothing written twice. Reusing a key with a different\n request fails with `already_exists`.\nAt most 512 bytes."}},"title":"UpsertCustomerRequest","required":["record","idempotencyKey"]},"duranta.api.public.v1.UpsertCustomerResponse":{"type":"object","properties":{"result":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.CustomerUpsertResult"}],"description":"The outcome for the record."}},"title":"UpsertCustomerResponse"},"duranta.api.public.v1.WebhookDelivery":{"type":"object","properties":{"eventId":{"type":"string","description":"The event id, sent as the `webhook-id` header and as `id` in the body. It stays the same\n across retries: use it to ignore events you already handled."},"eventType":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.WebhookEventType"}]},"status":{"allOf":[{"$ref":"#/components/schemas/duranta.api.public.v1.WebhookDeliveryStatus"}]},"attempts":{"type":"integer","format":"int32","description":"How many times Duranta has called your URL for this event."},"lastHttpStatus":{"type":"integer","format":"int32","description":"The HTTP status of the latest attempt. Zero when your server could not be reached."},"lastError":{"type":"string","description":"Why the latest attempt could not reach your server, for example a timeout. Empty otherwise."},"createdAt":{"allOf":[{"$ref":"#/components/schemas/google.protobuf.Timestamp"}],"description":"When Duranta created the event."},"finishedAt":{"allOf":[{"$ref":"#/components/schemas/google.protobuf.Timestamp"}],"description":"When the delivery was delivered or Duranta gave up. Not set while pending."}},"title":"WebhookDelivery","description":"One event sent to one endpoint, with the outcome of the latest attempt."},"duranta.api.public.v1.WebhookDeliveryStatus":{"type":"string","title":"WebhookDeliveryStatus","enum":["WEBHOOK_DELIVERY_STATUS_PENDING","WEBHOOK_DELIVERY_STATUS_DELIVERED","WEBHOOK_DELIVERY_STATUS_FAILED"],"description":"Where a delivery is: `WEBHOOK_DELIVERY_STATUS_PENDING` (not delivered yet, more attempts will\n follow), `WEBHOOK_DELIVERY_STATUS_DELIVERED` (your server answered with a 2xx status), or\n `WEBHOOK_DELIVERY_STATUS_FAILED` (every attempt failed, or the endpoint was disabled)."},"duranta.api.public.v1.WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string","description":"Identifies the endpoint in `DeleteWebhookEndpoint`, `SendTestEvent` and `ListWebhookDeliveries`."},"url":{"type":"string","description":"The HTTPS URL events are sent to."},"description":{"type":"string","description":"Your note about what the endpoint is for."},"createdAt":{"allOf":[{"$ref":"#/components/schemas/google.protobuf.Timestamp"}],"description":"When you created the endpoint."},"disabledAt":{"allOf":[{"$ref":"#/components/schemas/google.protobuf.Timestamp"}],"description":"Set when Duranta stopped sending events to the endpoint. Create a new endpoint to receive events again."},"disabledReason":{"type":"string","description":"Why the endpoint was disabled: `gone` (your server answered 410) or `failing` (every delivery\n failed for more than 5 days)."}},"title":"WebhookEndpoint","description":"A URL on your side that Duranta calls when something happens, so you do not have to poll."},"duranta.api.public.v1.WebhookEventType":{"type":"string","title":"WebhookEventType","enum":["WEBHOOK_EVENT_TYPE_SITE_STATUS_CHANGE","WEBHOOK_EVENT_TYPE_TEST","WEBHOOK_EVENT_TYPE_SITE_VERIFIED"],"description":"What an event is about, sent as `type` in the body."},"google.protobuf.Timestamp":{"type":"string","examples":["2023-01-15T01:30:15.01Z","2024-12-25T12:00:00Z"],"format":"date-time","description":"A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC."}}},"paths":{"/duranta.api.public.v1.CustomerService/UpsertCustomer":{"post":{"tags":["CustomerService"],"summary":"Upsert a customer","description":"Create or update one customer by your `externalId`. A retry with the same\n `idempotencyKey` replays the stored response.","operationId":"CustomerService_UpsertCustomer","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.UpsertCustomerRequest"},"example":{"record":{"externalId":"crm-48213","kind":"CUSTOMER_KIND_COMMERCIAL","companyName":"Lakeside Office Park","givenName":"Dana","familyName":"Ortiz","email":"dana.ortiz@example.com","phone":"+1 715 555 0142","address":{"line1":"2910 Mall Dr","city":"Eau Claire","region":"WI","postalCode":"54701","country":"US"},"sourceRevision":"2026-06-05T17:30:00Z"},"idempotencyKey":"6f1c2a1e-6d4b-4b8e-9a51-0c3f2d7e9b10"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.UpsertCustomerResponse"},"examples":{"Created":{"summary":"Created","value":{"result":{"externalId":"crm-48213","customer":"customers/t0a1b2c3d4e5f6i","outcome":"CUSTOMER_UPSERT_OUTCOME_CREATED","serverRevision":"1"}}},"Rejected":{"summary":"Rejected","value":{"result":{"externalId":"crm-48213","outcome":"CUSTOMER_UPSERT_OUTCOME_FAILED","error":{"code":"KIND_CONFLICT","message":"customer kind conflicts with the existing customer"}}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.SiteService/CreateParcelSite":{"post":{"tags":["SiteService"],"summary":"Create a parcel site","description":"Measure exactly the parcel you choose from `FindParcels`, instead of the one Duranta picks\n from the address. Pass the `externalId` of a site that ended with `PARCEL_AMBIGUOUS` to\n measure it on this parcel. Otherwise works like `CreateSite`; read the result with\n `GetSite` or `ListSites`. See [Choosing the parcel](/parcels/).","operationId":"SiteService_CreateParcelSite","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.CreateParcelSiteRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.Site"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.SiteService/CreateSite":{"post":{"tags":["SiteService"],"summary":"Create a site","description":"Submit one property for measurement. Duranta looks the address up with several services\n and measures the parcel most of them place it on. When they disagree with no majority, the\n site gets `PARCEL_AMBIGUOUS` and is not measured or charged: choose the parcel with\n `FindParcels` and `CreateParcelSite`, see [Choosing the parcel](/parcels/).","operationId":"SiteService_CreateSite","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.CreateSiteRequest"},"example":{"externalId":"PROP-000001","address":{"line1":"2910 Mall Dr","city":"Eau Claire","region":"WI","postalCode":"54701","country":"US"},"tier":"RESULT_TIER_IMAGE"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.Site"},"examples":{"Accepted":{"summary":"Accepted","value":{"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"}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.SiteService/FindParcels":{"post":{"tags":["SiteService"],"summary":"Find parcels","description":"List the parcels an address may be on, most likely first, so you can choose the one to\n measure: use it after a site ends with `PARCEL_AMBIGUOUS`, or before `CreateParcelSite` to\n confirm the parcel up front. Measures nothing and creates no site. Returns a point inside\n each parcel and its area, not its boundary. See [Choosing the parcel](/parcels/).","operationId":"SiteService_FindParcels","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.FindParcelsRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.FindParcelsResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.SiteService/GetSite":{"post":{"tags":["SiteService"],"summary":"Get a site","description":"Get one site by your `externalId`.","operationId":"SiteService_GetSite","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.GetSiteRequest"},"example":{"externalId":"PROP-000001"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.Site"},"examples":{"Still running":{"summary":"Still running","value":{"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"}},"Address issue":{"summary":"Address issue","value":{"externalId":"PROP-000077","address":{"line1":"1 Nowhere Rd","city":"Eau Claire","region":"WI","postalCode":"54701","country":"US"},"appUrl":"https://app.getduranta.com/...","status":"SITE_STATUS_ISSUE","error":{"code":"ADDRESS_NOT_FOUND","message":"The address does not resolve to a location."},"submittedAt":"2026-06-05T17:39:03Z","updatedAt":"2026-06-05T17:39:03Z","revision":"1","tier":"RESULT_TIER_IMAGE"}},"Image":{"summary":"Image","value":{"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_COMPLETED","location":{"latitude":44.788607,"longitude":-91.462058},"parcelAreaSqFt":92417,"tier":"RESULT_TIER_IMAGE","image":{"contentType":"image/jpeg","data":"/9j/4AAQSkZJRgABAQ... (base64)"}}},"Image and segments":{"summary":"Image and segments","value":{"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_COMPLETED","location":{"latitude":44.788607,"longitude":-91.462058},"parcelAreaSqFt":92417,"tier":"RESULT_TIER_IMAGE_AND_SEGMENTS","surfaces":[{"type":"SURFACE_TYPE_LAWN","areaSqFt":46745,"perimeterFt":1874,"segmentCount":3,"geometry":{"type":"MultiPolygon","coordinates":[[[[-91.4621,44.78855],[-91.46198,44.78855],[-91.46198,44.78866],[-91.4621,44.78866],[-91.4621,44.78855]]]]}},{"type":"SURFACE_TYPE_BUILDINGS","areaSqFt":6077,"perimeterFt":412,"segmentCount":2,"geometry":{"type":"MultiPolygon","coordinates":[[[[-91.4621,44.78855],[-91.46198,44.78855],[-91.46198,44.78866],[-91.4621,44.78866],[-91.4621,44.78855]]]]}}],"boundary":{"type":"MultiPolygon","coordinates":[[[[-91.4621,44.78855],[-91.46198,44.78855],[-91.46198,44.78866],[-91.4621,44.78866],[-91.4621,44.78855]]]]},"image":{"contentType":"image/jpeg","data":"/9j/4AAQSkZJRgABAQ... (base64)"}}},"Image, segments and share link":{"summary":"Image, segments and share link","value":{"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_COMPLETED","location":{"latitude":44.788607,"longitude":-91.462058},"parcelAreaSqFt":92417,"tier":"RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK","surfaces":[{"type":"SURFACE_TYPE_LAWN","areaSqFt":46745,"perimeterFt":1874,"segmentCount":3,"geometry":{"type":"MultiPolygon","coordinates":[[[[-91.4621,44.78855],[-91.46198,44.78855],[-91.46198,44.78866],[-91.4621,44.78866],[-91.4621,44.78855]]]]}},{"type":"SURFACE_TYPE_BUILDINGS","areaSqFt":6077,"perimeterFt":412,"segmentCount":2,"geometry":{"type":"MultiPolygon","coordinates":[[[[-91.4621,44.78855],[-91.46198,44.78855],[-91.46198,44.78866],[-91.4621,44.78866],[-91.4621,44.78855]]]]}}],"boundary":{"type":"MultiPolygon","coordinates":[[[[-91.4621,44.78855],[-91.46198,44.78855],[-91.46198,44.78866],[-91.4621,44.78866],[-91.4621,44.78855]]]]},"image":{"contentType":"image/jpeg","data":"/9j/4AAQSkZJRgABAQ... (base64)"},"shareUrl":"https://app.getduranta.com/a/scanner/share/k3J9xQ2mWvi"}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.SiteService/ListSites":{"post":{"tags":["SiteService"],"summary":"List sites","description":"List sites, for example every site with an issue.","operationId":"SiteService_ListSites","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.ListSitesRequest"},"example":{"status":"SITE_STATUS_COMPLETED","pageSize":50,"updatedSince":"2026-06-05T17:00:00Z","orderBy":"SITE_ORDER_UPDATED_ASC"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.ListSitesResponse"},"examples":{"First page":{"summary":"First page","value":{"sites":[{"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_COMPLETED","location":{"latitude":44.788607,"longitude":-91.462058},"parcelAreaSqFt":92417,"surfaces":[{"type":"SURFACE_TYPE_LAWN","areaSqFt":46745,"perimeterFt":1874,"segmentCount":3},{"type":"SURFACE_TYPE_BEDS","areaSqFt":3219,"perimeterFt":986,"segmentCount":7},{"type":"SURFACE_TYPE_TREES","areaSqFt":16693,"perimeterFt":2140,"segmentCount":12},{"type":"SURFACE_TYPE_BUILDINGS","areaSqFt":6077,"perimeterFt":412,"segmentCount":2}],"tier":"RESULT_TIER_IMAGE_AND_SEGMENTS"}],"nextPageToken":"eyJvIjo1MH0"}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.WebhookService/CreateWebhookEndpoint":{"post":{"tags":["WebhookService"],"summary":"Create a webhook endpoint","description":"Register a URL. Up to 10 endpoints per workspace.","operationId":"WebhookService_CreateWebhookEndpoint","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.CreateWebhookEndpointRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.CreateWebhookEndpointResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.WebhookService/DeleteWebhookEndpoint":{"post":{"tags":["WebhookService"],"summary":"Delete a webhook endpoint","description":"Delete an endpoint and its delivery history.","operationId":"WebhookService_DeleteWebhookEndpoint","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.DeleteWebhookEndpointRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.DeleteWebhookEndpointResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.WebhookService/ListWebhookDeliveries":{"post":{"tags":["WebhookService"],"summary":"List webhook deliveries","description":"List the recent deliveries of an endpoint and how each attempt went.","operationId":"WebhookService_ListWebhookDeliveries","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.ListWebhookDeliveriesRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.ListWebhookDeliveriesResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.WebhookService/ListWebhookEndpoints":{"post":{"tags":["WebhookService"],"summary":"List webhook endpoints","description":"List your endpoints.","operationId":"WebhookService_ListWebhookEndpoints","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.ListWebhookEndpointsRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.ListWebhookEndpointsResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}},"/duranta.api.public.v1.WebhookService/SendTestEvent":{"post":{"tags":["WebhookService"],"summary":"Send a test event","description":"Send a `WEBHOOK_EVENT_TYPE_TEST` event with a sample site to an endpoint, to check your receiver and\n signature verification.","operationId":"WebhookService_SendTestEvent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.SendTestEventRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duranta.api.public.v1.SendTestEventResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/connect.error"}}}}}}}}}