View source for Public Atom Feed Usage

From FPDS-NG

You do not have permission to edit this page, for the following reason:
The action you have requested is limited to users in the group: Users.
You can view and copy the source of this page.
__NOEDITSECTION__
==Introduction==
FPDS-NG has data reporting web services that provide access in real-time to FPDS-NG’s central data repository. Now FPDS-NG will also provide contractual data using Atom feeds.<br><br>
ATOM Feeds can be accessed by the following methods:  
<ul>
<li>
Using Portal
</li><li>
By constructing the URL
</li></ul>

==Steps to access the ATOM feed via portal==

1. Launch the URL https://www.fpds.gov 

2. Type the search criteria keywords in the ezSearch input text box and hit enter

[[Image:Atom_search.jpg|frame|alt=Atom Search|center|thumb|300px300px|]]
<br>

3. A new window will be launched with the search results.
[[Image:search_results.jpg|frame|alt=Atom Results|center|300px300px|]]
<br>
4. Search results can be narrowed by clicking the Advanced Search button.
[[Image:Advanced_results.jpg|frame|alt=Advanced Results|center|300px300px|]]
<br>
5. To automatically get notifed for the changes subcribe to ATOM feeds by clicking [[image:Atom.JPG]] 


==Constructing the ATOM feed URL==

To construct the Atom Feed URL with required search criteria follow the below methodology
<pre>
Atom_URL = BASE_URL + “URL String of the Search Criteria 1” + " " + “URL String of the Search Criteria 2”
</pre>
Repeat the search criteria to add additional search criteria

BASE_URL: https://beta.fpdsng.com/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q=

