NSF Awards

For free text searches, there are different ways to search.

1) Use + sign for the spaces (ex. university+of+south+florida)
2) To match all the words in the phrase, use double quotes in the value (ex. "university+of+south+florida")
3) For single word you can use the word as is, however it is recommended to use phrases to narrow down the search.
4) The API will accept alphabetic and numeric characters, as well as spaces and these punctuation marks: " , ( ) - / . ' ; < > % plus the use of th e wildcard characters * and ? as well as the @ symbol for email addresses. Quotation marks are used to search for an exact match of the values within the quotation marks.

	<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
	<response>
		<award>
			<agency>NSF</agency>
			<awardeeCity>MISSOULA</awardeeCity>
			<awardeeName>University of Montana</awardeeName>
			<awardeeStateCode>MT</awardeeStateCode>
			<date>09/20/2010</date>
			<fundsObligatedAmt>99911</fundsObligatedAmt>
			<id>1052893</id>
			<piFirstName>Penelope</piFirstName>
			<piLastName>Kukuk</piLastName>
			<title>Indigenous Women in Science Network (IWSN) Third Annual Meeting</title>
		</award>
	</response>
	
	

{
  "response" : {
          "award" : [ {
		"agency" : "NSF",
		"awardeeCity" : "MISSOULA",
		"awardeeName" : "University of Montana",
		"awardeeStateCode" : "MT",
		"fundsObligatedAmt" : "99911",
		"id" : "1052893",
		"piFirstName" : "Penelope",
		"piLastName" : "Kukuk",
		"date" : "09/20/2010",
		"title" : "Indigenous Women in Science Network (IWSN) Third Annual Meeting"
      } ]
    }
  }

processJson({
  "response" : {
          "award" : [ {
		"agency" : "NSF",
		"awardeeCity" : "MISSOULA",
		"awardeeName" : "University of Montana",
		"awardeeStateCode" : "MT",
		"fundsObligatedAmt" : "99911",
		"id" : "1052893",
		"piFirstName" : "Penelope",
		"piLastName" : "Kukuk",
		"date" : "09/20/2010",
		"title" : "Indigenous Women in Science Network (IWSN) Third Annual Meeting"
      } ]
    }
  });

	<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
	<response>
		<serviceNotification>
		<notificationCode>AwardAPI-004</notificationCode>
		<notificationMessage>There was an error processing your request. If the problem persists, go to www.research.gov and click the Contact Us link to report your issue to the NSF IT Service Desk for further assistance.
		</notificationMessage>
		<notificationType>FATAL</notificationType>
		</serviceNotification>
	</response>
	
	

	{
	"response" : {
		  "serviceNotification" : [ {
		"notificationType" : "ERROR",
		"notificationCode" : "AwardAPI-002",
		"notificationMessage" : "Invalid parameter(s) sent in the request. Invalid Parameter(s) {keyword1}"
		} ]
	}
	}

	processJson({
	"response" : {
		  "serviceNotification" : [ {
		"notificationType" : "ERROR",
		"notificationCode" : "AwardAPI-002",
		"notificationMessage" : "Invalid parameter(s) sent in the request. Invalid Parameter(s) {keyword1}"
		} ]
	}
	});