# The Tax Calculation object

### The Tax Calculation object

```json
{
  "id": "taxcalc_1OduxkBUZ691iUZ4iWvpMApI",
  "object": "tax.calculation",
  "amount_total": 1953,
  "currency": "usd",
  "customer": null,
  "customer_details": {
    "address": {
      "city": "Seattle",
      "country": "US",
      "line1": "920 5th Ave",
      "line2": null,
      "postal_code": "98104",
      "state": "WA"
    },
    "address_source": "shipping",
    "ip_address": null,
    "tax_ids": [],
    "taxability_override": "none"
  },
  "expires_at": 1706708005,
  "line_items": {
    "object": "list",
    "data": [
      {
        "id": "tax_li_PSqf3RMNZa23H4",
        "object": "tax.calculation_line_item",
        "amount": 1499,
        "amount_tax": 154,
        "livemode": false,
        "product": null,
        "quantity": 1,
        "reference": "Music Streaming Coupon",
        "tax_behavior": "exclusive",
        "tax_code": "txcd_10000000"
      }
    ],
    "has_more": false,
    "total_count": 1,
    "url": "/v1/tax/calculations/taxcalc_1OduxkBUZ691iUZ4iWvpMApI/line_items"
  },
  "livemode": false,
  "ship_from_details": null,
  "shipping_cost": {
    "amount": 300,
    "amount_tax": 0,
    "tax_behavior": "exclusive",
    "tax_code": "txcd_92010001"
  },
  "tax_amount_exclusive": 154,
  "tax_amount_inclusive": 0,
  "tax_breakdown": [
    {
      "amount": 154,
      "inclusive": false,
      "tax_rate_details": {
        "country": "US",
        "percentage_decimal": "10.25",
        "state": "WA",
        "tax_type": "sales_tax"
      },
      "taxability_reason": "standard_rated",
      "taxable_amount": 1499
    },
    {
      "amount": 0,
      "inclusive": false,
      "tax_rate_details": {
        "country": "DE",
        "percentage_decimal": "0.0",
        "state": null,
        "tax_type": "vat"
      },
      "taxability_reason": "zero_rated",
      "taxable_amount": 300
    }
  ],
  "tax_date": 1706535204
}
```

## Attributes

- `id` (string, nullable)
  Unique identifier for the calculation.

- `object` (string, value is "tax.calculation")
  String representing the object’s type. Objects of the same type share the same value.

- `amount_total` (integer)
  Total amount after taxes in the [smallest currency unit](https://docs.stripe.com/currencies.md#minor-units).

- `currency` (string)
  Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://docs.stripe.com/currencies.md).

- `customer` (string, nullable)
  The ID of an existing [Customer](https://docs.stripe.com/api/customers/object.md) used for the resource.

- [`customer_details`](https://docs.stripe.com/api/tax/calculations/object.md?query=customer_details) (object)
  The customer’s details, such as address and tax IDs.

- `expires_at` (timestamp, nullable)
  Timestamp of date at which the tax calculation will expire.

- [`line_items`](https://docs.stripe.com/api/tax/calculations/object.md?query=line_items) (object, nullable, expandable (can be expanded into an object with the `expand` request parameter))
  The list of items the customer is purchasing.

- `livemode` (boolean)
  If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.

- [`ship_from_details`](https://docs.stripe.com/api/tax/calculations/object.md?query=ship_from_details) (object, nullable)
  The details of the ship from location, such as the address.

- [`shipping_cost`](https://docs.stripe.com/api/tax/calculations/object.md?query=shipping_cost) (object, nullable)
  The shipping cost details for the calculation.

- `tax_amount_exclusive` (integer)
  The amount of tax to be collected on top of the line item prices.

- `tax_amount_inclusive` (integer)
  The amount of tax already included in the line item prices.

- [`tax_breakdown`](https://docs.stripe.com/api/tax/calculations/object.md?query=tax_breakdown) (array of objects)
  Breakdown of individual tax amounts that add up to the total.

- `tax_date` (timestamp)
  The calculation uses the tax rules and rates that are in effect at this timestamp. You can use a date up to 31 days in the past or up to 31 days in the future. If you use a future date, Stripe doesn’t guarantee that the expected tax rules and rate being used match the actual rules and rate that will be in effect on that date. We deploy tax changes before their effective date, but not within a fixed window.