Skip to main content
POST
/
calculate
{
  "corporation_id": "b6d009b0-d174-463f-b030-94643c28e209",
  "transaction_date": "2023-12-25",
  "transaction_currency": "USD",
  "transaction_type": "SALE",
  "discount": 0,
  "addresses": {
    "ship_to": {
      "address_line_1": "1776 Main St",
      "address_line_2": "Apt. #123",
      "postal_code": "90401",
      "city": "Santa Monica",
      "state": "CA",
      "country": "US"
    },
    "ship_from": {
      "address_line_1": "1776 Main St",
      "address_line_2": "Apt. #123",
      "postal_code": "90401",
      "city": "Santa Monica",
      "state": "CA",
      "country": "US"
    }
  },
  "customer_details": {
    "customer_id": "customer_123"
  },
  "line_items": {
    "items": [
      {
        "line_number": 1,
        "product_taxability_code": "TPP",
        "quantity": 1,
        "amount": 100.00,
        "discount": 0,
        "product_id": "prod_123"
      }
    ]
  }
}

{
  "data": {
    "id": "calc_123",
    "corporation_id": "b6d009b0-d174-463f-b030-94643c28e209",
    "transaction_date": "2023-12-25",
    "transaction_currency": "USD",
    "discount": 0,
    "calculation_currency": "USD",
    "exchange_rate": 1.0,
    "total_amount": 100.00,
    "total_tax": 9.50,
    "total_due": 109.50,
    "customer_details": {
      "customer_id": "customer_123"
    },
    "tax_currency": "USD",
    "addresses": {
      "ship_from": {
        "address_line_1": "1776 Main St",
        "address_line_2": "Apt. #123",
        "postal_code": "90401",
        "city": "Santa Monica",
        "state": "CA",
        "country": "US"
      },
      "ship_to": {
        "address_line_1": "1776 Main St",
        "address_line_2": "Apt. #123",
        "postal_code": "90401",
        "city": "Santa Monica",
        "state": "CA",
        "country": "US"
      }
    },
    "line_items": [
      {
        "line_item_id": "line_123",
        "amount": 100.00,
        "taxable_amount": 100.00,
        "quantity": 1,
        "tax_code": "TPP",
        "product_id": "prod_123",
        "line_number": 1,
        "effective_tax_rate": 9.5,
        "base_tax_rate": 6.0,
        "tax_breakdown": [
          {
            "jurisdiction_name": "California",
            "jurisdiction_type": "STATE",
            "rate": 6.0,
            "base_rate": 6.0,
            "tax_class": "TAXABLE",
            "tax_class_reason": ""
          },
          {
            "jurisdiction_name": "Los Angeles County",
            "jurisdiction_type": "COUNTY",
            "rate": 2.25,
            "base_rate": 2.25,
            "tax_class": "TAXABLE",
            "tax_class_reason": ""
          },
          {
            "jurisdiction_name": "Santa Monica",
            "jurisdiction_type": "CITY",
            "rate": 1.25,
            "base_rate": 1.25,
            "tax_class": "TAXABLE",
            "tax_class_reason": ""
          }
        ],
        "total_tax_due": 9.50
      }
    ]
  },
  "message": "Successfully calculated tax."
}

{
  "corporation_id": "b6d009b0-d174-463f-b030-94643c28e209",
  "transaction_date": "2023-12-25",
  "transaction_currency": "USD",
  "transaction_type": "SALE",
  "discount": 0,
  "addresses": {
    "ship_to": {
      "address_line_1": "1776 Main St",
      "address_line_2": "Apt. #123",
      "postal_code": "90401",
      "city": "Santa Monica",
      "state": "CA",
      "country": "US"
    },
    "ship_from": {
      "address_line_1": "1776 Main St",
      "address_line_2": "Apt. #123",
      "postal_code": "90401",
      "city": "Santa Monica",
      "state": "CA",
      "country": "US"
    }
  },
  "customer_details": {
    "customer_id": "customer_123"
  },
  "line_items": {
    "items": [
      {
        "line_number": 1,
        "product_taxability_code": "TPP",
        "quantity": 1,
        "amount": 100.00,
        "discount": 0,
        "product_id": "prod_123"
      }
    ]
  }
}

{
  "data": {
    "id": "calc_123",
    "corporation_id": "b6d009b0-d174-463f-b030-94643c28e209",
    "transaction_date": "2023-12-25",
    "transaction_currency": "USD",
    "discount": 0,
    "calculation_currency": "USD",
    "exchange_rate": 1.0,
    "total_amount": 100.00,
    "total_tax": 9.50,
    "total_due": 109.50,
    "customer_details": {
      "customer_id": "customer_123"
    },
    "tax_currency": "USD",
    "addresses": {
      "ship_from": {
        "address_line_1": "1776 Main St",
        "address_line_2": "Apt. #123",
        "postal_code": "90401",
        "city": "Santa Monica",
        "state": "CA",
        "country": "US"
      },
      "ship_to": {
        "address_line_1": "1776 Main St",
        "address_line_2": "Apt. #123",
        "postal_code": "90401",
        "city": "Santa Monica",
        "state": "CA",
        "country": "US"
      }
    },
    "line_items": [
      {
        "line_item_id": "line_123",
        "amount": 100.00,
        "taxable_amount": 100.00,
        "quantity": 1,
        "tax_code": "TPP",
        "product_id": "prod_123",
        "line_number": 1,
        "effective_tax_rate": 9.5,
        "base_tax_rate": 6.0,
        "tax_breakdown": [
          {
            "jurisdiction_name": "California",
            "jurisdiction_type": "STATE",
            "rate": 6.0,
            "base_rate": 6.0,
            "tax_class": "TAXABLE",
            "tax_class_reason": ""
          },
          {
            "jurisdiction_name": "Los Angeles County",
            "jurisdiction_type": "COUNTY",
            "rate": 2.25,
            "base_rate": 2.25,
            "tax_class": "TAXABLE",
            "tax_class_reason": ""
          },
          {
            "jurisdiction_name": "Santa Monica",
            "jurisdiction_type": "CITY",
            "rate": 1.25,
            "base_rate": 1.25,
            "tax_class": "TAXABLE",
            "tax_class_reason": ""
          }
        ],
        "total_tax_due": 9.50
      }
    ]
  },
  "message": "Successfully calculated tax."
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
corporation_id
string
required

The unique identifier for the corporation associated with this transaction.

Example:

"b6d009b0-d174-463f-b030-94643c28e209"

​
transaction_date
string<date>
required

ISO 8601 formatted date string indicating date on which the transaction took place.

​
transaction_currency
string
required

ISO 4217 alpha-3 currency code for the transaction.

Example:

"USD"

​
transaction_type
enum<string>
required

Type of the transaction (sale or refund).

Available options:
SALE,
REFUND
​
addresses
object
required

The addresses for this transaction, including shipping origin and destination. If destination address is not set, we will attempt to extract it from the linked customer. If a customer is not linked, or if the linked customer does not have a shipping address, the tax calculation will fail.

​
customer_details
object
required

Customer details for this transaction.

​
line_items
object
required
​
discount
number

Total discount amount applied to the subtotal.

Required range: x >= 0
Example:

0.99

Response

Successful tax calculation

​
data
object
​
message
string
Example:

"Successfully calculated tax."