Skip to main content
GET
/
v1
/
businesses
/
{businessId}
/
tax-estimates
/
overview
Get tax overview
curl --request GET \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/tax-estimates/overview \
  --header 'Authorization: Bearer <token>'
{
  "type": "Tax_Overview",
  "year": 2025,
  "excludes_pending_transactions": true,
  "taxable_income_estimate": 123,
  "total_income": 123,
  "total_deductions": 123,
  "estimated_taxes_owed": 123,
  "taxes_due_date": "2025-04-15"
}

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 true.

Response

Tax overview for the specified year

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

type
string

Resource type.

Example:

"Tax_Overview"

year
integer<int32>

The tax year for this overview.

Example:

2025

excludes_pending_transactions
boolean

Whether pending transactions are excluded from the calculations.

taxable_income_estimate
integer<int64>

Taxable income estimate to date, in cents.

total_income
integer<int64>

Total business income, in cents.

total_deductions
integer<int64>

Total deductions, in cents.

estimated_taxes_owed
integer<int64>

Total estimated tax liability, in cents.

taxes_due_date
string<date>

Next tax deadline in ISO-8601 date format.

Example:

"2025-04-15"