ATTENTION: In the fall of 2017, we will release a new version of The new site will continue to provide data on federal awards as well as include data on agency expenditures. Please note that in advance of that transition, financial assistance awards, such as grants and loans, are now being updated on only. Please visit the new site and give us your feedback at Contact Us or join the Community.

Assistance - FAADS

faads.php Method

Allows access to FAADS and FAADS PLUS data on Federal assistance.  NOTE:  The detail argument MUST be included in order to return results.

Error Codes and Warnings:

Currently there is only one error code associated with the faads method, although an expanded list is planned for future versions. In case of an error no results will be displayed and the error message will be displayed inside the <error> XML element.

Error messageDescription:
No records found for the search criteriano records were found for the search criteria specified


FieldField Description:
detailControls which type of output -- which "level of detail" -- you get. Choices are:

sortbyDetermines how records are sorted. Valid values are:

  • r = by contractor or recipient name
  • f = by dollars of awards (in descending order)
  • g = by major contracting agency
  • p = by CFDA Program
  • d = by date of award
  • e = by submission date/deleted date (in descending order)
Defaults to sort by dollars if not provided.

Sorting functionality is not available for the following level of details (Summary, Low, and Medium)
max_recordsAllows you to set the maximum number of records retrieved to fewer than 1000
records_fromAllows you to set the starting position of the records to be retrieved
fiscal_yearSpecifies a single year; defaults to all years.
first_year_rangeSpecifies the first year in a range of years; if used, must be used with last_year_range and without fiscal_year
last_year_rangeSpecifies the last year in a range of years; if used, must be used with first_year_range and without fiscal_year
recipient_nameThe name of a recipient of assistance
recipient_city_nameThe city in the address of a recipient
recipient_state_codeThe FIPS state code for the state in the address of a recipient.
recipient_zipThe ZIP code in the address of a recipient
recipient_county_nameThe county in which a recipient is located
recipient_cdThe Congressional District in which the recipient is located, formatted with four characters.
principal_place_state_codeThe FIPS state code for the state of the place of performance..
principal_place_ccThe city or county of the place of performance.
agency_codeThe 4-character code for a specific governmental agency providing assistance.
maj_agency_catThe 4-character code for a major governmental agency at the department level providing assistance.
recip_cat_typeThe type of recipient. Valid values are:

  • f = For Profits
  • g = Government
  • h = Higher Education
  • i = Individuals
  • n = Nonprofits
  • o = Other
asst_cat_typeThe type of assistance provided. Valid values are:

  • d = Direct Payments (both specified and unrestricted)
  • g = Grants and Cooperative Agreements
  • i = Insurance
  • l = Loans (both direct and guaranteed)
  • o = Other
project_descriptionA free text search on a description of the project.
cfda_program_numAn ID for the governmental program.            
federal_award_idA Federal ID for the award
duns_numberThe recipient duns number.
progsrc_agen_codeThe program source agency code.
progsrc_acnt_codeThe program source account code.
program_source_descFull text search of program source description.
busn_indctrDetermines the Business Fund Indicator:

r = funds provided by Recovery Act
records_submitted_fromSpecifies the earliest date in a range of time; if used, must be used with "records_submitted_to"

format: mmddyyyy


Specifies the latest date in a range of time; if used, must be used with "records_submitted_from"

format: mmddyyyy


All prime awardee data as reported by agencies. The assistance prime awardee data includes agency submissions as of and the contracts prime awardee data includes procurement data downloaded from FPDS as of . Please note that availability of DOD contracts prime awardee data is delayed by 90 days to protect operations tempo. All Sub-awardee data is based on prime awardee submissions from FSRS, for sub-contracts as of and for sub-grants as of . For more information about the data, data sources, and data timeliness, please see About the Data.‚Äč