Skip to main content
GET
Get tax profile
To enable the Tax Estimates feature for your customers, request access from your Layer representative.
Returns the business’s current tax profile: the inputs that drive the tax calculations in Get tax summary, Get tax overview, and Get tax details. The profile includes:
  • tax_country_code: the country the calculation targets.
  • us_configuration.federal: federal filing status, annual W-2 income, tip/overtime income, and withholding (custom amount or default).
  • us_configuration.state: the targeted state for tax, state filing status, exemptions, and state withholding.
  • us_configuration.deductions: home office and vehicle/mileage deduction configuration.
  • us_configuration.business_estimates: optional user-estimated annual business revenue and expenses that override the year-to-date figures pulled from the P&L.
  • user_has_saved_tax_profile: whether the user has explicitly saved a profile. When false, calculations run with default assumptions and a MISSING_PROFILE item appears on the tax checklist.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Content-Type
string

Content-Type must be set to application/json.

Path Parameters

businessId
string<uuid>
required

The UUID of the business.

Response

Tax profile for the business.

data
object
required

Tax profile configuration for a business.