Get tax details

curl --request GET \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "type": "Tax_Details",
    "year": 2025,
    "filing_status": "SINGLE",
    "adjusted_gross_income": {
      "income": {
        "w2_income": 123,
        "w2_withholding": 123,
        "business_revenue": 123,
        "total": 123
      },
      "deductions": {
        "business_expenses": 123,
        "vehicle_expense": {
          "method": "MILEAGE",
          "amount": 123
        },
        "home_office": {
          "method": "SIMPLIFIED",
          "amount": 123
        },
        "qualified_tip_deduction": 123,
        "qualified_overtime_deduction": 123,
        "self_employment_tax_deduction": 123,
        "total": 123
      },
      "total_adjusted_gross_income": 123
    },
    "taxes": {
      "us_federal": {
        "federal_income_tax": {
          "federal_deductions": 123,
          "qualified_business_income_deduction": 123,
          "qbi_effective_rate": "0.20",
          "taxable_income": 123,
          "effective_federal_tax_rate": "0.22",
          "federal_income_tax_owed": 123
        },
        "social_security_tax": {
          "social_security_income": 123,
          "social_security_tax_rate": "0.124",
          "social_security_tax_owed": 123
        },
        "medicare_tax": {
          "medicare_income": 123,
          "medicare_tax_rate": "0.029",
          "medicare_tax_owed": 123
        },
        "medicare_surtax": {
          "medicare_surtax_income": 123,
          "medicare_surtax_rate": "0.009",
          "medicare_surtax_owed": 123
        },
        "total_federal_tax": {
          "federal_income_tax_owed": 123,
          "social_security_tax_owed": 123,
          "medicare_tax_owed": 123,
          "medicare_surtax_owed": 123,
          "w2_withholdings": 123,
          "total_federal_tax_owed": 123
        }
      },
      "us_state": {
        "state_code": "CA",
        "state_name": "California",
        "filing_status": "SINGLE",
        "state_income_tax": {
          "state_agi": 123,
          "state_deductions": 123,
          "state_taxable_income": 123,
          "effective_state_tax_rate": "0.093",
          "state_income_tax_owed": 123
        },
        "additional_taxes": [
          {
            "tax_name": "CA SDI",
            "tax_rate": "0.011",
            "taxable_amount": 123,
            "tax_owed": 123
          }
        ],
        "total_state_tax": {
          "state_income_tax_owed": 123,
          "additional_taxes_owed": 123,
          "state_withholdings": 123,
          "total_state_tax_owed": 123
        }
      }
    },
    "quarterly_estimates": {
      "q1": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      },
      "q2": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      },
      "q3": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      },
      "q4": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      }
    }
  }
}

{
  "type": "InvalidParameters",
  "description": "<string>",
  "error_enum": "InvalidPayload",
  "meta": {}
}

GET

businesses

{businessId}

tax-estimates

details

Get tax details

curl --request GET \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "type": "Tax_Details",
    "year": 2025,
    "filing_status": "SINGLE",
    "adjusted_gross_income": {
      "income": {
        "w2_income": 123,
        "w2_withholding": 123,
        "business_revenue": 123,
        "total": 123
      },
      "deductions": {
        "business_expenses": 123,
        "vehicle_expense": {
          "method": "MILEAGE",
          "amount": 123
        },
        "home_office": {
          "method": "SIMPLIFIED",
          "amount": 123
        },
        "qualified_tip_deduction": 123,
        "qualified_overtime_deduction": 123,
        "self_employment_tax_deduction": 123,
        "total": 123
      },
      "total_adjusted_gross_income": 123
    },
    "taxes": {
      "us_federal": {
        "federal_income_tax": {
          "federal_deductions": 123,
          "qualified_business_income_deduction": 123,
          "qbi_effective_rate": "0.20",
          "taxable_income": 123,
          "effective_federal_tax_rate": "0.22",
          "federal_income_tax_owed": 123
        },
        "social_security_tax": {
          "social_security_income": 123,
          "social_security_tax_rate": "0.124",
          "social_security_tax_owed": 123
        },
        "medicare_tax": {
          "medicare_income": 123,
          "medicare_tax_rate": "0.029",
          "medicare_tax_owed": 123
        },
        "medicare_surtax": {
          "medicare_surtax_income": 123,
          "medicare_surtax_rate": "0.009",
          "medicare_surtax_owed": 123
        },
        "total_federal_tax": {
          "federal_income_tax_owed": 123,
          "social_security_tax_owed": 123,
          "medicare_tax_owed": 123,
          "medicare_surtax_owed": 123,
          "w2_withholdings": 123,
          "total_federal_tax_owed": 123
        }
      },
      "us_state": {
        "state_code": "CA",
        "state_name": "California",
        "filing_status": "SINGLE",
        "state_income_tax": {
          "state_agi": 123,
          "state_deductions": 123,
          "state_taxable_income": 123,
          "effective_state_tax_rate": "0.093",
          "state_income_tax_owed": 123
        },
        "additional_taxes": [
          {
            "tax_name": "CA SDI",
            "tax_rate": "0.011",
            "taxable_amount": 123,
            "tax_owed": 123
          }
        ],
        "total_state_tax": {
          "state_income_tax_owed": 123,
          "additional_taxes_owed": 123,
          "state_withholdings": 123,
          "total_state_tax_owed": 123
        }
      }
    },
    "quarterly_estimates": {
      "q1": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      },
      "q2": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      },
      "q3": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      },
      "q4": {
        "us_federal": {
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        },
        "us_state": {
          "state_code": "CA",
          "due_date": "2025-04-15",
          "owed": 123,
          "paid": 123,
          "balance": 123
        }
      }
    }
  }
}

