---
title: "GET /events"
method: GET
path: "/events"
tags: ["events"]
---

# GET /events

`GET /events`

## Request

- Base URL: `https://developer.nps.gov/api/v1`
- URL: `https://developer.nps.gov/api/v1/events`
- Auth: one of:
  - API key in query parameter `api_key`
  - API key in header `X-Api-Key`

Returns events associated with National Park Service sites, with optional filters for location, date, event type, tags, or search term.

## Query parameters

- `parkCode` string[]
- `organization` string[]
- `subject` string[]
- `portal` string[]
- `tagsAll` string[]
- `tagsOne` string[]
- `tagsNone` string[]
- `stateCode` string[]
- `dateStart` string
- `dateEnd` string
- `eventType` string[]
- `id` string
- `q` string
- `pageSize` integer
- `pageNumber` integer
- `expandRecurring` boolean

## Response `200`

successful operation

- Event
  - `total` string
  - `errors` object[]
  - `data` object[]
    - `contactemailaddress` string: Email address for event contact
    - `contactname` string: Name of event contact
    - `contacttelephonenumber` string: Phone number for event contact
    - `category` string: Category for event
    - `categoryid` string
    - `createuser` string
    - `dateend` string, date: End date for event
    - `date` string, date: Date of next upcoming event
    - `dates` string[]: Array of event dates
    - `datestart` string, date: Start date for event
    - `datetimecreated` string
    - `datetimeupdated` string, nullable
    - `description` string: Event description
    - `eventid` string
    - `feeinfo` string: Fee information for event
    - `geometryPoiId` string: Id for Geometry Point of Interest
    - `id` string: Unique identifier for this event
    - `imageidlist` string
    - `images` object[]
      - `altText` string: Image alt text
      - `caption` string: Image caption
      - `credit` string: Image credit
      - `imageId` string
      - `ordinal` string
      - `path` string
      - `title` string: Image title
      - `url` string: Image URL
    - `infourl` string: URL for more information about the event
    - `isallday` string: The event takes place all day
    - `isfree` string: The event is free
    - `isrecurring` string: The event has recurrence
    - `isregresrequired` string: The event requires registration or reservation
    - `latitude` string, nullable: The latitude of the event location
    - `location` string: The location the event takes place
    - `longitude` string, nullable: The longitude of the event location
    - `organizationname` string: Name of the organization associated with event
    - `parkfullname` string: Name and designation of the park associated with event
    - `portalname` string: Name of the portal site associated with event
    - `recurrencedateend` string, date: Date the event recurrence ends
    - `recurrencedatestart` string, date: Date the event recurrence starts
    - `recurrencerule` string: Recurrence rule for event
    - `regresinfo` string: Additional information on required reservation or registration for event
    - `regresurl` string: URL for required reservation or registration for event
    - `sitecode` string: Site code of the associated site for event
    - `sitetype` string: Site type of the associated site for event
    - `subjectname` string: Name of associated subject site for event
    - `tags` string[]: Tags associated with event
    - `timeinfo` string: Additional information about times for event
    - `times` object[]: Time information for event
      - `sunrisestart` string: Event begins at sunrise
      - `sunsetend` string: Event ends at sunset
      - `timestart` string: Time event begins
      - `timeend` string: Time event ends
    - `title` string: Event title
    - `types` string[]: Type(s) of event
  - `dates` string
  - `pagenumber` string
  - `pagesize` string

## Other responses

- `400`: Invalid status value

---

[API](https://skmtc.dev/nps/apis/national-park-service.md) - [All operations](https://skmtc.dev/nps/apis/national-park-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nps/apis/national-park-service/revisions/f1704d8b8142?raw)