Department of Interior

Department of Interior Events API

Park events

GitHub OpenAPI

Operations 1

GET /events Get events #

Documentation

📖
Documentation
https://www.nps.gov/subjects/developer/api-documentation.htm
📖
Authentication
https://www.nps.gov/subjects/developer/get-started.htm
📖
Documentation
https://earthquake.usgs.gov/fdsnws/event/1/
📖
Documentation
https://waterservices.usgs.gov/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/doi/openapi/doi-events-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/doi/json-schema/nps-park-schema.json
📊
JSONSchema
https://artifacts.apis.io/doi/json-schema/earthquake-feature-schema.json

Other Resources

🔗
Examples
https://artifacts.apis.io/doi/examples/park-example.json
🔗
Examples
https://artifacts.apis.io/doi/examples/earthquake-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/doi:doi-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

doi-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: This API is designed to provide authoritative National Park Service (NPS) data and content about parks and their facilities, events, news, alerts, and more. Explore the NPS API below and even try to make API calls. In order to try an API call, you'll need to click on the "Authorize" button below and add your API key. If you don't have an API key yet, visit our Get Started page.
  version: 1.0.0
  title: National Park Service Events API
servers:
- url: https://developer.nps.gov/api/v1
tags:
- name: Events
  description: Retrieve events created by national parks and other NPS entities.
paths:
  /events:
    get:
      tags:
      - Events
      description: Returns events associated with National Park Service sites, with optional filters for location, date, event type, tags, or search term.
      operationId: getEvents
      parameters:
      - name: parkCode
        in: query
        description: A comma delimited list of park codes (each 4 characters in length).
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: organization
        in: query
        description: A comma delimited list of organization site codes.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: subject
        in: query
        description: A comma delimited list of subject site codes.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: portal
        in: query
        description: A comma delimited list of portal site codes.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: tagsAll
        in: query
        description: A comma delimited list of tags that must be included.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: tagsOne
        in: query
        description: A comma delimited list of tags that may be included.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: tagsNone
        in: query
        description: A comma delimited list of tags that must not be included.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: stateCode
        in: query
        description: A comma delimited list of 2 character state codes.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: dateStart
        in: query
        description: A stating date in the yyyy-mm-dd format to filter events by.
        required: false
        schema:
          type: string
      - name: dateEnd
        in: query
        description: An ending date in the yyyy-mm-dd format to filter events by.
        required: false
        schema:
          type: string
      - name: eventType
        in: query
        description: A comma delimited list of event types.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: id
        in: query
        description: A unique ID string for an event.
        required: false
        schema:
          type: string
      - name: q
        in: query
        description: Term to search on.
        required: false
        schema:
          type: string
      - name: pageSize
        in: query
        description: The number of results per page. Default is 10.
        required: false
        schema:
          type: integer
      - name: pageNumber
        in: query
        description: The current page number for the results. Default is 1.
        required: false
        schema:
          type: integer
      - name: expandRecurring
        in: query
        description: A flag to denote whether or not to expand the recurring events out into multiple records (one per event date). Default is false.
        required: false
        schema:
          type: boolean
      security:
      - api_key: []
      - api_key_header: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        '400':
          description: Invalid status value
      summary: Get events
      x-summary-source: derived
components:
  schemas:
    Event:
      type: object
      properties:
        total:
          type: string
          example: '745'
        errors:
          type: array
          items:
            type: object
        data:
          type: array
          items:
            type: object
            properties:
              contactemailaddress:
                type: string
                description: Email address for event contact
              contactname:
                type: string
                description: Name of event contact
              contacttelephonenumber:
                type: string
                description: Phone number for event contact
              category:
                type: string
                description: Category for event
              categoryid:
                type: string
                example: '1'
              createuser:
                type: string
              dateend:
                type: string
                format: date
                description: End date for event
              date:
                type: string
                format: date
                description: Date of next upcoming event
              dates:
                type: array
                description: Array of event dates
                items:
                  type: string
                  format: date
              datestart:
                type: string
                format: date
                description: Start date for event
              datetimecreated:
                type: string
              datetimeupdated:
                type:
                - string
                - 'null'
              description:
                type: string
                description: Event description
              eventid:
                type: string
                example: '0'
              feeinfo:
                type: string
                description: Fee information for event
              geometryPoiId:
                type: string
                description: Id for Geometry Point of Interest
                example: 8793be28-0d54-493f-8556-877e7ecbe937
              id:
                type: string
                description: Unique identifier for this event
                example: F0092036-921D-2344-8498FB0012847F3C
              imageidlist:
                type: string
              images:
                type: array
                items:
                  type: object
                  description: Event image
                  properties:
                    altText:
                      type: string
                      description: Image alt text
                    caption:
                      type: string
                      description: Image caption
                    credit:
                      type: string
                      description: Image credit
                    imageId:
                      type: string
                      example: '21803'
                    ordinal:
                      type: string
                      example: '0'
                    path:
                      type: string
                      example: /common/uploads/event_calendar/1B853925-E059-D529-0C87BCF597BE816B.jpg
                    title:
                      type: string
                      description: Image title
                    url:
                      type: string
                      description: Image URL
              infourl:
                type: string
                description: URL for more information about the event
              isallday:
                type: string
                description: The event takes place all day
              isfree:
                type: string
                description: The event is free
              isrecurring:
                type: string
                description: The event has recurrence
              isregresrequired:
                type: string
                description: The event requires registration or reservation
              latitude:
                type:
                - string
                - 'null'
                description: The latitude of the event location
              location:
                type: string
                description: The location the event takes place
              longitude:
                type:
                - string
                - 'null'
                description: The longitude of the event location
              organizationname:
                type: string
                description: Name of the organization associated with event
              parkfullname:
                type: string
                description: Name and designation of the park associated with event
              portalname:
                type: string
                description: Name of the portal site associated with event
              recurrencedateend:
                type: string
                format: date
                description: Date the event recurrence ends
              recurrencedatestart:
                type: string
                format: date
                description: Date the event recurrence starts
              recurrencerule:
                type: string
                description: Recurrence rule for event
              regresinfo:
                type: string
                description: Additional information on required reservation or registration for event
              regresurl:
                type: string
                description: URL for required reservation or registration for event
              sitecode:
                type: string
                description: Site code of the associated site for event
              sitetype:
                type: string
                description: Site type of the associated site for event
              subjectname:
                type: string
                description: Name of associated subject site for event
              tags:
                type: array
                description: Tags associated with event
                items:
                  type: string
              timeinfo:
                type: string
                description: Additional information about times for event
              times:
                type: array
                description: Time information for event
                items:
                  type: object
                  properties:
                    sunrisestart:
                      type: string
                      description: Event begins at sunrise
                      example: 'true'
                    sunsetend:
                      type: string
                      description: Event ends at sunset
                      example: 'false'
                    timestart:
                      type: string
                      description: Time event begins
                    timeend:
                      type: string
                      description: Time event ends
              title:
                type: string
                description: Event title
              types:
                type: array
                description: Type(s) of event
                items:
                  type: string
          example:
          - 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:
          type: string
          example: 2020-01-01,2019-12-04,2019-12-11
        pagenumber:
          type: string
          example: '1'
        pagesize:
          type: string
          example: '50'
  securitySchemes:
    api_key:
      type: apiKey
      name: api_key
      in: query
    api_key_header:
      type: apiKey
      name: X-Api-Key
      in: header
x-provenance:
  method: harvested
  publisher: Department of Interior
  source: https://www.nps.gov/subjects/developer/customcf/swagger.json?03142019
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)