NPnps
tours

GET /tours

Returns tours at National Park Service sites, with optional filters for tour 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 tour 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 display order. 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 name, parkCode, Title, and relevanceScore.

Response

successful operation

totalstring
limitstring
startstring

Example response

{
  "total": "2",
  "data": [
    {
      "topics": [
        {
          "id": "77B7EFDF-1A74-409C-8BA2-324EC919DB0E",
          "name": "Arctic"
        }
      ],
      "description": "A tour that exists purely to ensure tours show up in the API successfully.",
      "images": [
        {
          "credit": "NPS Photo / Emily Mesner",
          "crops": [
            {
              "aspectRatio": 1,
              "url": "https://www.nps.gov/common/uploads/tours/primary/6B230275-0DCB-8052-19039607F9A25672.jpg"
            }
          ],
          "altText": "a brown bear",
          "title": "Title!",
          "caption": "Grizzlies can sometimes be seen in the Savage River area of Denali",
          "url": "https://www.nps.gov/common/uploads/tours/6B230275-0DCB-8052-19039607F9A25672.jpg"
        }
      ],
      "durationMax": "120",
      "stops": [
        {
          "assetId": "CD74CF08-6C88-418B-A2C2-F7B957975C76",
          "assetName": "Savage River",
          "assetType": "Place",
          "id": "6886BB60-C11B-1A87-589FEABEE387E9E4",
          "ordinal": "1"
        }
      ],
      "activities": [
        {
          "id": "BFF8C027-7C8F-480B-A5F8-CD8CE490BFBA",
          "name": "Hiking"
        }
      ],
      "durationUnit": "m",
      "title": "API Test",
      "id": "6880801D-EDC4-00AF-FBD5EAFFB3B7FD32",
      "durationMin": "60",
      "relevanceScore": 1,
      "type": "Standard",
      "park": {
        "states": "AK",
        "designation": "National Park & Preserve",
        "parkCode": "dena",
        "fullName": "Denali National Park & Preserve",
        "url": "https://www.nps.gov/dena/index.htm",
        "name": "Denali"
      }
    }
  ],
  "limit": "50",
  "start": "0"
}

Changes

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