Billing
What the API charges for, when a charge happens, how its amount is calculated, and where to see your usage.
API usage is paid in credits, a prepaid unit held in your workspace's balance. This page describes how charges work. The rates are set in your price list or agreement and are not listed here.
What is charged
You are charged for one thing: a site measurement that completes, that is, a site created with Create a site or Create a parcel site reaching SITE_STATUS_COMPLETED. The API reference also calls a measurement a scan.
Every other call is free: Get a site, List sites, Find parcels, Upsert a customer, webhook endpoint management, and webhook deliveries.
When a site is charged
Each measurement that completes is charged once. A site is charged again only when it is measured again, as described below. A site that ends with SITE_STATUS_ISSUE or SITE_STATUS_FAILED produced no measurement and is not charged.
A changed address is measured again
Sending an existing externalId with a different address, even if only its spelling or formatting changed (for example Lane and Ln), measures the site again and is charged again. Store the address exactly as you sent it and resend it unchanged.
| Situation | Result |
|---|---|
Same externalId, address, aiModel, propertyBoundary, boundary and tier | Nothing is measured. Not charged. |
Same externalId with a different tier | The tier is updated without measuring again. Not charged. |
Same externalId with a different address | The site is measured again. Charged when the measurement completes. |
Same externalId with a different aiModel, propertyBoundary, boundary or parcel | Rejected with already_exists. Not charged. |
A site that ended with SITE_STATUS_FAILED, sent again | The site is measured again. Charged only if the measurement completes. |
A site that ended with SITE_STATUS_ISSUE and PARCEL_AMBIGUOUS, sent with Create a parcel site | The site is measured on the chosen parcel. Charged when the measurement completes. See Choosing the parcel. |
Each externalId is a separate site, so the same address under two identifiers is measured and charged twice. Use one identifier per property.
How the amount is calculated
credits = rate per acre of the AI model × billed acresRate per acre. Each AI model has its own rate: Residential (AI_MODEL_RESIDENTIAL), Commercial - Fast (AI_MODEL_COMMERCIAL_FAST) and Commercial - Makros (AI_MODEL_COMMERCIAL_MAKROS). The site's aiModel shows the model that ran. With AI_MODEL_AUTO, the default, Duranta chooses the model and the rate of the chosen model applies. The result tier does not affect the amount.
Billed acres. The area of the parcel the site was measured on, as returned in the site's parcelAreaSqFt: the parcel Duranta found for the address, the parcel you chose with Create a parcel site, or the custom boundary you sent. With PROPERTY_BOUNDARY_ESTIMATED, the parcel's area is billed, not the larger estimated service area. The area is rounded to the nearest 0.1 acre, with a minimum of 1 acre. One acre is 43,560 sq ft or 4,046.86 m².
| Parcel area | Billed acres | Charge at a rate of R credits per acre |
|---|---|---|
| 0.6 acres | 1.0 | 1.0 × R |
| 1.04 acres | 1.0 | 1.0 × R |
| 2.34 acres | 2.3 | 2.3 × R |
To estimate a charge before measuring, use the areaSqM that Find parcels returns for the parcel. To check a charge afterwards, divide the site's parcelAreaSqFt by 43,560.
A charge uses the price list in effect when the measurement completes, and records the version of that price list.
Usage and balance
Your balance and every charge are listed in the Duranta app under Settings → Billing → Credits. They are not available through the API. A site measurement appears as Bulk site AI run (<model>, <acres>), with the project and site it belongs to. The site ID in that row is the last part of the site's appUrl.
Credits come from your plan's allowance, from credit packs bought on the same page, or from Duranta support.
A measurement starts only while your balance is zero or above. Measurements already in progress complete and are charged even if they take the balance below zero, so a batch submitted at a low balance can end well below zero. While the balance is below zero, new sites end with SITE_STATUS_FAILED and the error code INSUFFICIENT_CREDITS, and are not charged. Do not retry them automatically: send them again once credits are added.
Sandbox
Sites measured in the sandbox are not charged.
Questions about charges
If a charge looks wrong, contact Duranta support with the site's externalId and the date of the charge.