Skip to main content
GET
Get tax payments
To enable the Tax Estimates feature for your customers, request access from your Layer representative.
Returns the quarterly estimated tax payment history for the year, including roll-overs from prior quarters. Use this to show what has been paid and what remains due each quarter; for the underlying liability calculation, use Get tax details.

Quarterly payment calculation

Each quarter in quarters reflects the split of the annual projected liability (from Get tax details) into four estimated payments, combined with the actual payments the business has recorded. Note: Federal tax periods are not all the same length, and quarterly tax estimates are not equal across all quarters in a year.
  • owed_this_quarter: the projected liability allocated to this quarter, in cents.
  • total_paid: payments already recorded against this quarter, in cents.
  • owed_rolled_over_from_previous: the unpaid balance (positive) or overpayment (negative) carried forward from the previous quarter, in cents.
  • total: the net balance for the quarter, in cents, accounting for this quarter’s owed amount, prior roll-overs, and payments made.
Typical federal quarterly due dates are April 15, June 15, September 15, and January 15 of the following year; state due dates may differ and are returned per quarter via Get tax details.

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 payments for the specified year.

data
object
required

Quarterly tax payment history and tracking.