Skip to content

R scripts to document and build the IRS Current Exempt Organizations Database.

Notifications You must be signed in to change notification settings

Nonprofit-Open-Data-Collective/irs-current-exempt-orgs-database

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

irs-current-exempt-orgs-database

R scripts to document and build the IRS Current Exempt Organizations Database.


CURRENT EXEMPT ORGANIZATIONS LIST

From the IRS Website: https://apps.irs.gov/app/eos/forwardToPub78Download.do

Publication 78 Data Download

Using the link below, you may download as a zipped text file the most recent list of organizations eligible to receive tax-deductible charitable contributions (Pub. 78 data). The download file is a large compressed file, from which you may extract a very large delimited text file. This file is updated on a monthly basis. Opening the file using word processing software may prevent formatting/appearance issues that may be present if the file is viewed with a text editing program. Information is available describing the layout and contents of the downloadable file.

Format: Pipe-Delimited ASCII Text

Data Dictionary

Variable Notes
EIN Unique Employee Identification Number for each nonprofit
Legal Name Name of nonprofit (optional)
City Location of nonprofit (optional)
State Location of nonprofit (optional)
Country If the country is null, it is assumed to be the United States
Deductibility Status PC, PF, EO, ... (optional)
EIN Legal Name City ST Country DS
4101 South Lafourche Quarterback Club Lockport LA United States PF
587764 Iglesia Bethesda Inc. Lowell MA United States PC
635913 Ministerio Apostolico Jesucristo Es El Senor Inc. Lawrence MA United States PC
765634 Mercy Chapel International Mattapan MA United States PC
841363 Agape House of Prayer Mattapan MA United States PC
852649 Bethany Presbyterian Church Brookline MA United States PC

Note that this dataset is current, not cumulative, meaning it lists only entities with current 501c3 status.

Deductibility Status

Data from May 2023: 1,045,476 organizations listed in the Pub78 download.

Deductibility Status Freq
PC 907371
PF 98345
SOUNK 11592
EO 11339
POF 6979
SO 4937
GROUP 1863
EO,LODGE 1417
FORGN 581
UNKWN 370
EO,GROUP,LODGE 268
SONFI 194
EO,GROUP 85
FORGN,PF 51
GROUP,SOUNK 44
FORGN,SOUNK 16
GROUP,SO 7
EO,FORGN 5
EO,PF 4
FORGN,POF 4
EO,FORGN,GROUP,LODGE 1
EO,SO 1
FORGN,SO 1
GROUP,PF 1

Defitions of the various types can be found on the IRS website (See EO search tool documentation) and in Publication 526:

In general, an individual who itemizes deductions may deduct contributions to most charitable organizations up to 50% (60% for cash contributions) of his or her adjusted gross income computed without regard to net operating loss carrybacks. Individuals generally may deduct charitable contributions to other organizations up to 30% of their adjusted gross income (computed without regard to net operating loss carrybacks). These limitations (and organizational status) are indicated as follows:

Code Type of organization and use of contribution. Deductibility Limitation
PC A public charity. 50% (60% for cash contributions)
POF A private operating foundation. 50% (60% for cash contributions)
PF A private foundation. 30% (generally)
GROUP Generally, a central organization holding a group exemption letter, whose subordinate units covered by the group exemption are also eligible to receive tax-deductible contributions, even though they are not separately listed. Depends on various factors
LODGE A domestic fraternal society, operating under the lodge system, but only if the contribution is to be used exclusively for charitable purposes. 30%
UNKWN A charitable organization whose public charity status has not been determined. Depends on various factors
EO An organization described in section 170(c) of the Internal Revenue Code other than a public charity or private foundation. Depends on various factors
FORGN A foreign-addressed organization. These are generally organizations formed in the United States that conduct activities in foreign countries. Certain foreign organizations that receive charitable contributions deductible pursuant to treaty are also included, as are organizations created in U.S. possessions. Depends on various factors
SO A Type I, Type II, or functionally integrated Type III supporting organization. 50% (60% for cash contributions)
SONFI A non-functionally integrated Type III supporting organization. 50% (60% for cash contributions)
SOUNK A supporting organization, unspecified type. 50% (60% for cash contributions)

Contributions must actually be paid in cash or other property before the close of an individual's tax year to be deductible for that tax year, whether the individual uses the cash or accrual method.

If an individual donates property other than cash to a qualified organization, the individual may generally deduct the fair market value of the property. If the property has appreciated in value, however, some adjustments may have to be made.

The rules relating to how to determine fair market value are discussed in Publication 561, Determining the Value of Donated Property. For a more comprehensive discussion of the rules covering income tax deductions for charitable contributions by individuals, see Publication 526, Charitable Contributions.

Country

Country Freq
United States 1044817
CANADA 310
AFGHANISTAN 51
BRITISH VIRGIN ISLANDS 33
AUSTRALIA 27
UNITED KINGDOM 24
ISRAEL 15
GEORGIA 12
JAPAN 10
KENYA 9
PUERTO RICO 9
FRANCE 8
MAURITIUS 8
MEXICO 7
UGANDA 6

Truncated for preview purposes.

Downloads

Starting in June of 2023, NCCS began creating a monthly archive of historic Pub 78 files. They can be downloaded from the following links by adjusting the year and month:

https://nccsdata.s3.us-east-1.amazonaws.com/raw/current-exempt-orgs/2023-06-CURRENT-EXEMPT-ORGS-DATABASE.csv

BUILD THE DATABASE

# create subdirectory for the data

getwd()

dir.create( "IRS Nonprofit Data" )

setwd( "./IRS Nonprofit Data" )



# download and unzip

file.url <- "https://apps.irs.gov/pub/epostcard/data-download-pub78.zip"

download.file( url=file.url, "exemptorgs.zip" )

unzip( "exemptorgs.zip" )

file.remove( "exemptorgs.zip" )

dat.exempt <- read.delim( file="data-download-pub78.txt", 
            header = FALSE, 
            sep = "|", 
            quote = "",
            dec = ".", 
            fill = TRUE,  
            colClasses="character"
          )



# add header information - variable names

var.names <- c("EIN", "Legal.Name",  "City", "State", 
               "Country", "Deductibility.Status")


names( dat.exempt ) <- var.names

rm( var.names )

EXPORT THE DATASET

# AS R DATA SET

saveRDS( dat.exempt, file="ExemptOrganizations.rds" )


# AS CSV

write.csv( dat.exempt, "ExemptOrganizations.csv", row.names=F )


# IN STATA

install.packages( "haven" )
library( haven )
write_dta( dat.exempt, "ExemptOrganizations.dta" )

# IN SPSS  - creates a text file and a script for reading it into SPSS

library( foreign )
write.foreign( df=dat.exempt, datafile="ExemptOrganizations.txt", codefile="CodeToLoadDataInSPSS.txt", package="SPSS" )

# if package 'foreign' is not installed first try:  install.packages("foreign")

About

R scripts to document and build the IRS Current Exempt Organizations Database.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published