> ## Documentation Index
> Fetch the complete documentation index at: https://developer.lulacommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Store Tax Rate

> This endpoint retrieves the tax rate configuration for a specific store. Tax rates are essential for accurate order calculations and compliance with local tax regulations. The response includes applicable tax percentages and tax jurisdiction information.

This endpoint provides the current tax rate information configured for a store. Tax rates are used to calculate taxes on orders and ensure compliance with local tax regulations based on the store's location.

### Path Parameters

<ParamField path="store_id" type="string" required>
  The unique identifier of the store to retrieve tax rate information for
</ParamField>

### Response

<ResponseField name="tax_rate" type="number">
  The tax rate as a decimal (e.g., 0.0875 for 8.75%)
</ResponseField>

<ResponseField name="tax_jurisdiction" type="string">
  The tax jurisdiction or authority that applies to this store
</ResponseField>

<ResponseField name="tax_type" type="string">
  Type of tax applied (e.g., "sales\_tax", "vat", "gst")
</ResponseField>

<ResponseField name="effective_date" type="string">
  When this tax rate became effective (ISO 8601 format)
</ResponseField>

<ResponseField name="currency" type="string">
  Currency code for tax calculations (e.g., "USD", "CAD")
</ResponseField>

<ResponseField name="tax_inclusive" type="boolean">
  Whether prices include tax (true) or tax is added separately (false)
</ResponseField>

### Response Example

```json theme={null}
{
    "tax_rate": 0.0875,
    "tax_jurisdiction": "California State Tax",
    "tax_type": "sales_tax",
    "effective_date": "2024-01-01T00:00:00Z",
    "currency": "USD",
    "tax_inclusive": false
}
```

### Tax Rate Usage

<Accordion title="How Tax Rates Are Applied">
  <ResponseField name="Order Calculations" type="usage">
    Tax rates are automatically applied to order totals during checkout

    <Note>Tax calculation happens in real-time based on current rates</Note>
  </ResponseField>

  <ResponseField name="Compliance" type="usage">
    Ensures orders comply with local tax regulations and reporting requirements

    <Info>Tax rates may vary by product category or customer type</Info>
  </ResponseField>

  <ResponseField name="Financial Reporting" type="usage">
    Used for generating tax reports and remittance to tax authorities

    <Tip>Historical tax rates are preserved for audit purposes</Tip>
  </ResponseField>
</Accordion>

### Tax Rate Management

<Accordion title="Tax Rate Information">
  <ResponseField name="Automatic Updates" type="info">
    Tax rates may be updated automatically based on jurisdiction changes

    <Warning>Rate changes typically have advance notice periods</Warning>
  </ResponseField>

  <ResponseField name="Geographic Specificity" type="info">
    Rates are determined by store location and applicable tax jurisdictions

    <Note>Stores in different locations may have different tax rates</Note>
  </ResponseField>

  <ResponseField name="Product Categories" type="info">
    Some jurisdictions apply different rates to different product types

    <Info>The base rate shown may be modified based on product category</Info>
  </ResponseField>
</Accordion>

### Common Use Cases

<Accordion title="When to Check Tax Rates">
  <ResponseField name="Order Processing" type="use-case">
    Verify current tax rates during order calculation and validation
  </ResponseField>

  <ResponseField name="Financial Analysis" type="use-case">
    Understanding tax impact on revenue and pricing strategies
  </ResponseField>

  <ResponseField name="Compliance Audits" type="use-case">
    Ensuring proper tax rates are applied for regulatory compliance
  </ResponseField>

  <ResponseField name="System Integration" type="use-case">
    Synchronizing tax rates with external accounting or POS systems
  </ResponseField>
</Accordion>

### Error Scenarios

<Accordion title="Common Tax Rate Errors">
  <ResponseField name="Store Not Found" type="error">
    The specified store\_id doesn't exist

    **Status Code:** 404
  </ResponseField>

  <ResponseField name="Tax Configuration Missing" type="error">
    Store doesn't have tax rate configuration set up

    **Status Code:** 404

    **Solution:** Contact support to configure tax rates for the store
  </ResponseField>

  <ResponseField name="Jurisdiction Issues" type="error">
    Tax jurisdiction data is incomplete or invalid

    **Status Code:** 500

    **Solution:** Verify store address and tax jurisdiction setup
  </ResponseField>
</Accordion>

<Info>
  **Rate Precision:** Tax rates are provided with high precision to ensure accurate calculations. Always use the exact decimal values provided.
</Info>

<Warning>
  **Rate Changes:** Tax rates can change due to legislative updates. Applications should periodically refresh tax rate information to ensure compliance.
</Warning>

<Note>
  **Integration:** This endpoint is commonly used by POS systems, e-commerce platforms, and accounting software to ensure consistent tax calculations across all systems.
</Note>