At a Glance
What Constitutes High-Volume Filing?
For the purposes of this guide, "high-volume" means filing 10,000 or more information returns per tax year. At this scale, the IRIS Taxpayer Portal (manual entry) and CSV upload become impractical. You need the IRIS A2A API or a filing service built for volume.
High-volume filers include banks and financial institutions filing hundreds of thousands of 1099-INT and 1099-DIV forms, payroll service bureaus processing 1099-NEC and 1099-MISC on behalf of clients, large CPA firms handling enterprise-level filing, insurance companies filing 1099-R and 5498-SA, and payment processors filing 1099-K at scale.
IRIS Capacity and Throughput
The IRIS A2A API is designed to handle high volumes, but it operates under constraints that large filers must plan around:
- Submission batching: IRIS processes submissions in batches. Each batch contains a set of returns that the system validates and acknowledges as a unit.
- Rate limiting: The A2A API enforces rate limits to prevent any single filer from overwhelming the system, especially during peak filing periods (January through March).
- Peak season congestion: Like FIRE before it, IRIS experiences the highest load in the weeks before filing deadlines. Processing times increase during these windows.
- Asynchronous acknowledgments: IRIS does not provide instant acceptance/rejection. Submissions are queued and processed, with acknowledgments returned asynchronously — sometimes within minutes, sometimes within hours during peak periods.
A2A API Best Practices for Bulk Filing
Batch Sizing
The optimal batch size balances throughput against error isolation. Key considerations:
- Target 500–1,000 returns per batch. Smaller batches mean faster acknowledgments and easier error isolation. Larger batches are slightly more efficient on network overhead but harder to troubleshoot when errors occur.
- Never exceed the IRS maximum batch size. The A2A API defines a maximum number of returns per submission. Exceeding it causes the entire submission to reject.
- Group by payer TIN. Each batch should contain returns for a single payer. Mixing payers in one batch complicates error handling and acknowledgment tracking.
- Group by form type. Don't mix 1099-NEC and 1099-MISC in the same batch. Keeping batches homogeneous simplifies validation and retry logic.
Rate Limiting and Throttling
Respect the IRIS rate limits or risk having your submissions throttled or temporarily blocked:
- Implement exponential backoff. If a request returns a rate-limit error (HTTP 429), wait before retrying. Double the wait time with each consecutive failure, up to a maximum backoff period.
- Spread submissions over time. Don't attempt to file 500,000 returns in a single hour. Distribute submissions across hours or days, especially during peak season.
- Monitor response times. If IRIS response latency increases, reduce your submission rate proactively rather than waiting for explicit rate-limit errors.
Parallel Submissions
The A2A API supports concurrent connections, but parallelism must be managed carefully:
- Limit concurrent connections to the number supported by your IRIS TCC. Exceeding the connection limit causes authentication failures.
- Use separate batches per thread. Each parallel thread should submit its own independent batch. Never split a single batch across threads.
- Coordinate acknowledgment polling. If multiple threads are submitting simultaneously, centralize your acknowledgment tracking to avoid duplicate processing or missed results.
Ready to discuss your enterprise compliance needs?
Our compliance experts can walk you through a customized solution for your organization.
Retry Logic
At enterprise scale, transient failures are inevitable. Build robust retry handling:
- Distinguish transient from permanent errors. Network timeouts and HTTP 500 errors are retryable. Schema validation errors (HTTP 400) are not — the data must be fixed before resubmission.
- Track retry counts per batch. Set a maximum retry limit (e.g., 3 attempts) before escalating to manual review.
- Log everything. At high volume, you need detailed logs of every submission attempt, response, and acknowledgment to troubleshoot issues.
Error Handling at Scale
When you're filing hundreds of thousands of returns, even a 1% error rate means thousands of records to investigate. Strategies for managing errors at scale:
- Pre-validate before submission. Run your data through validation rules (TIN format, amount ranges, required fields, state codes) before sending to IRIS. Catching errors locally is cheaper than processing rejections from the IRS.
- Categorize errors. Group rejected records by error type (invalid TIN, missing amount, schema violation) and fix them in bulk rather than one at a time.
- Automate resubmission. After fixing a batch of errors, resubmit automatically rather than manually. Your pipeline should handle corrected resubmission as a standard workflow step.
- Track corrections separately. Corrections filed after the original acceptance are a different workflow than error resubmissions. Keep them separate in your tracking system.
Acknowledgment Tracking
For high-volume filers, acknowledgment tracking is a critical infrastructure component:
- Poll for acknowledgments systematically. Build a scheduled process that checks for pending acknowledgments at regular intervals.
- Match acknowledgments to submissions. Use the submission IDs returned by the A2A API to correlate acknowledgments back to specific batches and records.
- Alert on failures. Set up monitoring that triggers alerts when rejection rates exceed a threshold (e.g., more than 2% of a batch rejected).
- Archive acknowledgment data. IRS acknowledgments serve as your proof of filing. Store them durably for audit purposes — you may need them years later.
DIY Bulk IRIS vs. Using BoomTax
Building your own high-volume IRIS filing infrastructure is a significant engineering investment. Here's how it compares to using BoomTax:
| Consideration | DIY A2A API | BoomTax |
|---|---|---|
| Setup time | 3–6 months of development | Same-day onboarding |
| TCC required | Yes (45+ day application) | No — BoomTax files under its own TCC |
| FIRE file support | Must build conversion layer | Accepts FIRE files as-is |
| Error handling | Must build monitoring and retry | Built-in validation and error recovery |
| Peak season scaling | Your infrastructure must scale | BoomTax handles scaling |
| Ongoing maintenance | IRS schema updates, security patches | BoomTax maintains compliance |
| Volume capacity | Limited by your TCC and infrastructure | Millions of forms annually |
| Support | IRS help desk (limited) | US-based compliance experts |
BoomTax files millions of information returns every year and has the infrastructure, IRS relationships, and compliance expertise to handle enterprise-scale filing. For most organizations, the engineering cost of building and maintaining a DIY A2A integration far exceeds the cost of using a service.
Frequently Asked Questions
Next Steps
Passionate about making tax compliance simple so businesses can focus on what matters.
BoomTax and its affiliates do not provide tax, legal, or accounting advice. This material has been prepared for informational purposes only, and is not intended to provide, and should not be relied on for, tax, legal, or accounting advice. You should consult your own tax, legal, and accounting advisors prior to engaging in any transaction.