Skip to main content
POST
/
v1
/
businesses
/
{businessId}
/
tax-estimates
/
profile
Create tax profile
curl --request POST \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "Tax_Profile",
  "tax_country_code": "US",
  "us_configuration": {
    "federal": {
      "filing_status": "SINGLE",
      "annual_w2_income": 123,
      "tip_income": 123,
      "overtime_income": 123,
      "withholding": {
        "use_custom_withholding": true,
        "amount": 123
      }
    },
    "state": {
      "tax_state": "CA",
      "filing_status": "SINGLE",
      "num_exemptions": 123,
      "withholding": {
        "use_custom_withholding": true,
        "amount": 123
      }
    },
    "deductions": {
      "home_office": {
        "use_home_office_deduction": true,
        "home_office_area": 123
      },
      "vehicle": {
        "use_mileage_deduction": false,
        "vehicle_business_percent": 123,
        "mileage": {
          "use_user_estimated_business_mileage": true,
          "user_estimated_business_mileage": 123
        }
      }
    },
    "business_estimates": {
      "expenses": {
        "use_user_estimated_business_expenses": true,
        "user_estimated_business_expenses": 123
      },
      "revenue": {
        "use_user_estimated_business_revenue": true,
        "user_estimated_business_revenue": 123
      }
    }
  },
  "ca_configuration": {},
  "user_has_saved_tax_profile": true
}
'
{
  "type": "Tax_Profile",
  "tax_country_code": "US",
  "us_configuration": {
    "federal": {
      "filing_status": "SINGLE",
      "annual_w2_income": 123,
      "tip_income": 123,
      "overtime_income": 123,
      "withholding": {
        "use_custom_withholding": true,
        "amount": 123
      }
    },
    "state": {
      "tax_state": "CA",
      "filing_status": "SINGLE",
      "num_exemptions": 123,
      "withholding": {
        "use_custom_withholding": true,
        "amount": 123
      }
    },
    "deductions": {
      "home_office": {
        "use_home_office_deduction": true,
        "home_office_area": 123
      },
      "vehicle": {
        "use_mileage_deduction": false,
        "vehicle_business_percent": 123,
        "mileage": {
          "use_user_estimated_business_mileage": true,
          "user_estimated_business_mileage": 123
        }
      }
    },
    "business_estimates": {
      "expenses": {
        "use_user_estimated_business_expenses": true,
        "user_estimated_business_expenses": 123
      },
      "revenue": {
        "use_user_estimated_business_revenue": true,
        "user_estimated_business_revenue": 123
      }
    }
  },
  "ca_configuration": {},
  "user_has_saved_tax_profile": true
}

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

Example:

"US"

ā€‹
us_configuration
object

US-specific tax configuration

ā€‹
ca_configuration
object

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 created successfully

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

Example:

"US"

ā€‹
us_configuration
object

US-specific tax configuration

ā€‹
ca_configuration
object

Canadian-specific tax configuration (future use)

ā€‹
user_has_saved_tax_profile
boolean

Whether the user has explicitly saved their tax profile configuration.