Affordable Care Act Information Returns (AIR)

To meet federal security standards, the IRS must enhance the User Interface (UI) Testing and Production Channels with a stronger, one-time identity proofing process. The IRS must verify the individual using this tool and is requesting additional personal information.

Beginning June 16, 2019, some returning users must upgrade their account access by choosing one of three options to validate their identities. This is a one-time process. These options also will be incorporated into the verification process for new users. To be successful, users should review these options carefully.

IMPORTANT NOTE: No action may be necessary for users who have previously provided financial account or mobile phone information as part of an identity verification process for another tool. This includes users who already have access to IRS e-Services, ACA Application for Transmitter Control Code or personal tools such as Get Transcript or IP PIN. 

Returning users who need to complete this one-time verification will be asked to provide this information after logging in with their existing username and password.

Option 1 – Provide a personal financial account number
The IRS will accept one of six financial account numbers:

• Credit card – last 8 digits (no American Express, debit or corporate cards)
• Student loan
• Mortgage or home equity loan
• Home equity line of credit (HELOC)
• Auto loan

Option 2 – Provide a personal mobile phone number
The phone cannot be a business-issued phone. It must be:

• A U.S.-based phone, and
• Associated with your name and address.

Option 3 – Request an activation code by mail
At your request, the IRS will mail a code number to your home address of record with the IRS. Please note:

• Allow 10 business days for delivery.
• Return to the site within 30 days to enter the code and complete the identify verification process.
• If you need immediate access, use one of the other options.

If you need assistance contact the AIR Help Desk at 866-937-4130.

XML Schemas, and other information for software developers and transmitters, who are interested in developing software for the AIR Program, is provided by Tax Year:

In Processing Years 2016, 2017, 2018 and 2019 AIR will accept Forms 1094-B, 1095-B, 1094-C and 1095-C returns only.

Schemas for AIR by Tax Year

5/21/2019:
Beginning September 30, 2019, the encryption level for the ISS - A2A and AATS - A2A Channels will be TLS 1.2, exclusively.  Transmitters must ensure their encryption is set to TLS 1.2 to submit SOAP transmissions to AIR via the A2A Channel.

1/7/2019:
AATS WSDLs: Use the package named "FS19-TY18 AATS WSDL Package Nov 2018.”
Production WSDLs: Use the package named "FS19-TY18 Production WSDL Package Jan 2019."

For all Production and AATS transmissions, including prior year returns 2015, 2016 and 2017, use the 2018 manifest.

08/23/2018:
Currently, the ISS-A2A Gateway accepts SHA-1 and higher algorithms (SHA-256, SHA-384 and SHA-512) during the validation of WS-Security. Beginning November (for AATS) and January (for Production), AIR will no longer support SHA-1 from the accepted Signature and Digest methods used to digitally sign ISS-A2A transmissions.

2018

• AIR TCCs for Transmitters and Issuers that are in Production status will remain in Production status. No additional testing is needed for Tax Year 2018.
• Software Developers need to update their ACA Application for TCC each year to obtain a new software identification number for the new tax year
• Software Developers who passed testing for any tax year ending after December 31, 2014 do not need to test for the current tax year. Software IDs are scheduled to move to Production one week from the date the software IDs are assigned.
  • When the 2018 software packages are added, Responsible Officials will need to re-sign the ACA Application for TCC.
  • AIR Transmissions (both live and test) will reject If the ACA Application for TCC is not signed and in Completed status.
  • Allow 48 hours before transmitting to Production after passing any required testing.

2017

To generate tax year 2017 returns in AATS and Production, use:

• Manifest file from tax year 2018 schema package
• Form data file from tax year 2017 schema package
• PaymentYr value “2017”
• PriorYearDataInd value “1”
• Software Id for 2017 (2017 software Ids start with 17XXXXXXXX)

2016 

To generate tax year 2016 returns in AATS and Production, use:

• Manifest file from tax year 2018 schema package
• Form data file from tax year 2016 schema package
• PaymentYr value “2016”
• PriorYearDataInd value “1”
• Software Id for 2016 (2016 software Ids start with 16XXXXXXXX)

2015

To generate tax year 2015 returns in AATS and Production, use:

• Manifest file from tax year 2018 schema package
• Form data file from tax year 2015 schema package
• PaymentYr value “2015”
• PriorYearDataInd value “1”
• Software Id for 2015 (2015 software Ids start with 15XXXXXXXX)

Affordable Care Act Assurance Testing System (AATS) Information Returns
Find test scenarios, answers keys and known issues.

User Interface (UI) Transmission Checklist (PDF)
Use this checklist to confirm you are ready to transmit using the UI channel.

Application to Application (A2A) Transmission Checklist (PDF)
Use this checklist to confirm you are ready to transmit using the A2A channel.

Tutorial for Affordable Care Act Application for Transmitter Control Code (PDF)
Find step-by-step guidance on accessing and updating the application.

Publications

Publication 5164, Test Package for Electronic Filers of Affordable Care Act (ACA) Information Returns (AIR) (October 2018) (PDF)

Publication 5165, Guide for Electronically Filing Affordable Care Act (ACA) Information Returns for Software Developers and Transmitters (October 2018) (PDF)

Publication 5258, Affordable Care Act (ACA) Information Returns (AIR) Submission Composition and Reference Guide (October 2018) (PDF)

Publication 5308, AIR Automated Enrollment Guide (August 2018) (PDF)