canonical: https://jentic.com/apis/salestaxcalculatorapi.com/salestaxcalculatorapi

# Sales Tax Calculator API

The Sales Tax Calculator API calculates sales tax, VAT, and GST for a sale from its seller, customer, ship-from and ship-to addresses, and line items, returning tax, totals, and a per-line explanation. Every calculation response carries an outcome such as calculated, not_taxable, exempt, or review_required that tells you whether the amounts can be used. A saved calculation can be finalised as a transaction and later corrected with adjustments, many calculations can be submitted as a batch, and a coverage check confirms whether a country, state, tax code, and transaction type are supported. The API does not provide legal advice.

## For AI agents

Calculate sales tax, VAT, or GST for a checkout or subscription charge, check the outcome, finalise it as a transaction, and record refunds or corrections as adjustments.

## Scope

Does not file tax returns, register you for tax, or give legal advice. Use for calculating and recording sales tax, VAT, and GST only.

## Capabilities

- Calculate sales tax, VAT, or GST for a sale from seller, customer, ship_to, and line items, with exclusive or inclusive tax_behavior
- Tag the billing_event, such as one_time_charge, subscription_renewal, metered_usage, or proration, so the right rules apply
- Read the outcome on each calculation and line, including not_obligated, reverse_charge_or_self_assess, and review_required
- Finalise a calculation as a transaction with its calculation_id and your own reference
- Record adjustments against a transaction with a reason and lines for refunds or corrections
- Submit many calculations at once as a calculation batch and retrieve the batch results
- Check coverage for a country, optional state, tax_code, and transaction_type before calculating

## Use cases

### AI agent checkout tax step

An AI agent building a quote or checkout needs a tax figure it can trust or flag. Through Jentic the agent searches for 'calculate sales tax', loads createCalculation with its input schema, and sends currency, tax_behavior, billing_event, seller, customer, and lines with a fresh Idempotency-Key while the bearer key is injected at call time. It reads the outcome before quoting the total, and escalates when the outcome is review_required.

Example prompt: POST `/v1/calculations` for a 100.00 CAD one_time_charge with exclusive tax_behavior and one line, then report tax and total only if outcome is calculated

### Subscription billing tax

SaaS billing has to tax trials, renewals, proration, and metered usage differently. The calculation request takes a billing_event such as subscription_start, subscription_renewal, metered_usage, free_trial, or proration, so a billing system can price each invoice line correctly and save it as a transaction once charged.

Example prompt: Calculate tax for a subscription_renewal line, then POST `/v1/transactions` with the calculation_id and an invoice reference

### Refunds and corrections

When an order is partially refunded, the tax record has to change with it. POST `/v1/transactions/{transaction_id}/adjustments` records a correction with a required reference, reason, and lines, and the adjustments list gives an audit trail of every change to the finalised transaction.

Example prompt: Create an adjustment on a transaction for a refunded line with a reason and reference, then list adjustments to confirm it was recorded

### Coverage check before launch

Before selling into a new market, a team needs to know whether the API covers it. GET `/v1/coverage` takes a required country, tax_code, and transaction_type, plus optional state, customer_type, and date, and answers whether calculations there are supported.

Example prompt: Call GET `/v1/coverage` for country AU with a tax_code, transaction_type sale, and customer_type consumer, and report whether it is supported

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/v1/calculations` | Create a sales tax calculation |
| GET | `/v1/calculations/{calculation_id}` | Retrieve a calculation |
| POST | `/v1/transactions` | Create a transaction |
| POST | `/v1/transactions/{transaction_id}/adjustments` | Create an adjustment |
| POST | `/v1/calculation-batches` | Create a calculation batch |
| GET | `/v1/coverage` | Check coverage |

## Key resources

- **Calculations** — Create and retrieve sales tax, VAT, and GST calculations with outcomes and per-line explanations
- **Transactions** — Finalise calculations as transactions and record or list adjustments
- **Batches** — Submit and retrieve calculation batches
- **Coverage** — Check support for a country, state, tax code, and transaction type

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 78 / 100
- **Maturity:** AI-Ready
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 70 / 100
  - AI-Readiness & Agent Experience: 79 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 76 / 100
- **View full report:** https://jentic.com/apis/salestaxcalculatorapi.com/salestaxcalculatorapi/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Sales Tax Calculator by hand means sending a bearer stca_ key, generating an Idempotency-Key for each create call, and branching on the outcome before trusting the amounts. Through Jentic you install once, import the API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The API puts transaction_id and calculation_id in the URL path, so a rule can pin your agent to the adjustments of one transaction and the operations you pick. You choose the operations it may call, so record-changing ones like creating transactions or adjustments are not included unless you add them.
- **Credential handling:** Your Sales Tax Calculator API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'calculate sales tax' or 'record a refund adjustment', and Jentic returns the matching operation with its input schema, including required headers like Idempotency-Key.

## Related APIs

- **Avalara** — Tax calculation and compliance platform
- **TaxJar** — Sales tax rates, calculations, and reporting
- **Quaderno** — Tax calculation and invoicing for online sellers
- **Recurly** — Subscription billing platform that issues the invoices being taxed

## FAQ

### What authentication does the Sales Tax Calculator API use?

Per its OpenAPI spec, the Sales Tax Calculator API uses bearer authentication with a server-side API key prefixed stca_, sent in the Authorization header. The spec warns never to embed the secret key in browser or mobile code. Through Jentic the key is held by your own instance and injected at call time.

### Why does the Sales Tax Calculator API require an Idempotency-Key?

The create operations for calculations, transactions, adjustments, and batches take a required Idempotency-Key header. Reusing a key with the same request returns the original result, so retries never double-record, while reusing it with different content returns a conflict.

### What does the outcome field mean in a calculation response?

Each calculation and line carries an outcome, with values including calculated, not_taxable, not_obligated, reverse_charge_or_self_assess, exempt, no_general_tax, review_required, and unsupported. Check it before using the returned amounts: only calculated means tax was computed for the sale.

### What are the rate limits for the Sales Tax Calculator API?

The OpenAPI spec does not state numeric rate limits. Check the documentation at https://www.salestaxcalculatorapi.com for current limits, and use calculation batches for high volumes.

### Is there a Sales Tax Calculator MCP server?

You don't need an MCP server to give your agent the Sales Tax Calculator API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls the calculation and transaction operations it needs, found by intent.

### How do I calculate sales tax through Jentic?

Search Jentic for 'calculate sales tax', load createCalculation, and execute POST `/v1/calculations` with currency, tax_behavior, billing_event, seller, customer, lines, and an Idempotency-Key header. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Can I limit what my agent is allowed to do with the Sales Tax Calculator API?

Yes. For a quoting agent, write a rule that allows createCalculation and getCalculation only, so it can price tax on quotes but cannot finalise transactions or record adjustments that change your tax records. Each call it makes is logged.