{
  "type": "InvalidParameters",
  "description": "<string>",
  "error_enum": "InvalidPayload",
  "meta": {}
}

To enable the Tax Estimates feature for your customers, request access from your Layer representative.

Returns the full itemized breakdown of how a business’s projected tax liability is calculated for the year. This is the most detailed of the Tax Estimates endpoints; use it when you need to show or reconcile the individual components behind the numbers surfaced by Get tax summary and Get tax overview.

Inputs to tax calculation

The calculation combines two sources:

The business’s tax profile: filing status, W-2 income, tip/overtime income, withholding, state, deductions configuration (home office, vehicle/mileage), and any user-estimated business revenue/expense overrides.
The business’s year-to-date financials on the requested reporting_basis: business revenue and deductible expenses are pulled from the same P&L data that powers the P&L report.

When full_year_projection=true, year-to-date income and expenses are projected forward to estimate a full-year figure before taxes are computed. The parameter defaults to false, so you must opt in to projection. For past years, the calculation always uses actual full-year data and full_year_projection has no effect. All monetary fields in the response are in cents.

Income and expense calculation

Business revenue and deductible expenses are not pulled from the P&L directly. They are derived from the Schedule C report, which maps each categorized ledger account to a specific IRS Schedule C line. You can fetch that raw line-item report yourself with the Schedule C report endpoint. Income (taxable business revenue) comes from Schedule C Part I:

Line 1 (Gross receipts) minus Line 2 (Returns and allowances), plus Line 6 (Other income).

Deductible expenses come from Schedule C Part II (operating expenses), Part III (cost of goods sold), Part V (other expenses), and Schedule A (charitable contributions). The vehicle expense (Line 9) is pulled out separately so the calculation can apply the mileage vs. actual-expense method from the tax profile; see vehicle_expense in the deductions breakdown above. Categories excluded from the tax calculation are those mapped to non-applicable Schedule C boxes:

Equity accounts (owner’s draw, capital contributions, personal expenses).
Non-deductible items (accounts explicitly marked non-deductible).
Capitalized assets (these belong on the balance sheet, not the P&L).
Clearing and liability accounts (temporary or non-business accounts).
Uncategorized expenses awaiting review (see Pending and uncategorized transactions below).

One special rule: meals are reduced by 50% per IRS rules before being counted as a deductible expense.

Pending and uncategorized transactions

Only categorized transactions appear in the Schedule C report and therefore in the tax calculation. Transactions that have not yet been categorized do not have ledger entries and are implicitly excluded from every income and expense figure in this response. There is no query parameter to include pending transactions in the calculation. total_income, total_deductions and every downstream number can shift as the user categorizes more transactions. To surface the amounts that are currently missing from the calculation, use Get tax checklist, which returns the uncategorized deduction and deposit totals with counts.

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.

Query Parameters

year

integer<int32>

required

The tax year (e.g., 2025). Supported years: 2024-2026.

reporting_basis

enum<string>

default:CASH

The accounting basis for reporting. Defaults to the business's default reporting basis, or CASH if not set.

Available options:

ACCRUAL,

CASH

full_year_projection

boolean

default:false

Whether to project income/expenses for the full year based on year-to-date data. Only applicable for the current year. Defaults to false.

Response

Detailed tax breakdown.

data

object

required

Detailed breakdown of tax calculations including adjusted gross income, deductions, and federal taxes.

Show child attributes

⌘I

Businesses

Financial Activity

Accounting Reports

Platform Configuration

Activity Metrics

Integrations

Get tax details

Inputs to tax calculation

Income and expense calculation

Pending and uncategorized transactions

Authorizations

Headers

Path Parameters

Query Parameters

Response

​Inputs to tax calculation

​Income and expense calculation

​Pending and uncategorized transactions

Authorizations

Headers

Path Parameters

Query Parameters

Response

Inputs to tax calculation

Income and expense calculation

Pending and uncategorized transactions