Compute tax for an order (TaxJar /v2/taxes compatible)
POST /v1/portability/orders
Drop-in replacement for TaxJar’s POST /v2/taxes. Computes line-by-line tax for an order given ship-from, ship-to, line items, and shipping. Respects the calling account’s nexus profile (managed via /v1/portability/nexus); pass nexus_states in the body to override for a single call.
Sourcing logic (origin- vs destination-based) is per-state and applied automatically. The response includes a per-line tax breakdown plus an order-level summary matching TaxJar’s envelope, with TaxQL-specific advisories under _categories.
Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”Compute total tax for an order with one or more line items.
Mirrors the TaxJar /v2/taxes request envelope so customers
migrating from TaxJar can swap base URLs. Sourcing (which address
the rate is resolved at) is derived from from_* (ship-from)
and to_* (ship-to) plus the calling account’s nexus profile.
object
Ship-from ISO-3166 country code. Only US is supported today; international orders return HTTP 400.
Ship-from state. Two-letter USPS code preferred; full state name accepted and normalised.
Ship-from postal code (5-digit or ZIP+4).
Ship-to ISO-3166 country code. Only US supported.
Ship-to state. Two-letter USPS preferred; full name accepted.
Ship-to postal code (5-digit or ZIP+4).
Shipping & handling charge for the order, in USD. Whether shipping is taxable depends on the destination state’s rules; the response includes freight_taxable: true|false.
Line items in the order. May be empty for a zero-item (quote-only) order; the response then reports zero tax.
A single line item within an order. Quantity × unit_price is the pre-discount taxable subtotal for the line.
object
Free-form line identifier (your own SKU, line number, etc). Echoed back in the per-line response so you can match each computed tax amount to its source line.
Number of units of this product on the line. Must be ≥ 0.
Per-unit price in the order’s currency (USD). Pre-discount, pre-tax. Must be ≥ 0.
Discount applied to this line, subtracted from (quantity × unit_price) before tax. Must be ≥ 0.
Responses
Section titled “ Responses ”Order computed. Returns line-by-line + summary tax breakdown.
object
Invalid input — non-US country, missing state, or malformed line items.
Missing or invalid API key.
Ship-to address could not be resolved.
Validation Error
object
object
object
Monthly quota exceeded.
Upstream geocoder or DoR locator unavailable.