Tax Filing API
Complete tax preparation, calculation, and e-filing infrastructure with IRS-compliant forms and real-time validation
On this page
Overview
The Tax Filing API provides comprehensive tax preparation and e-filing capabilities. Calculate taxes in real-time, generate IRS forms, and submit returns electronically with full audit trail support.
Real-time Calculation
Instant tax calculations using current IRS tax tables
Form Generation
Generate 1040, W-2, 1099, and 50+ other tax forms
E-File Integration
Direct IRS e-file with acknowledgment tracking
API Endpoints
/v1/tax/calculateCalculate federal and state tax liability with real-time IRS rate tables
/v1/tax/forms/1040Generate and prefill Form 1040 with taxpayer data
/v1/tax/efileE-file tax returns directly to IRS via TaxBandits integration
/v1/tax/status/:filingIdCheck e-filing status and retrieve acknowledgment codes
/v1/tax/refund/estimateEstimate tax refund amount based on income and deductions
/v1/tax/quarterly-estimatesCalculate quarterly estimated tax payments for self-employed
Code Examples
Calculate Federal Tax
// Calculate federal tax liability
const taxu = require('@taxu/taxu-js')('your_api_key');
const result = await taxu.tax.calculate({
filingStatus: 'single',
income: 75000,
deductions: {
standard: true,
itemized: []
},
credits: {
childTaxCredit: 0,
earnedIncomeCredit: 0
},
taxYear: 2024
});
console.log(result);
// {
// taxLiability: 9488,
// effectiveRate: 12.65,
// marginalRate: 22,
// refundAmount: 0,
// breakdown: {
// federalTax: 9488,
// socialSecurity: 4650,
// medicare: 1088
// }
// }E-File Tax Return
// Submit tax return for e-filing
const filing = await taxu.tax.efile({
taxpayer: {
ssn: '123-45-6789',
firstName: 'John',
lastName: 'Doe',
dateOfBirth: '1985-06-15',
address: {
street: '123 Main St',
city: 'New York',
state: 'NY',
zip: '10001'
}
},
form1040: {
wages: 75000,
interest: 250,
dividends: 500,
standardDeduction: 13850,
taxWithheld: 9500
},
directDeposit: {
routingNumber: '021000021',
accountNumber: '1234567890',
accountType: 'checking'
}
});
console.log(filing);
// {
// id: 'fil_1234567890',
// status: 'submitted',
// submittedAt: '2024-04-15T10:30:00Z',
// acknowledgmentCode: 'ACK123456',
// estimatedRefund: 12,
// refundDate: '2024-05-01'
// }Webhooks
Subscribe to real-time e-filing status updates and IRS acknowledgment notifications:
tax.filing.submittedReturn submitted to IRS
tax.filing.acceptedIRS accepted the return
tax.filing.rejectedIRS rejected the return with error codes