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

# Create a new tax quote

`POST /v1/tax/quote`

## Request

- Base URL: `https://api.sandbox.withreach.com`
- URL: `https://api.sandbox.withreach.com/v1/tax/quote`
- Auth: HTTP basic

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. Requests should not exceed the [limit](https://docs.withreach.com/docs/reach-tax-quote-api#tax-quote-rate-limiting) of 10 requests per second. For more details, review the [Reach Tax Quote API](https://docs.withreach.com/docs/reach-tax-quote-api) page.

## 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: Standard address.
    - `Street` string, required: Customer's street address.
    - `City` string, required: Customer's city.
    - `Region` string: Customer'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: Customer's country (uppercase ISO 3166 alpha-2 country code).
    - `Postcode` string: Customer's zip/postal 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: Standard address.
    - `Street` string, required: Customer's street address.
    - `City` string, required: Customer's city.
    - `Region` string: Customer'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: Customer's country (uppercase ISO 3166 alpha-2 country code).
    - `Postcode` string: Customer's zip/postal 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.dev/withreach/apis/tax-quote-api.md) - [All operations](https://skmtc.dev/withreach/apis/tax-quote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withreach/apis/tax-quote-api/revisions/87289927c62e?raw)