> ## 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 details

> Returns detailed breakdown of tax calculations including adjusted gross income, deductions, and federal taxes.



## OpenAPI

````yaml get /v1/businesses/{businessId}/tax-estimates/details
openapi: 3.0.1
info:
  title: API
  version: latest
servers: []
security:
  - BearerAuth: []
tags: []
externalDocs:
  url: /
paths:
  /v1/businesses/{businessId}/tax-estimates/details:
    get:
      tags:
        - Tax Estimates
      summary: Get tax details
      description: >-
        Returns detailed breakdown of tax calculations including adjusted gross
        income, deductions, and federal taxes.
      operationId: business.tax-estimates.details.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). Supported years: 2024-2026.'
          required: true
          schema:
            type: integer
            format: int32
        - name: reporting_basis
          in: query
          description: >-
            The accounting basis for reporting. Defaults to the business's
            default reporting basis, or CASH if not set.
          required: false
          schema:
            type: string
            enum:
              - ACCRUAL
              - CASH
            default: CASH
        - name: full_year_projection
          in: query
          description: >-
            Whether to project income/expenses for the full year based on
            year-to-date data. Only applicable for the current year. Defaults to
            true.
          required: false
          schema:
            type: boolean
            default: false
        - name: Content-Type
          in: header
          description: Content-Type must be set to application/json
          schema:
            type: string
      responses:
        '200':
          description: Detailed tax breakdown
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTaxDetails'
        '404':
          description: Business not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      deprecated: false
