Calculate sales tax for one or more carts

curl -X POST https://api.v3.taxcloud.com/tax/connections/25eb9b97-5acb-492d-b720-c03e79cf715a/carts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "items": [
    {
      "currency": {},
      "customerId": "customer-453",
      "destination": {
        "city": "Minneapolis",
        "line1": "323 Washington Ave N",
        "state": "MN",
        "zip": "55401-2427"
      },
      "lineItems": [
        {
          "index": 0,
          "itemId": "item-1",
          "price": 10.75,
          "quantity": 1.5
        }
      ],
      "origin": {
        "city": "Minneapolis",
        "line1": "323 Washington Ave N",
        "state": "MN",
        "zip": "55401-2427"
      }
    }
  ]
}'

{
  "connectionId": "25eb9b97-5acb-492d-b720-c03e79cf715a",
  "items": [
    {
      "cartId": "my-cart-1",
      "currency": {
        "currencyCode": "string"
      },
      "customerId": "customer-453",
      "deliveredBySeller": false,
      "destination": {
        "city": "Minneapolis",
        "countryCode": "US",
        "line1": "323 Washington Ave N",
        "state": "MN",
        "zip": "55401-2427",
        "line2": "string"
      },
      "exemption": {
        "exemptionId": "string",
        "isExempt": true
      },
      "lineItems": [
        {
          "index": 0,
          "itemId": "item-1",
          "originalPrice": 12,
          "price": 10.75,
          "quantity": 1.5,
          "tax": {
            "amount": 1.31,
            "rate": 0.08125
          },
          "tic": 0
        }
      ],
      "origin": {
        "city": "Minneapolis",
        "countryCode": "US",
        "line1": "323 Washington Ave N",
        "state": "MN",
        "zip": "55401-2427",
        "line2": "string"
      }
    }
  ],
  "transactionDate": "2024-08-01T14:00:00Z",
  "$schema": "https://example.com/tax/schemas/CreateCartsResponse.json"
}

Use this endpoint to view the tax amount and rate for a single cart or multiple carts. The cart represents a customer’s shopping cart or other transaction that has not yet been completed. Each cart can be given a custom CartID to be referenced later. This endpoint supports UPSERT actions:

If the specified cartID doesn’t exist, a new cart is created.
If the cartID already exists, the existing cart is updated. This overwrites the previous cart items.

Use this endpoint to view the tax amount and rate for a single cart or multiple carts. The cart represents a customer's shopping cart or other transaction that has not yet been completed. Each cart can be given a custom CartID to be referenced later. This endpoint supports UPSERT actions: * If the specified cartID doesn't exist, a new cart is created. * If the cartID already exists, the existing cart is updated. This overwrites the previous cart items.

Authentication

AuthorizationBearer

This authentication type can be used to directly call the service.

X-API-KEYstring

This authentication type is supported by using the provided API key for the merchant account.

Path parameters

connectionIdstringRequired>=36 characters

represents the ID of a connection. It is used as a unique identifier for the connection

Request

This endpoint expects an object.

itemslist of objectsRequired

transactionDatestringOptionalformat: "date-time"

The RFC3339 datetime string the cart is calculated for (if no value is passed in now is assumed)

Response

connectionIdstring>=36 characters

represents the ID of a connection. It is used as a unique identifier for the connection

itemslist of objects

transactionDatestringformat: "date-time"

The RFC3339 datetime string the cart is calculated for

$schemastringRead-onlyformat: "uri"

A URL to the JSON Schema for this object.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error