events
GET /events
Returns events associated with National Park Service sites, with optional filters for location, date, event type, tags, or search term.
Request
- Base URLhttps://developer.nps.gov/api/v1
- Auth
- API key in query parameter api_key
- or API key in header X-Api-Key
Query parameters
parkCodestring[]
A comma delimited list of park codes (each 4 characters in length).
organizationstring[]
A comma delimited list of organization site codes.
subjectstring[]
A comma delimited list of subject site codes.
portalstring[]
A comma delimited list of portal site codes.
tagsAllstring[]
A comma delimited list of tags that must be included.
tagsOnestring[]
A comma delimited list of tags that may be included.
tagsNonestring[]
A comma delimited list of tags that must not be included.
stateCodestring[]
A comma delimited list of 2 character state codes.
dateStartstring
A stating date in the yyyy-mm-dd format to filter events by.
dateEndstring
An ending date in the yyyy-mm-dd format to filter events by.
eventTypestring[]
A comma delimited list of event types.
idstring
A unique ID string for an event.
qstring
Term to search on.
pageSizeinteger
The number of results per page. Default is 10.
pageNumberinteger
The current page number for the results. Default is 1.
expandRecurringboolean
A flag to denote whether or not to expand the recurring events out into multiple records (one per event date). Default is false.
Response
successful operation
Example response
{
"total": "745",
"data": [
{
"category": "Regular Event",
"categoryid": "0",
"contactemailaddress": "example@nps.gov",
"contactname": "John Doe",
"contacttelephonenumber": "9999999999",
"createuser": "",
"date": "2019-09-14",
"dateend": "2017-09-16",
"dates": [
"2017-09-16",
"2018-09-15",
"2019-09-14"
],
"datestart": "2017-09-16",
"datetimecreated": "",
"datetimeupdated": "",
"description": "<p>Join a National Park service Ranger for a paid guided tour.</p>",
"eventid": "0",
"feeinfo": "The event is not free; you should call the park.",
"geometryPoiId": "8793be28-0d54-493f-8556-877e7ecbe937",
"id": "FE39616A-1DD8-B71B-0BA9DCB9BDF76670",
"imageidlist": "",
"images": [
{
"altText": "Picture of the South-West Battery with a skyscraper in the background.",
"caption": "The South-West Battery",
"credit": "NPS Photo",
"imageId": "21803",
"ordinal": "0",
"path": "/common/uploads/event_calendar/1B853925-E059-D529-0C87BCF597BE816B.jpg",
"title": "The South-West Battery",
"url": "/common/uploads/event_calendar/1B853925-E059-D529-0C87BCF597BE816B.jpg"
}
],
"infourl": "",
"isallday": "false",
"isfree": "false",
"isrecurring": "true",
"isregresrequired": "true",
"latitude": "40.7034",
"location": "Castle Clinton National Monument",
"longitude": "-74.0168",
"organizationname": "",
"parkfullname": "Castle Clinton National Monument",
"portalname": "",
"recurrencedateend": "2023-11-20",
"recurrencedatestart": "2017-09-16",
"recurrencerule": "DTSTART=20171120T040000Z;UNTIL=20231120T040000Z;FREQ=DAILY;WKST=SU;COUNT=0;INTERVAL=1",
"regresinfo": "Please call the park to register for this event.",
"regresurl": "https://www.nps.gov/planyourvisit/event-details.htm?id=0D25A738-155D-451F-67D31ADD6827D16D",
"sitecode": "cacl",
"sitetype": "park",
"subjectname": "",
"tags": [
"NPS Centennial"
],
"timeinfo": "",
"times": [
{
"timestart": "10:00 AM",
"timeend": "10:30 AM",
"sunsetend": "false",
"sunrisestart": "false"
},
{
"timestart": "12:00 PM",
"timeend": "12:30 PM",
"sunsetend": "false",
"sunrisestart": "false"
},
{
"timestart": "02:00 PM",
"timeend": "02:30 PM",
"sunsetend": "false",
"sunrisestart": "false"
},
{
"timestart": "03:00 PM",
"timeend": "03:30 PM",
"sunsetend": "false",
"sunrisestart": "false"
}
],
"title": "Military Appreciation Day",
"types": [
"Other"
]
},
{
"category": "Regular Event",
"categoryid": "0",
"contactemailaddress": "",
"contactname": "",
"contacttelephonenumber": "",
"createuser": "",
"date": "2018-10-29",
"dateend": "2018-10-31",
"dates": [
"2018-10-29",
"2018-10-30",
"2018-10-31"
],
"datestart": "2018-10-31",
"datetimecreated": "",
"datetimeupdated": "",
"description": "<p>Join a National Park service Ranger for a free guided tour.</p>",
"eventid": "0",
"feeinfo": "",
"id": "0D25A738-155D-451F-67D31ADD6827D16D",
"imageidlist": "",
"images": [
{
"altText": "",
"caption": "",
"credit": "",
"imageId": "",
"ordinal": "",
"path": "",
"title": "",
"url": ""
}
],
"infourl": "",
"isallday": "false",
"isfree": "true",
"isrecurring": "true",
"isregresrequired": "false",
"latitude": null,
"location": "Castle Clinton NM",
"longitude": null,
"organizationname": "",
"parkfullname": "Castle Clinton National Monument",
"portalname": "",
"recurrencedateend": "2023-11-20",
"recurrencedatestart": "2018-10-31",
"recurrencerule": "DTSTART=20171120T040000Z;UNTIL=20231120T040000Z;FREQ=DAILY;WKST=SU;COUNT=0;INTERVAL=1",
"regresinfo": "",
"regresurl": "",
"sitecode": "cacl",
"sitetype": "park",
"subjectname": "",
"tags": [
"NPS Centennial"
],
"timeinfo": "",
"times": [
{
"timestart": "10:00 AM",
"timeend": "10:30 AM",
"sunsetend": "false",
"sunrisestart": "false"
},
{
"timestart": "12:00 PM",
"timeend": "12:30 PM",
"sunsetend": "false",
"sunrisestart": "false"
},
{
"timestart": "02:00 PM",
"timeend": "02:30 PM",
"sunsetend": "false",
"sunrisestart": "false"
},
{
"timestart": "03:00 PM",
"timeend": "03:30 PM",
"sunsetend": "false",
"sunrisestart": "false"
}
],
"title": "Castle Clinton Guided tour",
"types": [
"Other"
]
}
],
"dates": "2020-01-01,2019-12-04,2019-12-11",
"pagenumber": "1",
"pagesize": "50"
}Changes
No recorded changes to this operation across all 1 revision of this API.