components:
  schemas:
    ApiTaxDetails:
      type: object
      properties:
        type:
          type: string
          description: Resource type.
          example: Tax_Details
        year:
          type: integer
          format: int32
          description: The tax year for this details breakdown.
          example: 2025
        filing_status:
          type: string
          description: Tax filing status.
          example: SINGLE
        adjusted_gross_income:
          $ref: '#/components/schemas/ApiAdjustedGrossIncome'
        taxes:
          $ref: '#/components/schemas/ApiTaxes'
        quarterly_estimates:
          $ref: '#/components/schemas/ApiQuarterlyEstimates'
      description: >-
        Detailed breakdown of tax calculations including adjusted gross income,
        deductions, and federal taxes.
    ApiError:
      type: object
      properties: {}
      example: ''
      description: ''
    ApiAdjustedGrossIncome:
      type: object
      properties:
        income:
          $ref: '#/components/schemas/ApiIncome'
        deductions:
          $ref: '#/components/schemas/ApiDeductions'
        total_adjusted_gross_income:
          type: integer
          format: int64
          description: Total adjusted gross income, in cents.
      description: Adjusted gross income breakdown including income and deductions.
    ApiTaxes:
      type: object
      properties:
        us_federal:
          $ref: '#/components/schemas/ApiUsFederalTax'
          nullable: true
        us_state:
          $ref: '#/components/schemas/ApiUsStateTax'
          nullable: true
      description: Tax calculations breakdown including federal and state taxes.
    ApiQuarterlyEstimates:
      type: object
      properties:
        q1:
          $ref: '#/components/schemas/ApiQuarterEstimate'
        q2:
          $ref: '#/components/schemas/ApiQuarterEstimate'
        q3:
          $ref: '#/components/schemas/ApiQuarterEstimate'
        q4:
          $ref: '#/components/schemas/ApiQuarterEstimate'
      description: Quarterly tax estimates breakdown.
    ApiIncome:
      type: object
      properties:
        w2_income:
          type: integer
          format: int64
          description: W-2 wage income, in cents.
        w2_withholding:
          type: integer
          format: int64
          description: W-2 tax withholding, in cents.
        business_revenue:
          type: integer
          format: int64
          description: Business revenue from Schedule C, in cents.
        total:
          type: integer
          format: int64
          description: Total income, in cents.
      description: Income breakdown.
    ApiDeductions:
      type: object
      properties:
        business_expenses:
          type: integer
          format: int64
          description: Total business expenses, in cents.
        vehicle_expense:
          $ref: '#/components/schemas/ApiVehicleExpense'
        home_office:
          $ref: '#/components/schemas/ApiHomeOffice'
        qualified_tip_deduction:
          type: integer
          format: int64
          description: Qualified tip income deduction, in cents.
        qualified_overtime_deduction:
          type: integer
          format: int64
          description: Qualified overtime income deduction, in cents.
        self_employment_tax_deduction:
          type: integer
          format: int64
          description: Deductible portion of self-employment tax, in cents.
        total:
          type: integer
          format: int64
          description: Total deductions, in cents.
      description: Deductions breakdown.
    ApiUsFederalTax:
      type: object
      properties:
        federal_income_tax:
          $ref: '#/components/schemas/ApiFederalIncomeTax'
        social_security_tax:
          $ref: '#/components/schemas/ApiSocialSecurityTax'
        medicare_tax:
          $ref: '#/components/schemas/ApiMedicareTax'
        medicare_surtax:
          $ref: '#/components/schemas/ApiMedicareSurtax'
        total_federal_tax:
          $ref: '#/components/schemas/ApiTotalFederalTax'
      description: US Federal tax breakdown.
    ApiUsStateTax:
      type: object
      properties:
        state_code:
          type: string
          description: Two-letter state code.
          example: CA
        state_name:
          type: string
          description: Full state name.
          example: California
        filing_status:
          type: string
          description: State tax filing status.
          example: SINGLE
        state_income_tax:
          $ref: '#/components/schemas/ApiStateIncomeTax'
        additional_taxes:
          type: array
          items:
            $ref: '#/components/schemas/ApiStateAdditionalTax'
          description: Additional state-specific taxes (e.g., SDI, mental health tax).
        total_state_tax:
          $ref: '#/components/schemas/ApiTotalStateTax'
      description: US State tax breakdown.
    ApiQuarterEstimate:
      type: object
      properties:
        us_federal:
          $ref: '#/components/schemas/ApiQuarterFederalTax'
          nullable: true
        us_state:
          $ref: '#/components/schemas/ApiQuarterStateTax'
          nullable: true
      description: Tax estimate for a single quarter including federal and state taxes.
    ApiVehicleExpense:
      type: object
      properties:
        method:
          type: string
          description: Vehicle expense calculation method.
          example: MILEAGE
        amount:
          type: integer
          format: int64
          description: Vehicle expense deduction amount, in cents.
      description: Vehicle expense deduction details.
    ApiHomeOffice:
      type: object
      properties:
        method:
          type: string
          description: Home office deduction calculation method.
          example: SIMPLIFIED
        amount:
          type: integer
          format: int64
          description: Home office deduction amount, in cents.
      description: Home office deduction details.
    ApiFederalIncomeTax:
      type: object
      properties:
        federal_deductions:
          type: integer
          format: int64
          description: Federal deductions (standard deduction), in cents.
        qualified_business_income_deduction:
          type: integer
          format: int64
          description: Qualified Business Income (QBI) deduction, in cents.
        qbi_effective_rate:
          type: string
          description: Effective QBI deduction rate after phase-out.
          example: '0.20'
        taxable_income:
          type: integer
          format: int64
          description: Taxable income after deductions, in cents.
        effective_federal_tax_rate:
          type: string
          description: Effective federal income tax rate.
          example: '0.22'
        federal_income_tax_owed:
          type: integer
          format: int64
          description: Federal income tax owed, in cents.
      description: Federal income tax calculation details.
    ApiSocialSecurityTax:
      type: object
      properties:
        social_security_income:
          type: integer
          format: int64
          description: Income subject to Social Security tax, in cents.
        social_security_tax_rate:
          type: string
          description: Social Security tax rate.
          example: '0.124'
        social_security_tax_owed:
          type: integer
          format: int64
          description: Social Security tax owed, in cents.
      description: Social Security tax calculation details.
    ApiMedicareTax:
      type: object
      properties:
        medicare_income:
          type: integer
          format: int64
          description: Income subject to Medicare tax, in cents.
        medicare_tax_rate:
          type: string
          description: Medicare tax rate.
          example: '0.029'
        medicare_tax_owed:
          type: integer
          format: int64
          description: Medicare tax owed, in cents.
      description: Medicare tax calculation details.
    ApiMedicareSurtax:
      type: object
      properties:
        medicare_surtax_income:
          type: integer
          format: int64
          description: Income subject to Medicare surtax (above threshold), in cents.
        medicare_surtax_rate:
          type: string
          description: Medicare surtax rate (0.9% for high earners).
          example: '0.009'
        medicare_surtax_owed:
          type: integer
          format: int64
          description: Medicare surtax owed, in cents.
      description: Medicare surtax calculation details for high earners.
    ApiTotalFederalTax:
      type: object
      properties:
        federal_income_tax_owed:
          type: integer
          format: int64
          description: Federal income tax owed, in cents.
        social_security_tax_owed:
          type: integer
          format: int64
          description: Social Security tax owed, in cents.
        medicare_tax_owed:
          type: integer
          format: int64
          description: Medicare tax owed, in cents.
        medicare_surtax_owed:
          type: integer
          format: int64
          description: Medicare surtax owed, in cents.
        w2_withholdings:
          type: integer
          format: int64
          description: W-2 tax withholdings already paid, in cents.
        total_federal_tax_owed:
          type: integer
          format: int64
          description: >-
            Total federal tax owed after withholdings, in cents. Can be negative
            if refund is due.
      description: Total federal tax summary.
    ApiStateIncomeTax:
      type: object
      properties:
        state_agi:
          type: integer
          format: int64
          description: State adjusted gross income, in cents.
        state_deductions:
          type: integer
          format: int64
          description: State deductions (standard or itemized), in cents.
        state_taxable_income:
          type: integer
          format: int64
          description: State taxable income after deductions, in cents.
        effective_state_tax_rate:
          type: string
          description: Effective state income tax rate.
          example: '0.093'
        state_income_tax_owed:
          type: integer
          format: int64
          description: State income tax owed, in cents.
      description: State income tax calculation details.
    ApiStateAdditionalTax:
      type: object
      properties:
        tax_name:
          type: string
          description: Name of the additional tax.
          example: CA SDI
        tax_rate:
          type: string
          description: Tax rate for this additional tax.
          example: '0.011'
        taxable_amount:
          type: integer
          format: int64
          description: Amount subject to this tax, in cents.
        tax_owed:
          type: integer
          format: int64
          description: Amount of this additional tax owed, in cents.
      description: Additional state-specific tax details.
    ApiTotalStateTax:
      type: object
      properties:
        state_income_tax_owed:
          type: integer
          format: int64
          description: State income tax owed, in cents.
        additional_taxes_owed:
          type: integer
          format: int64
          description: Total additional state taxes owed, in cents.
        state_withholdings:
          type: integer
          format: int64
          description: State tax withholdings already paid, in cents.
        total_state_tax_owed:
          type: integer
          format: int64
          description: >-
            Total state tax owed after withholdings, in cents. Can be negative
            if refund is due.
      description: Total state tax summary.
    ApiQuarterFederalTax:
      type: object
      properties:
        due_date:
          type: string
          format: date
          description: Due date for this quarter's payment.
          example: '2025-04-15'
        owed:
          type: integer
          format: int64
          description: Amount owed for this quarter, in cents.
        paid:
          type: integer
          format: int64
          description: Amount already paid for this quarter, in cents.
        balance:
          type: integer
          format: int64
          description: Remaining balance for this quarter (owed - paid), in cents.
      description: Federal tax details for a single quarter.
    ApiQuarterStateTax:
      type: object
      properties:
        state_code:
          type: string
          description: Two-letter state code.
          example: CA
        due_date:
          type: string
          format: date
          description: Due date for this quarter's state payment.
          example: '2025-04-15'
        owed:
          type: integer
          format: int64
          description: State tax amount owed for this quarter, in cents.
        paid:
          type: integer
          format: int64
          description: State tax amount already paid for this quarter, in cents.
        balance:
          type: integer
          format: int64
          description: >-
            Remaining state tax balance for this quarter (owed - paid), in
            cents.
      description: State tax details for a single quarter.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````