Skip to main content
PATCH
Update tax profile
To enable the Tax Estimates feature for your customers, request access from your Layer representative.
Updates an existing tax profile with a partial set of fields. Only the fields included in the request body are changed; omitted fields retain their current values. Use this for incremental edits to filing status, withholding, deductions, or business estimates. To replace the entire profile (treating omitted fields as cleared), issue a PUT to /v1/businesses/{businessId}/tax-estimates/profile. To create a profile that does not yet exist, use Create tax profile (POST). Any change to the profile immediately affects the outputs of Get tax summary, Get tax overview, Get tax details, and Get tax payments on their next call. Returns 404 if no tax profile exists for the business.

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.

Body

application/json

Tax profile configuration for a business.

type
string

Resource type.

Example:

"Tax_Profile"

tax_country_code
string | null

The ISO 3166-1 alpha-2 country code.

Pattern: ^[A-Z]{2}$
Example:

"US"

us_configuration
object | null

US-specific tax configuration.

ca_configuration
object | null

Canadian-specific tax configuration (future use).

user_has_saved_tax_profile
boolean

Whether the user has explicitly saved their tax profile configuration.

Response

Tax profile updated successfully.

data
object
required

Tax profile configuration for a business.