<b>Search Criteria Listing</b>
<TABLE border=2 id="box-table-a" style="width: 800px">
<tr><th width=30% align="center"><b>Search Criteria</b></th><th align="center"><b>URL String</b></th></tr>
<tr><td nowrap>Last Modified Date</td><td align="left">LAST_MOD_DATE:[2006/04/02,2007/04/02]</td></tr>
<tr><td nowrap>Agency Code</td><td align="left">AGENCY_CODE:”3600”</td></tr>
<tr><td nowrap>Agency Name</td><td align="left">AGENCY_NAME:”General Services Administration”</td></tr>
<tr><td nowrap>Contracting Agency</td><td align="left">CONTRACTING_AGENCY_ID:"5700"</td></tr>
<tr><td nowrap>Award Completion Date</td><td align="left">AWARD_COMPLETION_DATE:[2006/04/02,2007/04/02]</td></tr>
<tr><td nowrap>Award Status (Deleted | Final)</td><td align="left">AWARD_STATUS:”Final”</td></tr>
<tr><td nowrap>Contract Type (IDV | Award)</td><td align="left">CONTRACT_TYPE:”AWARD”</td></tr>
<tr><td nowrap>Contract ID</td><td align="left">PIID:”ABCD”</td></tr>
<tr><td nowrap>Contracting Agency Name</td><td align="left">CONTRACTING_AGENCY_NAME:”DEPT OF THE AIR FORCE”</td></tr>
<tr><td nowrap>Contracting Office ID </td><td align="left">CONTRACTING_OFFICE_ID:”FA8734”</td></tr>
<tr><td nowrap>Contracting Office Name</td><td align="left">CONTRACTING_OFFICE_NAME:”FA8734  ESC 554 ELSG PNPK”</td></tr>
<tr><td nowrap>Created By</td><td align="left">CREATED_BY:”ABC”</td></tr>
<tr><td nowrap>Created Date</td><td align="left">CREATED_DATE:[2008/10/14,2008/10/14]</td></tr>
<tr><td nowrap>Date Signed</td><td align="left">SIGNED_DATE:[2006/04/19,2006/04/19]</td></tr>
<tr><td nowrap>Department ID</td><td align="left">DEPARTMENT_ID:”4700”</td></tr>
<tr><td nowrap>Department Name</td><td align="left">DEPARTMENT_NAME:”GENERAL SERVICES ADMINISTRATION”</td></tr>
<tr><td nowrap>Description of Requirement</td><td align="left">DESCRIPTION_OF_REQUIREMENT:"Katrina"</td></tr>
<tr><td nowrap>Effective Date</td><td align="left">EFFECTIVE_DATE:[2006/04/19,2006/04/19]</td></tr>
<tr><td nowrap>Estimated Completion date</td><td align="left">ESTIMATED_COMPLETION_DATE:[2006/04/19,2006/04/19]</td></tr>
<tr><td nowrap>Funding Agency ID</td><td align="left">FUNDING_AGENCY_ID:"4740"</td></tr>
<tr><td nowrap>Action Obligation </td><td align="left">OBLIGATED_AMOUNT:[4142,4150]</td></tr>
<tr><td nowrap>Funding Office ID</td><td align="left">FUNDING_OFFICE_ID:”W91278”</td></tr>
<tr><td nowrap>Funding Office Name</td><td align="left">FUNDING_OFFICE_NAME:”mobile”</td></tr>
<tr><td nowrap>Last Modified by </td><td align="left">LAST_MODIFIED_BY:”ABC”</td></tr>
<tr><td nowrap>Legislative Mandates</td><td align="left">LEGISLATIVE_MANDATES:”walsh”</td></tr>
<tr><td nowrap>Local Area Set Aside ( Y | N)</td><td align="left">LOCAL_AREA_SET_ASIDE:”N”</td></tr>
<tr><td nowrap>Modification Number</td><td align="left">MODIFICATION_NUMBER:”1”</td></tr>
<tr><td nowrap>Multiyear contract</td><td align="left">MULTIYEAR_CONTRACT:”Y”</td></tr>
<tr><td nowrap>NAICS Code</td><td align="left">PRINCIPAL_NAICS_CODE:”511210”</td></tr>
<tr><td nowrap>NAICS Description</td><td align="left">NAICS_DESCRIPTION:”SOFTWARE PUBLISHERS”</td></tr>
<tr><td nowrap>National Interest Action Code</td><td align="left">NATIONAL_INTEREST_CODE:”T10S”</td></tr>
<tr><td nowrap>National Interest Description</td><td align="left">NATIONAL_INTEREST_DESCRIPTION:”Samoa”</td></tr>
<tr><td nowrap>Product or Service Code</td><td align="left">PRODUCT_OR_SERVICE_CODE:”J070”</td></tr>
<tr><td nowrap>PSC Description</td><td align="left">PRODUCT_OR_SERVICE_DESCRIPTION:”GUNS”</td></tr>
<tr><td nowrap>POP congressional District Code</td><td align="left">POP_CONGRESS_DISTRICT_CODE:"04"</td></tr>
<tr><td nowrap>POP Country Name</td><td align="left">POP_COUNTRY_NAME:”UNITED STATES”</td></tr>
<tr><td nowrap>POP State Name</td><td align="left">POP_STATE_NAME:”VIRGINIA”</td></tr>
<tr><td nowrap>Reason for Modification</td><td align="left">REASON_FOR_MODIFICATION:”D”</td></tr>
<tr><td nowrap>Reference IDV PIID</td><td align="left">REF_IDV_PIID:”ABC”</td></tr>
<tr><td nowrap>Reference IDV Agency ID</td><td align="left">REF_IDV_AGENCY_ID:”4740”</td></tr>
<tr><td nowrap>Socio Economic Indicators</td><td align="left">SOCIO_ECONOMIC_INDICATORS:”SMALL BUSINESS”</td></tr>
<tr><td nowrap>Type of Contract Pricing</td><td align="left">TYPE_OF_CONTRACT_PRICING:"J"</td></tr>
<tr><td nowrap>Ultimate Contract Value</td><td align="left">ULTIMATE_CONTRACT_VALUE:[13587,13600]</td></tr>
<tr><td nowrap>Vendor City</td><td align="left">VENDOR_ADDRESS_CITY:”WAKEFIELD”</td></tr>
<tr><td nowrap>Vendor congressional District Code</td><td align="left">VENDOR_CONGRESS_DISTRICT_CODE:”04”</td></tr>
<tr><td nowrap>Vendor Country Code</td><td align="left">VENDOR_ADDRESS_COUNTRY_CODE:”USA”</td></tr>
<tr><td nowrap>Vendor Country Name</td><td align="left">VENDOR_ADDRESS_COUNTRY_Name:”UNITED STATES”</td></tr>
<tr><td nowrap>Vendor DUNS Number</td><td align="left">VENDOR_DUNS_NUMBER:”1207920560000”</td></tr>
<tr><td nowrap>Vendor Doing Business As Name</td><td align="left">VENDOR_DOING_BUSINESS_AS_NAME:”ABC”</td></tr>
<tr><td nowrap>Vendor Name</td><td align="left">VENDOR_NAME:”ABC”</td></tr>
<tr><td nowrap>Vendor State Code</td><td align="left">VENDOR_ADDRESS_STATE_CODE:"VA"</td></tr>
<tr><td nowrap>Vendor State Name</td><td align="left">VENDOR_ADDRESS_STATE_NAME:"Virginia"</td></tr>
<tr><td nowrap>Vendor Address Zip Code</td><td align="left">VENDOR_ADDRESS_ZIP_CODE:”20190”</td></tr>
</table>

'''Sorting:'''

The data retrieved can be sorted by appending "sortBy=<dataElement>&desc=Y" to the URL. Where <dataElement> is one of the searchable fields.

'''Example:'''
<OL><LI>Search the data based on the Last Modified Date<br><br>
<pre>
Atom_URL = https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q= 
           + LAST_MOD_DATE:[2006/04/02,2007/04/02] 
</pre>
<br><br>
</li><li>Search the data based on:
* Last Modified Date 
* GSA (Agency code of 3600)
<pre>
Atom_URL = https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q= 
           + LAST_MOD_DATE:[2006/04/02,2007/04/02] + “ “
           + AGENCY_CODE:”3600”
</pre><br><br>
</li><li>Search the data based on the 
* Last Modified Date
* GSA (Agency code of 3600)
* Awards only
<pre>
Atom_URL = https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q= 
           + LAST_MOD_DATE:[2006/04/02,2007/04/02] + “ “
           + AGENCY_CODE:”3600” + “ “
           + CONTRACT_TYPE:"AWARD"
</pre>
</li></ol>
<br><br>
<b>Sample Atom URL:</b>
<pre>
https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q=LAST_MOD_DATE:[2006/04/02,2007/04/02] AGENCY_CODE:"3600" CONTRACT_TYPE:"AWARD"
</pre>
Return to Public Atom Feed Usage.
Retrieved from "https://fpds.gov/wiki/index.php/Public_Atom_Feed_Usage"