| NPR Shop | NPR Social Media | Sign In | Register

Get started!
Login
| Register

 

Error Handling Reference

Below is a list of errors and warnings returned by the API when handling requests for NPRML output. Error messages will abort the request and display the message. Warning messages will return a result set with the messages at the top of the document.
NOTICE: For outputs other than NPRML, the API will return general errors compatible with the requested format. At this time, the API will not return messages specific to the output format.

Error Messages
 

The following are error messages that will prevent the API from executing the query and/or returning results.

ID DESCRIPTION
101 NPR is experiencing system issues at this time. Please try this request again later.
310 The API key passed in ($data) was invalid or no API key was passed in. Please register for a valid API key.
311 The API key passed in ($data) was deactivated. We will contact the email associated with this API key, but you may also contact us by visiting http://www.npr.org/contact/ and selecting the office 'Online / Technical Support'.

 
Warning Messages
 

The following are warning messages returned by the API. These warnings will not necessarily prevent the API from executing the query or returning results, but it could prevent areas of the request from getting handled. Warning messages will not be returned if an error is also encountered.

ID DESCRIPTION
201 Query parameter '$data' is invalid and was ignored.
202 The query parameter '$data' does not make sense with the other parameters used and was ignored.
203 Query parameter id='$data' is invalid because it is not an integer and was ignored.
204 A combination of IDs that includes list IDs ($data) is invalid. Please use list IDs by themselves only.
301 The field '$data' is invalid and was ignored.
302 The number of results you requested exceeded our maximum ($data). Please use the startNum parameter to page through the results.
303 You entered a search type without entering a search term. The search type you entered was not used in this query.
304 Your field parameter 'none' was ignored because you requested other fields ($data).
305 Because the field parameter 'all' was used, all other field parameters passed in were ignored ($data).
306 Your parameter ($data) was in the future, so it was reset to now.
307 Your start date ($data) was later than your end date. The query will search only for stories on the end date.
308 The number of results you requested exceeded our maximum ($data). Please use the startNum parameter to page through the results.
309 We are not supporting changing the fields displayed in the HTML or JS format at this time. The fields you entered ($data) were ignored. Please use styles to avoid displaying various parts of the output.
401 There were no results that matched your query criteria.

 
Story API Message Example
 

Below is an example of how multiple messages get returned by the API.