Developers/Docs/API/Tax Filing

Tax Filing API

Complete tax preparation, calculation, and e-filing infrastructure with IRS-compliant forms and real-time validation

IRS Certified
Our e-file provider is IRS-authorized with 99.8% acceptance rate

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

POST
/v1/tax/calculate

Calculate federal and state tax liability with real-time IRS rate tables

POST
/v1/tax/forms/1040

Generate and prefill Form 1040 with taxpayer data

POST
/v1/tax/efile

E-file tax returns directly to IRS via TaxBandits integration

GET
/v1/tax/status/:filingId

Check e-filing status and retrieve acknowledgment codes

POST
/v1/tax/refund/estimate

Estimate tax refund amount based on income and deductions

POST
/v1/tax/quarterly-estimates

Calculate 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.submitted

    Return submitted to IRS

  • tax.filing.accepted

    IRS accepted the return

  • tax.filing.rejected

    IRS rejected the return with error codes