ATTENTION: In the fall of 2017, we will release a new version of USAspending.gov. 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 beta.usaspending.gov only. Please visit the new site and give us your feedback at Contact Us or join the Community.

Contracts - FPDS

​fpds.php Method

Allows access to FPDS data on Federal contracts. 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 fpds 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 criteria  No​ records were found for the search criteria specified

Arguments

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 Product or Service Category
  • d = by date of award
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
company_nameThe name of a a contractor or contractor parent company
cityThe city within a contractor's address
stateThe state abbreviation within a contractor's address.
ZIPCodeThe ZIP code within a contractor's address.
vendorCountryCodeThe two-letter country code for the country in a contractor's address.
vendor_cdThe 4-character Congressional District within which a contractor is located.
pop_cdThe Congressional District of the place of performance.
stateCodeThe state abbreviation of the state of the place of performance
placeOfPerformanceZIPCodeThe ZIP code of the place of performance.
placeOfPerformanceCountryCodeThe two-letter country code for the place of performance country.
mod_agencyThe 4-digit code for a specific governmental agency issuing contracts.
maj_agency_catThe 2-character code for a major governmental agency issuing contracts.
psc_catThe 2-character code for a major product or service category.
psc_subThe 4-character code for a product or service.
descriptionOfContractRequirementFree text search within the text that describes what the contract is for.
PIIDA Federal ID number for the contract.
extent_competeThe extent competed status of a contract. Values are:

  • G = Not Competed under SAP
  • F = Competed under SAP
  • E = Follow On to Competed Action
  • NDO = Non-Competitive Delivery Order
  • D = Full and Open Competition after exclusion of sources
  • C = Not Competed
  • B = Not Available for Competition
  • A = Full and Open Competition
  • CDO = Competitive Delivery Order
duns_numberThe contractor duns number.
program_source_agency_codeThe program source agency code.
program_source_account_codeThe program source account code.
program_source_descFull text search of program source description.
busn_indctr

Determines the Business Fund Indicator:

r = funds provided by Recovery Act

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. ​

The quality procurement data is maintained by the federal agencies by annual verification and validation of their data in FPDS. For more information on how the quality is maintained and what the government is doing in ensuring the quality please read the Federal Government Procurement Data Quality Summary 2008-2013​.