Net Amount Docs

Net Amount turns an address or coordinate pair into a jurisdiction-level sales tax result. These docs are the public home for the API as it moves toward launch.

What is available

• Address lookup with Geocode Earth or Geoapify-backed geocoding.
• Coordinate lookup when you already have latitude and longitude.
• Date-aware lookup with asOfDate for supported 2018+ historical rate data.
• Jurisdiction breakdowns with place IDs, names, tax types, and rates.
• Address validation at /v1/tax/validate-address.
• Calculate API for a narrow U.S. shipped-goods sale/quote slice with line taxable basis, jurisdiction tax, warnings, and rule trace.
• Health metadata for data source and loaded dataset counts.

Local base URL

http://localhost:8787

Production base URL and support contacts will be added before the public API is opened. The /v1/tax/* routes require an API key when billing is enabled.

Quick request

curl --get http://localhost:8787/lookup \
  --data-urlencode "address=200 E Colfax Ave, Denver, CO 80203"

The response includes a normalized geocode result, matching jurisdictions, summed totals by tax type, and timing metadata for observability.

Historical rate dates

Pass asOfDate=YYYY-MM-DD to return rates active on a specific date. The response echoes the value as input.asOfDate.

Historical rate coverage currently starts at 2018-01-01. Dates before 2018 are outside the supported historical dataset and may be incomplete. If you omit the date, the API uses the current date.

Historical (past) rate dates require the Scale plan or above. A date before today returns 403 historical_lookup_requires_plan on lower plans and on keyless requests; current-date lookups work on every plan.

Next

Read the API reference for lookup endpoints and the Calculate API guide for transaction calculation.