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

# Get tax estimates

> Returns tax estimate summary including federal, state, and self-employment taxes.



## OpenAPI

````yaml get /v1/businesses/{businessId}/tax-estimates
openapi: 3.0.1
info:
  title: API
  version: latest
servers: []
security:
  - BearerAuth: []
tags: []
externalDocs:
  url: /
paths:
  /v1/businesses/{businessId}/tax-estimates:
    get:
      tags:
        - Tax Estimates
      summary: Get tax estimates
      description: >-
        Returns tax estimate summary including federal, state, and
        self-employment taxes.
      operationId: business.tax-estimates.get
      parameters:
        - name: businessId
          in: path
          description: The UUID of the business
          required: true
          schema:
            type: string
            format: uuid
        - name: year
          in: query
          description: The tax year (e.g., 2025)
          required: true
          schema:
            type: integer
            format: int32
        - name: Content-Type
          in: header
          description: Content-Type must be set to application/json
          schema:
            type: string
      responses:
        '200':
          description: Tax estimates for the specified year
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTaxEstimates'
        '404':
          description: Business not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      deprecated: false
components:
  schemas:
    ApiTaxEstimates:
      type: object
      properties:
        type:
          type: string
          description: Resource type.
          example: Tax_Estimates
        country:
          type: string
          pattern: ^[A-Z]{2}$
          nullable: true
          description: The ISO 3166-1 alpha-2 country code
          example: US
        state:
          type: string
          pattern: ^[A-Z]{2}$
          nullable: true
          description: >-
            The two-character state (or Province) abbreviation for which tax
            needs to be calculated on
          example: CA
        year:
          type: integer
          format: int32
          description: Tax year for which tax needs to be calculated on
          example: 2025
        us_estimates:
          $ref: '#/components/schemas/UsTaxEstimates'
          nullable: true
        ca_estimates:
          type: object
          nullable: true
          description: Canadian-specific tax estimates (future use)
      description: Tax estimate summary for a business.
    ApiError:
      type: object
      properties: {}
      example: ''
      description: ''
    UsTaxEstimates:
      type: object
      nullable: true
      description: US-specific tax estimates with inputs and results
      properties:
        inputs:
          type: object
          nullable: true
          description: Input values used for tax calculation
          properties:
            federal_filing_status:
              type: string
              enum:
                - SINGLE
                - MARRIED
                - MARRIED_SEPARATELY
                - HEAD
                - WIDOWER
              nullable: true
              description: The tax filing status code at the federal level
            state_filing_status:
              type: string
              enum:
                - SINGLE
                - MARRIED
                - MARRIED_SEPARATELY
                - HEAD
                - WIDOWER
              nullable: true
              description: The tax filing status code at the state level
            w2_income:
              type: number
              format: double
              nullable: true
              description: >-
                The year-to-date W2 income total for which tax needs to be
                calculated on
            business_income:
              type: number
              format: double
              nullable: true
              description: >-
                The year-to-date business income for which tax needs to be
                calculated on
            other_income:
              type: number
              format: double
              nullable: true
              description: >-
                Total taxable income from sources other than wages, tips, and
                business
            expenses:
              type: number
              format: double
              nullable: true
              description: >-
                The year-to-date actual expense total (deductible and
                non-deductible) for P&L purposes
            deductible_expenses:
              type: number
              format: double
              nullable: true
              description: >-
                The year-to-date deductible expense total for which tax needs to
                be calculated on
            deductible_mileage_expenses:
              type: number
              format: double
              nullable: true
              description: >-
                The year-to-date deductible expense total originating from
                mileage
            deductible_non_mileage_expenses:
              type: number
              format: double
              nullable: true
              description: >-
                The year-to-date deductible expense total not originating from
                mileage
        results:
          type: object
          nullable: true
          description: High-level summary of tax results across federal and state
          properties:
            overall_tax:
              type: number
              format: double
              nullable: true
              description: Total tax amount (federal + state + self-employment)
            overall_tax_savings:
              type: number
              format: double
              nullable: true
              description: Total amount saved by tracking expenses
            overall_tax_unpaid:
              type: number
              format: double
              nullable: true
              description: Total remaining tax amount to be paid (federal + state)
            annual_payment_due_date:
              type: string
              format: date-time
              nullable: true
              description: Yearly due date for this year's tax season
            after_tax_income:
              type: number
              format: double
              nullable: true
              description: Income remaining after all taxes collected
        federal_tax:
          $ref: '#/components/schemas/UsFederalTaxEstimate'
        state_tax:
          $ref: '#/components/schemas/UsStateTaxEstimate'
        quarterly_estimates:
          $ref: '#/components/schemas/UsQuarterlyEstimates'
    UsFederalTaxEstimate:
      type: object
      nullable: true
      description: US Federal tax estimate details
      properties:
        w2_marginal_tax_rate:
          type: number
          format: double
          nullable: true
          description: Marginal tax rate for W-2 income
        business_marginal_tax_rate:
          type: number
          format: double
          nullable: true
          description: Marginal tax rate for self-employed income
        adjusted_gross_income:
          type: number
          format: double
          nullable: true
          description: Adjusted gross income
        business_income_deduction:
          type: number
          format: double
          nullable: true
          description: Deduction amount applied to business income
        business_income_deduction_effective_rate:
          type: number
          format: double
          nullable: true
          description: Effective rate of deduction applied to business income
        federal_deduction:
          type: number
          format: double
          nullable: true
          description: Deduction amount applied to federal taxes
        qualified_tip_deduction:
          type: number
          format: double
          nullable: true
          description: Qualified tip deduction
        qualified_overtime_deduction:
          type: number
          format: double
          nullable: true
          description: Qualified overtime deduction
        taxable_income:
          type: number
          format: double
          nullable: true
          description: Federal taxable income
        federal_effective_tax_rate:
          type: number
          format: double
          nullable: true
          description: Effective tax rate on federal taxable income
        federal_tax_amount:
          type: number
          format: double
          nullable: true
          description: Tax on federal taxable income
        medicare_surtax:
          $ref: '#/components/schemas/MedicareSurtaxEstimate'
        self_employment_tax:
          $ref: '#/components/schemas/SelfEmploymentTaxEstimate'
        employment_tax:
          $ref: '#/components/schemas/EmploymentTaxEstimate'
        alternative_minimum_tax:
          type: number
          format: double
          nullable: true
          description: Alternative minimum tax
        tax_amount_without_tax_credit:
          type: number
          format: double
          nullable: true
          description: Federal tax amount prior to any tax credits being applied
        dependent_tax_credit:
          type: number
          format: double
          nullable: true
          description: >-
            Total amount of federal dependent tax credits that the user
            qualifies for
        total_tax_credit:
          type: number
          format: double
          nullable: true
          description: Total of all federal tax credits that the user qualifies for
        total_tax_credit_applied_to_tax:
          type: number
          format: double
          nullable: true
          description: Total of all federal tax credits applied
        tax_before_withholding:
          type: number
          format: double
          nullable: true
          description: Total taxes due federally before withholding is applied
        effective_tax_rate_before_withholding:
          type: number
          format: double
          nullable: true
          description: >-
            Effective tax rate from all taxes due federally before withholding
            is applied including medicare and social security
        withholding_applied_to_tax:
          type: number
          format: double
          nullable: true
          description: Amount of withholding applied to taxes
        tax_amount:
          type: number
          format: double
          nullable: true
          description: Total taxes due federally
        tax_unpaid:
          type: number
          format: double
          nullable: true
          description: >-
            Remaining federal tax amount to be paid (after withholding and
            payments)
        effective_tax_rate:
          type: number
          format: double
          nullable: true
          description: >-
            Effective tax rate from all taxes due federally including medicare
            and social security
    UsStateTaxEstimate:
      type: object
      nullable: true
      description: US State tax estimate details
      properties:
        w2_marginal_tax_rate:
          type: number
          format: double
          nullable: true
          description: Marginal tax rate for W-2 income
        business_marginal_tax_rate:
          type: number
          format: double
          nullable: true
          description: Marginal tax rate for self-employed income
        adjusted_gross_income:
          type: number
          format: double
          nullable: true
          description: Adjusted gross income
        state_deduction:
          type: number
          format: double
          nullable: true
          description: Deduction amount applied to state taxes
        taxable_income:
          type: number
          format: double
          nullable: true
          description: State taxable income
        pre_credit_effective_tax_rate:
          type: number
          format: double
          nullable: true
          description: Effective tax rate before any credits are applied
        tax_amount_without_tax_credit:
          type: number
          format: double
          nullable: true
          description: State tax amount prior to any tax credits being applied
        total_tax_credit:
          type: number
          format: double
          nullable: true
          description: Total of all state tax credits that the user qualifies for
        total_tax_credit_applied_to_tax:
          type: number
          format: double
          nullable: true
          description: Total of all state tax credits applied
        tax_before_withholding:
          type: number
          format: double
          nullable: true
          description: Taxes due to the state before withholding
        effective_tax_rate_before_withholding:
          type: number
          format: double
          nullable: true
          description: Effective tax rate of taxes due to the state before withholding
        withholding_applied_to_tax:
          type: number
          format: double
          nullable: true
          description: Amount of withholding applied to taxes
        tax_amount:
          type: number
          format: double
          nullable: true
          description: Total taxes due to the state
        tax_unpaid:
          type: number
          format: double
          nullable: true
          description: >-
            Remaining state tax amount to be paid (after withholding and
            payments)
        effective_tax_rate:
          type: number
          format: double
          nullable: true
          description: Effective tax rate of taxes due to the state
    UsQuarterlyEstimates:
      type: object
      nullable: true
      description: US quarterly tax estimates
      properties:
        q1:
          $ref: '#/components/schemas/QuarterlyEstimate'
        q2:
          $ref: '#/components/schemas/QuarterlyEstimate'
        q3:
          $ref: '#/components/schemas/QuarterlyEstimate'
        q4:
          $ref: '#/components/schemas/QuarterlyEstimate'
    MedicareSurtaxEstimate:
      type: object
      nullable: true
      description: Medicare surtax estimate details
      properties:
        amount:
          type: number
          format: double
          nullable: true
          description: Medicare surtax amount
        rate:
          type: number
          format: double
          nullable: true
          description: Medicare surtax rate
    SelfEmploymentTaxEstimate:
      type: object
      nullable: true
      description: Self-employment tax estimate details
      properties:
        amount:
          type: number
          format: double
          nullable: true
          description: Self-employment tax amount
        rate:
          type: number
          format: double
          nullable: true
          description: Self-employment tax rate
        social_security_tax:
          type: number
          format: double
          nullable: true
          description: Social security portion of self-employment tax
        medicare_tax:
          type: number
          format: double
          nullable: true
          description: Medicare portion of self-employment tax
    EmploymentTaxEstimate:
      type: object
      nullable: true
      description: Employment tax estimate details
      properties:
        social_security_taxable_income:
          type: number
          format: double
          nullable: true
          description: Taxable income for social security
        social_security_effective_tax_rate:
          type: number
          format: double
          nullable: true
          description: Social security effective tax rate
        social_security_tax:
          type: number
          format: double
          nullable: true
          description: Social security tax estimate paid by employer
        medicare_taxable_income:
          type: number
          format: double
          nullable: true
          description: Taxable income for medicare
        medicare_effective_tax_rate:
          type: number
          format: double
          nullable: true
          description: Medicare effective tax rate
        medicare_tax:
          type: number
          format: double
          nullable: true
          description: Medicare tax estimate paid by employer
        tax_amount:
          type: number
          format: double
          nullable: true
          description: Overall employment tax amount
    QuarterlyEstimate:
      type: object
      nullable: true
      description: Tax estimate for a single quarter
      properties:
        due_date:
          type: string
          format: date
          nullable: true
          description: Due date for this quarter's payment
        federal_tax:
          $ref: '#/components/schemas/QuarterlyTaxAmount'
        state_tax:
          $ref: '#/components/schemas/QuarterlyTaxAmount'
    QuarterlyTaxAmount:
      type: object
      nullable: true
      description: Tax amount details for a quarter
      properties:
        amount:
          type: number
          format: double
          nullable: true
          description: Tax amount for this quarter
        paid:
          type: number
          format: double
          nullable: true
          description: Amount already paid for this quarter
        remaining:
          type: number
          format: double
          nullable: true
          description: Remaining amount due for this quarter
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````