> ## Documentation Index > Fetch the complete documentation index at: https://docs.shoply.gg/llms.txt > Use this file to discover all available pages before exploring further. # Get tax settings > Whether the store collects tax at checkout, whether its prices include it, the places it collects in and at what rate, and each country's built-in rate. Refused with `business_details_required` until the store has its business details. Needs the `finance.read` permission (Read Finance). ## OpenAPI ````yaml /api-reference/openapi.json get /stores/{storeId}/tax openapi: 3.1.0 info: title: Shoply API version: '1' description: >- Everything a store's own server can do with a secret API key: its catalogue, orders, customers, marketing, finance and the rest of what the dashboard does. And the Customer API, which a buyer's own device asks with a token of theirs. servers: - url: https://api.shoply.gg/v1 security: - apiKey: [] tags: - name: API key - name: Store - name: Domain - name: Payment methods - name: Analytics - name: Storefronts - name: Storefront code - name: Payment Routing - name: Custom payment methods - name: Products - name: Product pictures - name: Stock - name: Categories - name: Upsells - name: Subscriptions - name: Orders - name: Invoices - name: Reviews - name: Coupons - name: Coupon categories - name: Coupon pop-up - name: Sales - name: Blog - name: Search settings - name: Redirects - name: Sitemap - name: Cart Recovery - name: Email Marketing - name: Email Templates - name: Customers - name: Affiliates - name: Support Tickets - name: Blacklist - name: Fraud protection - name: Disputes - name: Finance - name: Tax - name: Expenses - name: Expense setup - name: API requests - name: Webhook endpoints - name: Webhook deliveries - name: Customer API paths: /stores/{storeId}/tax: get: tags: - Tax summary: Get tax settings description: >- Whether the store collects tax at checkout, whether its prices include it, the places it collects in and at what rate, and each country's built-in rate. Refused with `business_details_required` until the store has its business details. Needs the `finance.read` permission (Read Finance). operationId: tax.show parameters: - name: storeId in: path required: true description: >- The store's ID. A key reaches the store it was made in: `GET /key` answers which. schema: type: string responses: '200': description: It worked. content: application/json: schema: type: object properties: success: type: boolean message: nullable: true code: nullable: true data: type: object properties: collect: type: boolean included: type: boolean business: type: boolean home: type: string homeName: type: string rates: type: array items: type: object properties: country: type: string countryName: type: string region: type: string regionName: type: string rate: type: integer label: type: string standard: type: integer standard: type: object properties: AT: type: object properties: label: type: string rate: type: integer BE: type: object properties: label: type: string rate: type: integer BG: type: object properties: label: type: string rate: type: integer HR: type: object properties: label: type: string rate: type: integer CY: type: object properties: label: type: string rate: type: integer CZ: type: object properties: label: type: string rate: type: integer DK: type: object properties: label: type: string rate: type: integer EE: type: object properties: label: type: string rate: type: integer FI: type: object properties: label: type: string rate: type: number FR: type: object properties: label: type: string rate: type: integer DE: type: object properties: label: type: string rate: type: integer GR: type: object properties: label: type: string rate: type: integer HU: type: object properties: label: type: string rate: type: integer IE: type: object properties: label: type: string rate: type: integer IT: type: object properties: label: type: string rate: type: integer LV: type: object properties: label: type: string rate: type: integer LT: type: object properties: label: type: string rate: type: integer LU: type: object properties: label: type: string rate: type: integer MT: type: object properties: label: type: string rate: type: integer NL: type: object properties: label: type: string rate: type: integer PL: type: object properties: label: type: string rate: type: integer PT: type: object properties: label: type: string rate: type: integer RO: type: object properties: label: type: string rate: type: integer SK: type: object properties: label: type: string rate: type: integer SI: type: object properties: label: type: string rate: type: integer ES: type: object properties: label: type: string rate: type: integer SE: type: object properties: label: type: string rate: type: integer GB: type: object properties: label: type: string rate: type: integer 'NO': type: object properties: label: type: string rate: type: integer CH: type: object properties: label: type: string rate: type: number LI: type: object properties: label: type: string rate: type: number IS: type: object properties: label: type: string rate: type: integer RS: type: object properties: label: type: string rate: type: integer UA: type: object properties: label: type: string rate: type: integer TR: type: object properties: label: type: string rate: type: integer AU: type: object properties: label: type: string rate: type: integer NZ: type: object properties: label: type: string rate: type: integer CA: type: object properties: label: type: string rate: type: integer SG: type: object properties: label: type: string rate: type: integer IN: type: object properties: label: type: string rate: type: integer JP: type: object properties: label: type: string rate: type: integer KR: type: object properties: label: type: string rate: type: integer TW: type: object properties: label: type: string rate: type: integer TH: type: object properties: label: type: string rate: type: integer MY: type: object properties: label: type: string rate: type: integer ID: type: object properties: label: type: string rate: type: integer PH: type: object properties: label: type: string rate: type: integer VN: type: object properties: label: type: string rate: type: integer AE: type: object properties: label: type: string rate: type: integer SA: type: object properties: label: type: string rate: type: integer BH: type: object properties: label: type: string rate: type: integer OM: type: object properties: label: type: string rate: type: integer IL: type: object properties: label: type: string rate: type: integer EG: type: object properties: label: type: string rate: type: integer MA: type: object properties: label: type: string rate: type: integer ZA: type: object properties: label: type: string rate: type: integer NG: type: object properties: label: type: string rate: type: number KE: type: object properties: label: type: string rate: type: integer MX: type: object properties: label: type: string rate: type: integer CL: type: object properties: label: type: string rate: type: integer CO: type: object properties: label: type: string rate: type: integer AR: type: object properties: label: type: string rate: type: integer PE: type: object properties: label: type: string rate: type: integer eu: type: array items: type: string regions: type: object properties: US: type: array items: type: object properties: code: type: string name: type: string limit: type: integer maxRate: type: integer example: success: true message: null code: null data: collect: true included: false business: true home: DE homeName: Germany rates: - country: DE countryName: Germany region: '' regionName: '' rate: 19 label: VAT standard: 19 - country: US countryName: United States region: CA regionName: California rate: 7.25 label: Sales tax standard: null standard: AT: label: VAT rate: 20 BE: label: VAT rate: 21 BG: label: VAT rate: 20 HR: label: VAT rate: 25 CY: label: VAT rate: 19 CZ: label: VAT rate: 21 DK: label: VAT rate: 25 EE: label: VAT rate: 24 FI: label: VAT rate: 25.5 FR: label: VAT rate: 20 DE: label: VAT rate: 19 GR: label: VAT rate: 24 HU: label: VAT rate: 27 IE: label: VAT rate: 23 IT: label: VAT rate: 22 LV: label: VAT rate: 21 LT: label: VAT rate: 21 LU: label: VAT rate: 17 MT: label: VAT rate: 18 NL: label: VAT rate: 21 PL: label: VAT rate: 23 PT: label: VAT rate: 23 RO: label: VAT rate: 21 SK: label: VAT rate: 23 SI: label: VAT rate: 22 ES: label: VAT rate: 21 SE: label: VAT rate: 25 GB: label: VAT rate: 20 'NO': label: VAT rate: 25 CH: label: VAT rate: 8.1 LI: label: VAT rate: 8.1 IS: label: VAT rate: 24 RS: label: VAT rate: 20 UA: label: VAT rate: 20 TR: label: VAT rate: 20 AU: label: GST rate: 10 NZ: label: GST rate: 15 CA: label: GST rate: 5 SG: label: GST rate: 9 IN: label: GST rate: 18 JP: label: Consumption tax rate: 10 KR: label: VAT rate: 10 TW: label: VAT rate: 5 TH: label: VAT rate: 7 MY: label: Service tax rate: 8 ID: label: VAT rate: 11 PH: label: VAT rate: 12 VN: label: VAT rate: 10 AE: label: VAT rate: 5 SA: label: VAT rate: 15 BH: label: VAT rate: 10 OM: label: VAT rate: 5 IL: label: VAT rate: 18 EG: label: VAT rate: 14 MA: label: VAT rate: 20 ZA: label: VAT rate: 15 NG: label: VAT rate: 7.5 KE: label: VAT rate: 16 MX: label: VAT rate: 16 CL: label: VAT rate: 19 CO: label: VAT rate: 19 AR: label: VAT rate: 21 PE: label: VAT rate: 18 eu: - AT - BE regions: US: - code: AL name: Alabama - code: AK name: Alaska limit: 400 maxRate: 50 '401': $ref: '#/components/responses/NoKey' '403': $ref: '#/components/responses/NotAllowed' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/TooMany' x-codeSamples: - lang: javascript label: Node.js source: | import Shoply from "@shoplygg/node"; const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY }); const result = await shoply.tax.show(); - lang: php label: PHP source: | getenv('SHOPLY_API_KEY')]); $result = $shoply->tax->show(); - lang: python label: Python source: | import shoply client = shoply.Client() # reads SHOPLY_API_KEY result = client.tax.show() components: responses: NoKey: description: >- No API key was sent, or the one sent is not a live key: `api_key_required`, `invalid_api_key`. content: application/json: schema: $ref: '#/components/schemas/Refusal' NotAllowed: description: >- The key is real and may not do this: `missing_scope` (with `requiredScope`), `ip_not_allowed`, `account_unavailable`, or `dashboard_only` for something only a person in the dashboard may do. content: application/json: schema: $ref: '#/components/schemas/Refusal' NotFound: description: >- There is no such thing in this store: `not_found`. A store that is not the key's own is answered the same way. content: application/json: schema: $ref: '#/components/schemas/Refusal' TooMany: description: >- The key has used up its budget for now: `rate_limited`. `Retry-After` says how many seconds to wait. content: application/json: schema: $ref: '#/components/schemas/Refusal' schemas: Refusal: type: object properties: success: type: boolean example: false message: type: string description: What is wrong, in words for a person. code: type: string description: What is wrong, as a word that does not change. data: nullable: true errors: type: object description: >- For `validation_failed`: what is wrong with each field, by the field's name. additionalProperties: type: string required: - success - message - code securitySchemes: apiKey: type: http scheme: bearer description: >- A secret API key, made under Developers in the dashboard: `Authorization: Bearer shoply_sk_...` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.