Skip to main content
GET
/
stores
/
{store_id}
/
tax-rate
Get Store Tax Rate
curl --request GET \
  --url https://api-staging.luladelivery.store/stores/{store_id}/tax-rate
{
  "tax_rate": 123,
  "tax_jurisdiction": "<string>",
  "tax_type": "<string>",
  "effective_date": "<string>",
  "currency": "<string>",
  "tax_inclusive": true
}
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

​
store_id
string
required
The unique identifier of the store to retrieve tax rate information for

​
Response

​
tax_rate
number
The tax rate as a decimal (e.g., 0.0875 for 8.75%)
​
tax_jurisdiction
string
The tax jurisdiction or authority that applies to this store
​
tax_type
string
Type of tax applied (e.g., “sales_tax”, “vat”, “gst”)
​
effective_date
string
When this tax rate became effective (ISO 8601 format)
​
currency
string
Currency code for tax calculations (e.g., “USD”, “CAD”)
​
tax_inclusive
boolean
Whether prices include tax (true) or tax is added separately (false)

​
Response Example

{
    "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

​
Order Calculations
usage
Tax rates are automatically applied to order totals during checkout
Tax calculation happens in real-time based on current rates
​
Compliance
usage
Ensures orders comply with local tax regulations and reporting requirements
Tax rates may vary by product category or customer type
​
Financial Reporting
usage
Used for generating tax reports and remittance to tax authorities
Historical tax rates are preserved for audit purposes

​
Tax Rate Management

​
Automatic Updates
info
Tax rates may be updated automatically based on jurisdiction changes
Rate changes typically have advance notice periods
​
Geographic Specificity
info
Rates are determined by store location and applicable tax jurisdictions
Stores in different locations may have different tax rates
​
Product Categories
info
Some jurisdictions apply different rates to different product types
The base rate shown may be modified based on product category

​
Common Use Cases

​
Order Processing
use-case
Verify current tax rates during order calculation and validation
​
Financial Analysis
use-case
Understanding tax impact on revenue and pricing strategies
​
Compliance Audits
use-case
Ensuring proper tax rates are applied for regulatory compliance
​
System Integration
use-case
Synchronizing tax rates with external accounting or POS systems

​
Error Scenarios

​
Store Not Found
error
The specified store_id doesn’t existStatus Code: 404
​
Tax Configuration Missing
error
Store doesn’t have tax rate configuration set upStatus Code: 404Solution: Contact support to configure tax rates for the store
​
Jurisdiction Issues
error
Tax jurisdiction data is incomplete or invalidStatus Code: 500Solution: Verify store address and tax jurisdiction setup
Rate Precision: Tax rates are provided with high precision to ensure accurate calculations. Always use the exact decimal values provided.
Rate Changes: Tax rates can change due to legislative updates. Applications should periodically refresh tax rate information to ensure compliance.
Integration: This endpoint is commonly used by POS systems, e-commerce platforms, and accounting software to ensure consistent tax calculations across all systems.
⌘I