At a Glance
Filing 10,000+ information returns through IRIS requires a different approach than small-volume filing. The IRIS A2A (Application-to-Application) API is the only practical channel for enterprise-scale submissions. This guide covers batch sizing, rate limiting, parallel submission strategies, error handling at scale, and acknowledgment tracking. Or skip the infrastructure entirely — BoomTax files millions of forms through IRIS and handles all the complexity for you.
This article is part of our IRS IRIS Resource Center — your complete guide to the FIRE→IRIS migration.

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

The IRIS A2A API does not impose an absolute annual cap on the number of forms you can file. However, there are per-batch size limits and rate limits that govern how fast you can submit. The IRIS Taxpayer Portal (CSV upload) has practical volume limits and is unsuitable for large-scale filing. For enterprise volumes, use the A2A API or a service like BoomTax.

We recommend 500–1,000 returns per batch for optimal balance between throughput and error isolation. Smaller batches (100–500) are useful during initial testing. Always stay within the IRS's published maximum batch size, and group each batch by a single payer TIN and form type.

Build a scheduled polling process that checks the A2A API for pending acknowledgments using the submission IDs returned when you filed each batch. Store acknowledgments in a database, match them to original submissions, and set up monitoring alerts for batches with elevated rejection rates. If using BoomTax, acknowledgment tracking is built in — you can view status in real time through the dashboard or API.

Yes. BoomTax files millions of information returns annually across IRIS, FIRE, and AIR channels. The platform is built for enterprise scale and includes bulk upload, a full REST API, dedicated support, and volume pricing. Whether you're filing 10,000 or 10 million forms, BoomTax handles the IRIS submission, error management, and acknowledgment tracking.

Next Steps

Ken Ham
Author
Ken Ham
Founder at BoomTax
View all posts

Passionate about making tax compliance simple so businesses can focus on what matters.

   Help