thingstodo

GET /thingstodo

Returns activities and experiences visitors can do at National Park Service sites, with optional filters for IDs, 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

idstring

A comma delimited list of things to do IDs.

parkCodestring

A comma delimited list of 4 character park codes.

stateCodestring

A comma delimited list of 2 character state codes.

qstring

A string to search for.

limitinteger

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

startinteger

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

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 descending order of date last modified. (Note that the date last modified is an unexposed property.) If sorting by relevanceScore, you will likely use -relevanceScore as a higher score indicates a more accurate result. The only sort option, besides the default, is relevanceScore.

Response

successful operation

totalstring
limitstring
startstring

Example response

{
  "total": "638",
  "data": [
    {
      "location": "Northeast Area",
      "seasonDescription": "",
      "accessibilityInformation": "<p>This skier-tracked easy trail follows a fairly flat old road after crossing a narrow bridge over Soda Butte Creek at the trailhead. The trail elevation gain/loss is 132 feet. Service dogs allowed with backcountry access permit.</p>",
      "longitude": "",
      "geometryPoiId": "8793be28-0d54-493f-8556-877e7ecbe937",
      "relatedParks": [
        {
          "states": "ID,MT,WY",
          "fullName": "Yellowstone National Park",
          "url": "https://www.nps.gov/yell/index.htm",
          "parkCode": "yell",
          "designation": "National Park",
          "name": "Yellowstone"
        }
      ],
      "isReservationRequired": "false",
      "ageDescription": "",
      "url": "https://www.nps.gov/thingstodo/yell-bannock-ski-trail.htm",
      "petsDescription": "Qualified service animals are welcome throughout the park and in all park facilities. However, they must be leashed and under your control at all times. This trail requires a backcountry access pass for service animals.<br />\n<br />\n<br />\n ",
      "timeOfDayDescription": "",
      "images": [
        {
          "credit": "",
          "crops": [
            {
              "aspectRatio": "3",
              "url": "https://www.nps.gov/common/uploads/cropped_image/primary/20970C88-BB81-37F7-5FB606A6D4A87D9B.jpeg"
            },
            {
              "aspectRatio": "1",
              "url": "https://www.nps.gov/common/uploads/cropped_image/secondary/20970C88-BB81-37F7-5FB606A6D4A87D9B.jpeg"
            }
          ],
          "altText": "The Bannock Trail is a mostly flat through mature forest.",
          "title": "",
          "caption": "",
          "url": "https://www.nps.gov/common/uploads/cropped_image/20970C88-BB81-37F7-5FB606A6D4A87D9B.jpeg"
        }
      ],
      "feeDescription": "",
      "id": "8B175753-D37B-4DD5-BF96-00383F7BB46C",
      "age": "",
      "relatedOrganizations": [],
      "arePetsPermittedWithRestrictions": "false",
      "activities": [
        {
          "id": "F9B1D433-6B86-4804-AED7-B50A519A3B7C",
          "name": "Skiing"
        }
      ],
      "activityDescription": "Easiest",
      "locationDescription": "The trail begins at Warm Creek picnic area and ends in Silver Gate, Montana.",
      "doFeesApply": "false",
      "longDescription": "<p>The Bannock Ski Trail is a 2 mile (3.2 km) easy ski that follows the old road bed that once used to supply the mining town of Cooke City, Montana. Begin at Warm Creek picnic area, one mile west of the Northeast Entrance. This trail takes its name from the Bannock band of the Shoshone, who used this route to reach the buffalo grounds of the Great Plains. After crossing Soda Butte Creek, the terrain is mostly flat and the trail traverses open meadows and mixed conifer forests. You will reach the North Absaroka Wilderness approximately one mile (1.6 km) from the trailhead. At two miles (3.2 km) you come to Silver Gate, Montana. From here the road bed is used as a snowmobile route and is good skiing to Cooke City, 3 miles (4.8 km) to the east.</p>\n\n<p><b>Notes:</b> Bison and elk frequent this trail. Federal regulations require you to stay at least 100 yards (91 m) away from bears and wolves, and at least 25 yards (23 m) away from bison and all other wild animals.</p>\n\n<p>Check out the<a href=\"/thingstodo/yell-bannock-ski-trail.htm#Details\" id=\"CP___PAGEID=5744528,yell-bannock-ski-trail.htm#Details,30639|\"> ski trail details and accessibility information</a> at the bottom of this page.</p>",
      "reservationDescription": "",
      "season": [
        "Winter"
      ],
      "topics": [
        {
          "id": "5BE55D7F-BDB6-4E3D-AC35-2D8EBB974417",
          "name": "Trails"
        }
      ],
      "durationDescription": "The duration will vary depending on fitness level, snow conditions, and length of time spent along the trail.",
      "arePetsPermitted": "false",
      "timeOfDay": [
        "Day"
      ],
      "title": "Bannock Ski Trail",
      "latitude": "",
      "shortDescription": "The Bannock Ski Trail is a 2 mile (3.2 km) easy ski that follows the old road bed that once used to supply the mining town of Cooke City, Montana.",
      "duration": "1-2 Hours",
      "relevanceScore": 1,
      "tags": [
        "Yellowstone National Park",
        "Yellowstone National Park ski trail",
        "ski trail",
        "snowshoe trail",
        "snowshoeing",
        "cross country skiing",
        "Northeast Area",
        "easy ski",
        "forested trail",
        "mountains",
        "recreation",
        "winter recreation"
      ]
    }
  ],
  "limit": "50",
  "start": "0"
}

Changes

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