IRS 990 Filings on AWS

Machine-readable data from certain electronic 990 forms filed with the IRS from 2011 to present are available for anyone to use via Amazon S3.

Form 990 is the form used by the United States Internal Revenue Service to gather financial information about nonprofit organizations. Data for each 990 filing is provided in an XML file that contains structured information that represents the main 990 form, any filed forms and schedules, and other control information describing how the document was filed. Some non-disclosable information is not included in the files.

This data set includes Forms 990, 990-EZ and 990-PF which have been electronically filed with the IRS and is updated monthly in an XML format. The data can be used to perform research and analysis of organizations that have electronically filed Forms 990, 990-EZ and 990-PF. Forms 990-N (e-Postcard) are not available withing this data set. Forms 990-N can be viewed and downloaded from the IRS website.

Each electronic 990 filing is available as a unique XML file in the "irs-form-990" S3 bucket in the US East (N. Virginia) region. Schemas for electronic 990 filings are available on the IRS website. Each filing is named based on the year it was filed and a unique identifier. For example, we can tell that the filing named "201211889349300706_public.xml" was filed in 2012 because the file name starts with "2012." "11889349300706" is the unique identifier of the filing.

A file listing all of the available filings is available at s3://irs-form-990/index.json. This file includes basic information about each filing including the name of the filer, the Employer Identificiation Number (EIN) of the filer, the date of the filing, and the path to download the filing.

If you use the AWS Command Line Interface, you can list the filings from 2012, see how many filings are available, and calculate the total size of the filings with the "ls" command:

To view listings from other years, simply change the year (2012) in the above command.

If you would like to show us what you can do with IRS 990 Filings on AWS or would like to receive updates on the project, please fill out the form below.

Educators, researchers and students can also apply for free credits to take advantage of the utility computing platform offered by AWS, along with Public Datasets such as IRS 990 Filings on AWS. If you have a research project that could take advantage of IRS 990 Filings on AWS, you can apply for AWS Cloud Credits for Research.