---
title: "Create a new tax quote"
method: POST
path: "/v1/tax/quote"
tags: ["Quote"]
---

# Create a new tax quote

`POST /v1/tax/quote`

The Reach Tax Quote API allows you to request a tax quote based on customers' items and state/country to retrieve a calculated Tax amount due for such an order. See the [Reach Tax Quote API](https://docs.withreach.com/docs/reach-tax-quote-api) for details.

## Request body

- Quote
  - `Id` string, uuid — A unique string generated by Reach to identify the specific tax quote instance.
  - `Currency` string, required — Three-character ISO-4217 currency code.
  - `Reference` string, required — Unique reference provided by supplier.
  - `Items` Item[], required — List of items.
    - `Id` string — Line item identifier.
    - `Sku` string, required — Field to identify a line item within the tax system.
    - `Description` string — Description of a line item.
    - `TaxCode` string — Tax code for the line item.
    - `TaxIncluded` boolean — Indicates if a line item has tax included.
    - `Amount` number, float, required — Amount of item to be paid. Currency is defined by the parent object.
    - `TaxAmount` number, float — Amount of tax calculated for this item.
    - `Tax` Tax[] — List of taxes applied for the item.
      - `Name` string — Name of the tax.
      - `Type` string — Type of tax.
      - `TaxAmount` number, float — Amount of tax calculated of this tax type.
  - `ShippingAddress` Address, required — A postal address used for tax jurisdiction determination.
    - `Street` string, required — Street address line.
    - `City` string, required — City name.
    - `Region` string — State, province, or region code (e.g. `"CA"` for California, `"NSW"` for New South Wales). Recommended for US and Canadian addresses.
    - `Country` string, required — ISO 3166-1 alpha-2 country code.
    - `Postcode` string — Postal or ZIP code.
  - `WarehouseAddress` WarehouseAddress — Required for physical goods. Standard address.
    - `Street` string, required — Warehouse's street address.
    - `City` string, required — Warehouse's city.
    - `Region` string — Warehouse's state or province. The region code is the region-only portion of an ISO-3166-2 region (e.g., MX-GUA would be sent as "GUA").
    - `Country` string, required — Warehouse's country (uppercase ISO 3166 alpha-2 country code).
    - `Postcode` string — Warehouse's zip/postal code.
  - `BusinessIdentificationNumber` string — Business Identification Number for tax exemption.
  - `Amount` number, float — Amount to be paid. Currency is defined by the parent object.
  - `TaxAmount` number, float — Amount of tax calculated.

## Response `201`

Operation Successful

- Quote
  - `Id` string, uuid — A unique string generated by Reach to identify the specific tax quote instance.
  - `Currency` string, required — Three-character ISO-4217 currency code.
  - `Reference` string, required — Unique reference provided by supplier.
  - `Items` Item[], required — List of items.
    - `Id` string — Line item identifier.
    - `Sku` string, required — Field to identify a line item within the tax system.
    - `Description` string — Description of a line item.
    - `TaxCode` string — Tax code for the line item.
    - `TaxIncluded` boolean — Indicates if a line item has tax included.
    - `Amount` number, float, required — Amount of item to be paid. Currency is defined by the parent object.
    - `TaxAmount` number, float — Amount of tax calculated for this item.
    - `Tax` Tax[] — List of taxes applied for the item.
      - `Name` string — Name of the tax.
      - `Type` string — Type of tax.
      - `TaxAmount` number, float — Amount of tax calculated of this tax type.
  - `ShippingAddress` Address, required — A postal address used for tax jurisdiction determination.
    - `Street` string, required — Street address line.
    - `City` string, required — City name.
    - `Region` string — State, province, or region code (e.g. `"CA"` for California, `"NSW"` for New South Wales). Recommended for US and Canadian addresses.
    - `Country` string, required — ISO 3166-1 alpha-2 country code.
    - `Postcode` string — Postal or ZIP code.
  - `WarehouseAddress` WarehouseAddress — Required for physical goods. Standard address.
    - `Street` string, required — Warehouse's street address.
    - `City` string, required — Warehouse's city.
    - `Region` string — Warehouse's state or province. The region code is the region-only portion of an ISO-3166-2 region (e.g., MX-GUA would be sent as "GUA").
    - `Country` string, required — Warehouse's country (uppercase ISO 3166 alpha-2 country code).
    - `Postcode` string — Warehouse's zip/postal code.
  - `BusinessIdentificationNumber` string — Business Identification Number for tax exemption.
  - `Amount` number, float — Amount to be paid. Currency is defined by the parent object.
  - `TaxAmount` number, float — Amount of tax calculated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/withreach/apis/reach-checkout-api.md) · [All operations](https://skmtc.net/withreach/apis/reach-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withreach/reach-checkout-api/versions/f95f4b8dd180/schema)