Skip to main content
GET
Get tax overview
To enable the Tax Estimates feature for your customers, request access from your Layer representative.
Returns the highest-level tax roll-up for top-of-dashboard display. This is the lightest of the Tax Estimates endpoints; use it for headline numbers, and use Get tax details for the itemized calculation behind them.

What the numbers mean

Each field is derived from the same calculation as Get tax details, rolled up:
  • total_income: total business income (Schedule C revenue) plus any W-2/other income included in the calculation, in cents.
  • total_deductions: total deductions applied (business expenses, vehicle, home office, qualified tip/overtime, self-employment tax deduction), in cents.
  • taxable_income_estimate: the estimated taxable income after deductions, in cents.
  • estimated_taxes_owed: total projected tax liability (federal + state), in cents.
  • taxes_due_date: the next tax deadline in ISO-8601 date format.

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

Tax overview for the specified year.

data
object
required

High-level tax summary for dashboard display. Use GET /v1/businesses/{businessId}/tax-estimates/details for itemized breakdowns.