---
title: "Preview tax for a given plan + address + optional tax ID"
method: POST
path: "/api/workspaces/{workspaceId}/billing/tax-preview"
tags: ["Billing"]
---

# Preview tax for a given plan + address + optional tax ID

`POST /api/workspaces/{workspaceId}/billing/tax-preview`

## Request

- Base URL: `https://hiveship.app/api`
- URL: `https://hiveship.app/api/api/workspaces/{workspaceId}/billing/tax-preview`
- Auth: API key in cookie `hiveship_access`

Called on every Address Element change to drive the live total row in the upgrade dialog. Idempotent; no charge.

## Path parameters

- `workspaceId` string, required

## Response `200`

Tax preview (subtotal, tax, total, breakdown)

---

[API](https://skmtc.dev/hiveship/apis/hiveship-api.md) · [All operations](https://skmtc.dev/hiveship/apis/hiveship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hiveship/apis/hiveship-api/revisions/73d3e26544e4?raw)