---
title: "Retrieve settings"
method: GET
path: "/v1/tax/settings"
---

# Retrieve settings

`GET /v1/tax/settings`

Retrieves Tax `Settings` for a merchant.

## Query parameters

- `expand` string[]

## Response `200`

Successful response.

- TaxSettings — You can use Tax `Settings` to manage configurations used by Stripe Tax calculations. Related guide: [Using the Settings API](https://docs.stripe.com/tax/settings-api)
  - `defaults` TaxProductResourceTaxSettingsDefaults, required
    - `provider` 'anrok' | 'avalara' | 'sphere' | 'stripe', required — The tax calculation provider this account uses. Defaults to `stripe` when not using a [third-party provider](/tax/third-party-apps).
    - `tax_behavior` 'exclusive' | 'inclusive' | 'inferred_by_currency', nullable — Default [tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#tax-behavior) used to specify whether the price is considered inclusive of taxes or exclusive of taxes. If the item's price has a tax behavior set, it will take precedence over the default tax behavior.
    - `tax_code` string, nullable — Default [tax code](https://stripe.com/docs/tax/tax-categories) used to classify your products and prices.
  - `head_office` TaxProductResourceTaxSettingsHeadOffice
    - `address` Address, required
      - `city` string, nullable — City, district, suburb, town, or village.
      - `country` string, nullable — Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `line1` string, nullable — Address line 1, such as the street, PO Box, or company name.
      - `line2` string, nullable — Address line 2, such as the apartment, suite, unit, or building.
      - `postal_code` string, nullable — ZIP or postal code.
      - `state` string, nullable — State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
  - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `object` 'tax.settings', required — String representing the object's type. Objects of the same type share the same value.
  - `status` 'active' | 'pending', required — The status of the Tax `Settings`.
  - `status_details` TaxProductResourceTaxSettingsStatusDetails, required
    - `active` TaxProductResourceTaxSettingsStatusDetailsResourceActive
    - `pending` TaxProductResourceTaxSettingsStatusDetailsResourcePending
      - `missing_fields` string[], nullable — The list of missing fields that are required to perform calculations. It includes the entry `head_office` when the status is `pending`. It is recommended to set the optional values even if they aren't listed as required for calculating taxes. Calculations can fail if missing fields aren't explicitly provided on every call.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/spec3.md) · [All operations](https://skmtc.net/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/3653ad45bbec/schema)