NPnps
parks

GET /parks

Returns information about National Park Service parks and sites, with optional filters for park codes, state codes, or a search term.

Request

  • Base URL
    https://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-10 characters in length).

stateCodestring[]

A comma delimited list of 2 character state codes.

limitinteger

Number of results to return per request. Default is 50.

startinteger

Get the next [limit] results starting with this number. Default is 0.

qstring

Term to search on

sortstring[]

A comma delimited list of resource properties to sort the results by. Ascending order is assumed for each property. If descending order is desired, the unary negative should prefix the property name. Invalid property values will be ignored. If no sort parameter is passed in a request, the default sort is by fullName. If sorting by relevanceScore, you 1) will likely use -relevanceScore as a higher score indicates a more relevant result and 2) cannot use it in conjunction with other sort properties. Possible fields to sort by are fullName, parkCode, and relevanceScore.

Response

successful operation

totalstring
limitstring
startstring

Example response

{
  "total": "496",
  "data": [
    {
      "activities": [
        {
          "id": "B33DC9B6-0B7D-4322-BAD7-A13A34C584A3",
          "name": "Guided Tours"
        }
      ],
      "addresses": [
        {
          "line1": "2 Officers Row",
          "line2": "Yellowstone National Park Headquarters",
          "line3": "",
          "city": "Yellowstone National Park",
          "stateCode": "WY",
          "countryCode": "US",
          "provinceTerritoryCode": "",
          "postalCode": "82190",
          "type": "Physical"
        },
        {
          "line1": "P.O. Box 168",
          "line2": "",
          "line3": "",
          "city": "Yellowstone National Park",
          "stateCode": "WY",
          "countryCode": "US",
          "provinceTerritoryCode": "",
          "postalCode": "82190-0168",
          "type": "Mailing"
        }
      ],
      "contacts": {
        "phoneNumbers": [
          {
            "phoneNumber": "3073447381",
            "description": "",
            "extension": "",
            "type": "Voice"
          },
          {
            "phoneNumber": "3073442014",
            "description": "",
            "extension": "",
            "type": "Fax"
          },
          {
            "phoneNumber": "3073442386",
            "description": "",
            "extension": "",
            "type": "TTY"
          }
        ],
        "emailAddresses": [
          {
            "emailAddress": "yell_visitor_services@nps.gov",
            "description": ""
          }
        ]
      },
      "description": "Visit Yellowstone and experience the world's first national park. Marvel at a volcano's hidden power rising up in colorful hot springs, mudpots, and geysers. Explore mountains, forests, and lakes to watch wildlife and witness the drama of the natural world unfold. Discover the history that led to the conservation of our national treasures 'for the benefit and enjoyment of the people.'",
      "designation": "National Park",
      "directionsInfo": "Yellowstone National Park covers nearly 3,500 square miles in the northwest corner of Wyoming (3% of the park is in Montana and 1% is in Idaho). Yellowstone has five entrance stations, and several are closed to regular vehicles during winter. It takes many hours to drive between these entrances, so be sure to check the status of roads at the entrance you intend to use while planning your trip and before you arrive.",
      "directionsUrl": "https://www.nps.gov/yell/planyourvisit/directions.htm",
      "entranceFees": [
        {
          "cost": "30",
          "description": "7-day pass for Yellowstone National Park",
          "title": "Yellowstone (private, non-commercial vehicle)"
        },
        {
          "cost": "25",
          "description": "7-day pass for Yellowstone National Park. Snowmobile entry limited to guided tours or permit holders.",
          "title": "Yellowstone (motorcycle or snowmobile)"
        }
      ],
      "entrancePasses": [
        {
          "cost": "60",
          "description": "Annual pass providing free entrance to Yellowstone National Park for one year; valid through the month of purchase. Winter use: On a snowmobile, admits the signers and children (residing in the same household under the age of 21). In a snowcoach or shuttle, it admits the signers and up to three additional persons (16 and older) for a total of four people.",
          "title": "Yellowstone National Park Annual Pass"
        }
      ],
      "fullName": "Yellowstone National Park",
      "id": "F58C6D24-8D10-4573-9826-65D42B8B83AD",
      "images": [
        {
          "credit": "NPS/Jim Peaco",
          "altText": "Crowd watching Aurum Geyser erupt",
          "title": "Aurum Geyser",
          "caption": "Aurum Geyser Erupting",
          "url": "https://www.nps.gov/common/uploads/structured_data/3C7D2FBB-1DD8-B71B-0BED99731011CFCE.jpg"
        },
        {
          "credit": "NPS/Neal Herbert",
          "altText": "Photo of bison in Lamar Valley",
          "title": "Bison in Lamar Valley",
          "caption": "Bison in Lamar Valley",
          "url": "https://www.nps.gov/common/uploads/structured_data/3C7D34E6-1DD8-B71B-0BBB1C0F478318E2.jpg"
        }
      ],
      "latLong": "lat:44.59824417, long:-110.5471695",
      "multimedia": [
        {
          "title": "The Worthington Farm",
          "id": "4FD5B472-D6D9-43AA-9532-2AC5BF920883",
          "type": "multimedia/videos",
          "url": "https://www.nps.gov/media/video/view.htm?id=4FD5B472-D6D9-43AA-9532-2AC5BF920883"
        }
      ],
      "name": "Yellowstone",
      "operatingHours": [
        {
          "name": "All Park Hours",
          "description": "Yellowstone is open daily, year-round, although activities and services are limited at night and certain times of year. The park has five entrance stations, but not all entrance stations are open year-round. Make sure to carefully read about access at each station at different times of year. And remember, all dates are weather dependent!\n\nPlease note that camping is possible only in designated campgrounds.",
          "standardHours": {
            "sunday": "All Day",
            "monday": "All Day",
            "tuesday": "All Day",
            "wednesday": "All Day",
            "thursday": "All Day",
            "friday": "All Day",
            "saturday": "All Day"
          },
          "exceptions": [
            {
              "name": "Thanksgiving Day",
              "startDate": "2015-11-26",
              "endDate": "2015-11-26",
              "exceptionHours": {
                "sunday": "Closed",
                "monday": "Closed",
                "tuesday": "Closed",
                "wednesday": "Closed",
                "thursday": "Closed",
                "friday": "Closed",
                "saturday": "Closed"
              }
            },
            {
              "name": "Christmas Day",
              "startDate": "2015-12-25",
              "endDate": "2015-12-25",
              "exceptionHours": {
                "sunday": "Closed",
                "monday": "Closed",
                "tuesday": "Closed",
                "wednesday": "Closed",
                "thursday": "Closed",
                "friday": "Closed",
                "saturday": "Closed"
              }
            }
          ]
        },
        {
          "name": "West Entrance",
          "description": "Adjacent to the town of West Yellowstone, MT, the West Entrance is usually open (weather dependent) to wheeled vehicles from the third Friday in April through early November, and to tracked-oversnow (snowmobiles and snowcoaches) vehicles from December 15 to March 15.",
          "standardHours": {
            "sunday": "Closed",
            "monday": "Closed",
            "tuesday": "Closed",
            "wednesday": "Closed",
            "thursday": "Closed",
            "friday": "Closed",
            "saturday": "Closed"
          },
          "exceptions": []
        }
      ],
      "parkCode": "yell",
      "relevanceScore": 1,
      "states": "ID,MT,WY",
      "topics": [
        {
          "id": "B912363F-771C-4098-BA3A-938DF38A9D7E",
          "name": "Aviation"
        }
      ],
      "url": "https://www.nps.gov/yell/index.htm",
      "weatherInfo": "Yellowstone's weather can vary quite a bit, even in a single day. In the summer, daytime highs can exceed 70F (25C), only to drop 20 or more degrees when a thunderstorm rolls through. It can snow during any month of the year, and winter lows frequently drop below zero, especially at night. Bring a range of clothing options, including a warm jacket and rain gear, even in the summer."
    }
  ],
  "limit": "50",
  "start": "0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.