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

# Retrieve settings

`GET /v1/tax/settings`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/tax/settings`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

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: Whether these settings have the information Stripe Tax needs to calculate tax. It doesn't reflect whether your integration is ready to collect tax.
  - `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.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)