Introduction

The Geocaching API is designed to give developers access to Geocaching.com data and enhance the geocaching community experience. The API uses a RESTful approach and json data to make consuming the service simple and familiar. Partners who are accepted into the API program will receive a test and live token. The test token will allow our partners to play with the API without affecting live data. Once comfortable moving forward to live data, you may request a live token. You will need to provide access to your application to Geocaching HQ so that we may review it before receiving a live token.

As an API partner:

• We hope you create an application that is useful, inspiring and benefits the geocaching community.
• You may not create an application that merely replicates or competes with the Geocaching HQ core services.
• You must respect geocaching users and their privacy choices.
• You must comply with Geocaching HQ's Branding Guidelines and use the provided Geocaching logos and links where you use Geocaching HQ data and services in your application.
• Your application must comply with the Geocaching API Agreement, Geocaching Service Terms, your privacy policy and all applicable laws.

Authorization

The API uses OAuth 2.0's authorization code grant flow to authorize you to access Geocaching.com data on behalf of your app/site user. The OAuth process uses simple steps to authorize the application and allow the end user to grant your app/site permission to access their data.

The API also supports and requires PKCE use which protects against authorization code interception attacks. You can implement PKCE as part of the authorization code grant by generating a code_verifier and code_challenge. To create a code_verifier, the partner application should create and record a secret, which should be a high-entropy cryptographic random string (ASCII characters) using the unreserved characters [A-Z][a-z][0-9]["-",".","_","~"] with a minimum length of 43 characters and a maximum length of 128 characters. The code_challenge is then created by creating a SHA2 256-bit hash of the code_verifier and then base64url encoding the hash. If your application is unable to support S256 hashing, you may pass in the code_verifier untransformed and use plain as the code_challenge_method.

Code verifier (random string (ASCII characters) using the unreserved characters [A-Z][a-z][0-9]["-",".","_","~"]):
mg828Je82M441flIEEVQOm420IfdI_06v2u9HM212kgM7anId9Am_FF42m2aPE93n35M1HFxQMsy6ZvMNfq

Code challenge (base64-url encoded SHA256 hash):
qJCP3nUndZTovT_1mYcjMeNRTmdflWclG8vf7shmv28

Requirements: In order to utilize OAuth 2.0, partners need to provide Geocaching HQ with the application's staging and production redirect uris. The redirect uri passed in during the authorization process will be verified against the known uris by matching exactly. Production requires a secure uri (https) or a valid native app custom protocol.

Authorize Endpoint

Token Endpoint

{
    "access_token": "eyJyb2xlIjoiYWRtaW4iLCJ1bmlxdWVfbmFtZSI6Ik1Ob2ZNaW5kIiwic3ViIj",
    "token_type": "bearer",
    "expires_in": 3599,
    "refresh_token": "d0d103213cef4f299137424a3fcf39d01d43dba028f1480885f61d3695ae702f"
}

Refresh Token Endpoint

{
    "access_token": "eyJyb2xlIjoiYWRtaW4iLCJ1bmlxdWVfbmFtZSI6Ik1Ob2ZNaW5kIiwic3ViIj",
    "token_type": "bearer",
    "expires_in": 3599,
    "refresh_token": "d0d103213cef4f299137424a3fcf39d01d43dba028f1480885f61d3695ae702f"
}

Using the Access Token

Responses

The Geocaching API uses HTTP status codes in all responses to help partners easily understand and handle the service response. The following are examples of the response objects.

List of status codes used in Geocaching API:

An error response will comprise of the HTTP status code, the status code message, an error message, and the request uri. The status code and message should give the general idea of why an error was thrown while the error message gives more specifics depending on the method. See methods for the specific error messages that can be returned.

{
  "statusCode": 404,
  "statusMessage": "Not Found",
  "errorMessage": ""
}

A successful response will include a status code but the bulk of the body will typically be the resource requested. Navigate to the methods section to see specific response bodies.

The response will also contain some custom headers.

Restrictions

Membership Restrictions

To act in accordance with our Geocaching API Agreement, there are certain restrictions you must be include for Geocaching.com Basic Members.

• Basic Members on Geocaching.com should only be offered an introductory experience and therefore be limited to three traditional or event caches per day with a maximum D/T rating of 1.5/1.5.
• Basic Members should not be able to link to Geocaching.com pages for full cache data after they've found three geocaches for that day.
• Once three caches have been found in a day by Basic Members, the following text must be displayed when the user searches for cache details on additional caches:

  Upgrade to Geocaching Premium today to download the full details for up to 6000 caches per day, view all cache types in your area, and access many more benefits. Visit Geocaching.com to upgrade.

• Basic Members should not be able to access Premium Member features including Premium Member only geocaches, list functionality, etc. See a full list of Premium Member features here.

Geocache Limits

As explained in the membership restrictions above, the number of geocaches the user can fetch per day are limited to the following. The number per day is based off of fetching lite geocaches (which contain less fields) vs full geocaches and whether the user is a premium member. The same geocache reference code will only count as one on the user's daily limit (allowing consumers to make lightweight calls without worrying about wasting the daily limit). Requesting only the referenceCode field on a geocache does not count towards the user's limit:

• 3 full geocaches per basic user per day
• 10,000 lite geocaches per basic user per day
• 16,000 full geocaches per premium user per day
• 10,000 lite geocaches per premium user per day

Trackable Discovery Limits

Users are limited to 500 trackable discoveries per 24 hours per API license (500 discovered logs per user/license combination). If a user has surpassed the limit, the API will return a 403 (Forbidden) response.

Rate Limiting

Rate limiting is enforced on all methods of the Geocaching API. The methods are limited on the calling IP, end user, and by partner consumer key. The current limits are set to:

• 60 calls per minute for user per method
• 1200 calls per minute for partner consumer key
• 6000 calls per minute for IP address

Third Party Data Sharing

To give users greater control of their data and in the interest of providing additional privacy settings, users now have the ability to opt-out of sharing their personal data with API Authorized Developers in their account settings. If a user has not authorized the sharing of their personal data, the API will either throw a 403 Forbidden exception or return only the reference code and opted-out user as the username with the reference code also returned as part of a comma delimited list of strings in the header named x-opted-out.

User Privacy Settings

In addition to third party data sharing control, users may also control who can see certain pieces of information from their profile/account. If an API call violates these settings, a 403 Forbidden may be thrown or the data being restricted will return null in the response. There's additional information about these privacy settings under the section for Get User Privacy Settings.

Pagination

The Geocaching API supports pagination in all calls that return a list of a resource. The two parameters available are skip and take. Skip will tell the query how many results to pass over and take will tell how many to return in the results. Both parameters are optional and will have a default value if not assigned as specified in the methods section. The take parameter also has a maximum value, which is specified for each relevant method in the Methods section.

Page 1 Example: ?skip=0&take=50
Page 2 Example: ?skip=50&take=50

Sorting

Sorting is supported on methods that specify a query string parameter named sort. The syntax for using query sorts is the name (or alias) of the available option and a plus (+) or minus (-) sign to denote ascending or descending order. If sorting by distance, the coordinates to use for the sorting can be denoted by adding a colon (:) and coordinates ([47,-122]) to the end of the plus or minus. Available sorting options can be found at the method documentation.

Example: dist+:[47,-122]
Example: name-

Fields (Partial Responses)

One way to increase the performance and shrink the payload of the Geocaching API is to use the fields parameter. This parameter can be added to any GET request to specify which object properties the app/site needs. The fields parameter can be used with a comma delimited list of all properties desired.

Example Request: https://api.groundspeak.com/v1/geocaches/gc25?fields=name,referenceCode

Example Response:

{
    "referenceCode": "GC25",
    "name": "Camels Prairie Stash"
}

To specify nested object fields, list the nested fields as a comma separated list inside square brackets ("[", "]"). This is especially useful when using the expand parameter as you can request specific expanded fields. Including the top level of an object will include all nested properties.

Example Request: https://api.groundspeak.com/v1/geocaches/gc25?fields=userData[favorited,founddate]
Example Response:

{
    "userData":
    {
        "favorited": true,
        "foundDate": "2013-07-16T12:00:00"
    }
}

{
    "userData":
    {
        "favorited": true,
        "foundDate": "2013-07-16T12:00:00",
        "dnfDate": "2013-07-05T12:00:00",
        ...
    }
}

Expand (Expanded Responses)

On the other side of fields, expand is a keyword on some endpoints to help reduce the number of calls to the API but return more data than what the endpoint normally returns. Expand allows resources that have a parent child relationship (especially when the parent has a one to many relationship with the child) from different endpoints to be combined under the parent resource. An example of this would be including geocache logs within the Get Geocache endpoint. The drawback of this approach is the payload will be larger and the call duration will be longer but depending on the platform used, this approach may be useful to your application. Expand queries allow a limited subset of data to be returned then the correct endpoint will be needed to page upon the results. Use the specific endpoint documentation to see if expand is allowed and what values are able to be expanded. The expand parameter is a comma separated array of the expanded values. Each expand parameter will include the resource name, a colon, and number (geocachelogs:5) to set the number of expanded resources returned. All expanded resources are allowed a max take of 30.

Tip: Use the fields parameter to reduce the fields that come back with the expanded resource. This will increase the efficiency as well as decrease the payload size of the request.

Example Request: https://api.groundspeak.com/v1/geocaches/gck25b?expand=geocachelogs:5,geocachelog.images:5&fields=referenceCode,geocachelogs[referencecode,text,images[url]]

Example Response:

{
  "referenceCode": "GCK25B",
  "geocacheLogs": [
    {
      "referenceCode": "GLXJA1WB",
      "text": "Nice to be able to finally visit the center of it all! TFTC!",
      "images": [
        {
          "url": "https://img.geocaching.com/12345.jpg"
        }
      ]
    },
    {
      "referenceCode": "GLXJ723B",
      "text": "2nd visit. Was here last year visiting family. Dropping off TB. ",
      "images": []
    },
    {
      "referenceCode": "GLXJ71J5",
      "text": "Drop off travel bugs at headquarters ",
      "images": [
        {
          "url": "https://img.geocaching.com/67890.jpg"
        }
      ]
    },
    {
      "referenceCode": "GLXJ710W",
      "text": "2nd visit 20018 drop off travel bugs",
      "images": []
    },
    {
      "referenceCode": "GLXJ6J18",
      "text": "Dropping off TBs",
      "images": []
    }
  ]
}

Reference Codes

Reference codes are the primary means of uniquely identifying a data object sent to or returned by the API. They are identified by a string with a two character prefix followed by a sequence of base16 or base31 characters.

The following pseudo code shows how to perform the conversion from a string based code to the 64bit integer value and vice versa.

Base16_Characters = [
    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'
]

Base31_Characters = [
    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F',
    'G', 'H', 'J', 'K', 'M', 'N', 'P', 'Q', 'R', 'T', 'V', 'W', 'X', 'Y', 'Z'
]


Id to Reference Code
--------------------

If Id < 65536
    ReferenceCode = Base16(Id) // Decimal to Hex
else
    ReferenceCode = Base31(Id + 411120)



Reference Code to Id
--------------------

if Prefix == "GC"
    ReferenceCode = Replace(code, "S", "5")
    ReferenceCode = Replace(code, "O", "0")

ReferenceCode = RemovePrefix(ReferenceCode)

FirstChar = substring(ReferenceCode, 0, 1)

if len(ReferenceCode) >= 5 or FirstChar >= 'G'
    Id = Base31(ReferenceCode) - 411120
else
    Id = Base16(ReferenceCode)

Geocache Methods

Geocache Log Methods

Trackable Methods

Trackable Log Methods

Log Draft Methods

User Waypoints Methods

List Methods

User Methods

Friend Methods

GeoTour Methods

Utility Methods

Adventure Methods

Objects

{
  "referenceCode": "GCK25B",
  "name": "Geocaching Headquarters",
  "difficulty": 1,
  "terrain": 1,
  "favoritePoints": 4482,
  "trackableCount": 211,
  "placedDate": "2004-07-22T00:00:00.000",
  "publishedDate": "2004-07-22T00:00:00.000",
  "eventEndDate": null,
  "type": "GeocachingHq",
  "geocacheType": {
    "id": 3773,
    "name": "Geocaching HQ",
    "imageUrl": "https://www.geocaching.com/images/wpttypes/3773.gif"
  },
  "size": "Other",
  "geocacheSize": {
    "id": 6,
    "name": "Other"
  },
  "userData": {
    "foundDate": "2016-06-24T12:00:00.000",
    "correctedCoordinates": {
      "latitude": 47,
      "longitude": -122
    },
    "isFavorited": true,
    "ignored": false,
    "watched": false
  },
  "status": "Active",
  "isLocked": false,
  "location": {
    "country": "United States",
    "countryId": 2,
    "state": "Washington",
    "stateId": 48
  },
  "postedCoordinates": {
    "latitude": 47.648967,
    "longitude": -122.348117
  },
  "lastVisitedDate": "2018-11-29T12:00:00.000",
  "ownerCode": "PRA09E",
  "ownerAlias": "Geocaching HQ",
  "isPremiumOnly": false,
  "shortDescription": "Welcome to Geocaching HQ’s Visitor Center!",
  "longDescription": "This cache is only available while the Visitor Center at HQ is open. ...",
  "hints": "Where would you look if you were a pirate?",
  "premiumFavoriteScore": 41,
  "additionalWaypoints": [],
  "attributes": [
    {
      "id": 24,
      "name": "Wheelchair accessible",
      "imageUrl": "https://www.geocaching.com/images/attributes/wheelchair-yes.gif",
      "isOn": true
    },
    {
      "id": 13,
      "name": "Available at all times",
      "imageUrl": "https://www.geocaching.com/images/attributes/available-no.gif",
      "isOn": false
    },
    {
      "id": 7,
      "name": "Takes less than an hour",
      "imageUrl": "https://www.geocaching.com/images/attributes/onehour-yes.gif",
      "isOn": true
    },
    {
      "id": 6,
      "name": "Recommended for kids",
      "imageUrl": "https://www.geocaching.com/images/attributes/kids-yes.gif",
      "isOn": true
    },
    {
      "id": 41,
      "name": "Stroller accessible",
      "imageUrl": "https://www.geocaching.com/images/attributes/stroller-yes.gif",
      "isOn": true
    },
    {
      "id": 28,
      "name": "Public restrooms nearby",
      "imageUrl": "https://www.geocaching.com/images/attributes/restrooms-yes.gif",
      "isOn": true
    },
    {
      "id": 26,
      "name": "Public transportation",
      "imageUrl": "https://www.geocaching.com/images/attributes/public-yes.gif",
      "isOn": true
    },
    {
      "id": 27,
      "name": "Drinking water nearby",
      "imageUrl": "https://www.geocaching.com/images/attributes/water-yes.gif",
      "isOn": true
    },
    {
      "id": 14,
      "name": "Recommended at night",
      "imageUrl": "https://www.geocaching.com/images/attributes/night-no.gif",
      "isOn": false
    },
    {
      "id": 38,
      "name": "Campfires",
      "imageUrl": "https://www.geocaching.com/images/attributes/campfires-no.gif",
      "isOn": false
    }
  ],
  "ianaTimezoneId": "America/Los_Angeles",
  "relatedWebPage": "http://geocachinghq.com/schedule/",
  "url": "https://coord.info/GCK25B",
  "backgroundImageUrl": null,
  "containsHtml": true,
  "findCount": 15760,
  "hasSolutionChecker": false,
  "owner": {
    "membershipLevelId": 2,
    "findCount": 0,
    "hideCount": 114,
    "favoritePoints": 1,
    "profileText": "Geocaching HQ is the home base for all Geocaching employees...",
    "url": "https://coord.info/PRA09E",
    "referenceCode": "PRA09E",
    "username": "Geocaching HQ",
    "avatarUrl": "https://img.geocaching.com/user/avatar/f777d091-4a90-406b-a998-70ec06b4f6f1.png"
  }
}

{
  "referenceCode": "GCK25B",
  "name": "Geocaching Headquarters",
  "difficulty": 1,
  "terrain": 1,
  "favoritePoints": 4482,
  "trackableCount": 211,
  "placedDate": "2004-07-22T00:00:00.000",
  "publishedDate": "2004-07-22T00:00:00.000",
  "eventEndDate": null,
  "type": "GeocachingHq",
  "geocacheType": {
    "id": 3773,
    "name": "Geocaching HQ",
    "imageUrl": "https://www.geocaching.com/images/wpttypes/3773.gif"
  },
  "size": "Other",
  "geocacheSize": {
    "id": 6,
    "name": "Other"
  },
  "userData": {
    "foundDate": "2016-06-24T12:00:00.000",
    "correctedCoordinates": {
      "latitude": 47,
      "longitude": -122
    },
    "isFavorited": false,
    "ignored": false,
    "watched": false
  },
  "status": "Active",
  "isLocked": false,
  "location": {
    "country": "United States",
    "countryId": 2,
    "state": "Washington",
    "stateId": 48
  },
  "postedCoordinates": {
    "latitude": 47.648967,
    "longitude": -122.348117
  },
  "attributes": [
    {
      "id": 24,
      "name": "Wheelchair accessible",
      "imageUrl": "https://www.geocaching.com/images/attributes/wheelchair-yes.gif",
      "isOn": true
    },
    {
      "id": 13,
      "name": "Available at all times",
      "imageUrl": "https://www.geocaching.com/images/attributes/available-no.gif",
      "isOn": false
    },
    {
      "id": 7,
      "name": "Takes less than an hour",
      "imageUrl": "https://www.geocaching.com/images/attributes/onehour-yes.gif",
      "isOn": true
    },
    {
      "id": 6,
      "name": "Recommended for kids",
      "imageUrl": "https://www.geocaching.com/images/attributes/kids-yes.gif",
      "isOn": true
    }
  ],
  "lastVisitedDate": "2018-11-29T12:00:00.000",
  "ownerCode": "PRA09E",
  "ownerAlias": "Geocaching HQ",
  "isPremiumOnly": false,
  "ianaTimezoneId": "America/Los_Angeles",
  "relatedWebPage": "http://geocachinghq.com/schedule/",
  "url": "https://coord.info/GCK25B",
  "backgroundImageUrl": null,
  "containsHtml": true,
  "hasSolutionChecker": false,
  "premiumFavoriteScore": 41,
  "owner": {
    "membershipLevelId": 2,
    "findCount": 0,
    "hideCount": 114,
    "favoritePoints": 1,
    "profileText": "Geocaching HQ is the home base for all Geocaching employees...",
    "url": "https://coord.info/PRA09E",
    "referenceCode": "PRA09E",
    "username": "Geocaching HQ",
    "avatarUrl": "https://img.geocaching.com/user/avatar/f777d091-4a90-406b-a998-70ec06b4f6f1.png"
  }
}

{
  "referenceCode": "GL5WEA9",
  "ownerCode": "PR27A02",
  "imageCount": 0,
  "loggedDate": "2004-06-02T00:00:00",
  "text": "Example log text.",
  "geocacheLogType": {
    "id": 2,
    "name": "Found It",
    "imageUrl": "https://www.geocaching.com/images/logtypes/2.png"
  },
  "isEncoded": false,
  "isArchived": false,
  "geocacheCode": "GCK25B",
  "geocacheName": "Geocaching Headquarters",
  "geocacheType": {
    "id": 3773,
    "name": "Geocaching HQ",
    "imageUrl": "https://www.geocaching.com/images/wpttypes/3773.gif"
  },
  "ianaTimezoneId": "America/Los_Angeles",
  "usedFavoritePoint": false,
  "url": "https://coord.info/GL5WEa9",
  "upvoteTypeCounts": [
    {
      "upvoteTypeId": 1,
      "upvoteTypeName": "GreatStory",
      "count": 0,
      "upvotedByUser": false
    },
    {
      "upvoteTypeId": 2,
      "upvoteTypeName": "Helpful",
      "count": 0,
      "upvotedByUser": false
    }
  ],
  "owner": {
    "findCount": 326,
    "hideCount": 0,
    "username": "MNofMind",
    "avatarUrl": "https://img-stage.geocaching.com/gcstage/{0}/0640f488-9abe-4c2a-a786-bb75cec84357.gif",
  }
}

{
  "referenceCode": "TB1",
  "iconUrl": "http://www.geocaching.com/images/wpttypes/21.gif",
  "name": "Deadly Duck: Envy",
  "goal": "Tell a short story about committing the terrible sin of envy. Nothing incredibly evil. An example may be to envy that Ben & Jerry's pint the person at lunch was digging into.",
  "description": "While traveling north through New Mexico I encountered a vortex where 7 deadly ducks emerged from the gates of hell (not Hell, the flaming sort, but the lowercase hell where all the mischevious critters live).",
  "releasedDate": "2001-08-30T10:27:11",
  "originCountry": "United States",
  "allowedToBeCollected": false,
  "ownerCode": "PR3",
  "owner": {
    "username": "MNofMind",
    "avatarUrl": "https://img-stage.geocaching.com/gcstage/avatar/0640f488-9abe-4c2a-a786-bb75cec84357.gif",
    ...
  },
  "holderCode": null,
  "holder": null,
  "inHolderCollection": false,
  "isMissing": true,
  "milesTraveled": 0,
  "kilometersTraveled: 0",
  "trackableType": {
    "id": 21,
    "name": "Travel Bug Dog Tag",
    "imageUrl": "21.gif"
  },
  "trackingNumber": null,
  "lastDiscoveredDate": "2001-09-01T00:00:00",
  "url": "https://coord.info/TB1"
}

{
  "trackableLogCode": "TL12345",
  "geocacheCode": "GC12345",
  "trackableLogType":{
    "id": 14,
    "name": "Dropped Off",
    "imageUrl": "https://www.geocaching.com/images/logtypes/14.png"
  }
  "loggedDate": "2001-09-28T00:00:00",
  "coordinates": {
    "latitude": 47.648967,
    "longitude": -122.348117
  }
}

{
  "referenceCode": "TL2A",
  "ownerCode": "PR2E27",
  "owner": {
    "username": "MNofMind",
    "avatarUrl": "https://img-stage.geocaching.com/gcstage/{0}/0640f488-9abe-4c2a-a786-bb75cec84357.gif",
    ...
  },
  "imageCount": 0,
  "trackableCode": "TB1",
  "loggedDate": "2001-09-28T00:00:00",
  "text": "I envy Cache Maru's eTrex Vista, with it's amazing 24M of memory, color screen, and maps, way beyond my eTrex Summit.  Oh Garmin V, when will you come, so someone will envy me...\r\n\r\nI have Envy, given to Denise by jeremy and then given to me.  I bet you envy me now!  I hope to place envy during a Q-13 tv crew cache, stay tuned!",
  "isRot13Encoded": false,
  "trackableLogType": {
    "id": 19,
    "name": "Grab It (Not from a Cache)",
    "imageUrl": "https://www.geocaching.com/images/logtypes/19.png"
  },
  "url": "https://coord.info/TL2A"
}

{
  "referenceCode": "LD7Z53GB",
  "geocacheCode": "GCK25B",
  "geocacheLogType": {
    "id": 2,
    "name": "Found It",
    "imageUrl": "https://www.geocaching.com/images/logtypes/2.png"
  },
  "note": "example draft text",
  "loggedDate": "2017-10-13T16:28:59.51"
}

{
  "geocacheLog": {
    "referenceCode": "GL12345",
    "ownerCode": "PR1",
    "owner": {
      "referenceCode": "PR1",
      "username": "testuser"
    },
    "imageCount": 0,
    "isEncoded": false,
    "isArchived": false,
    "url": "https://coord.info/GL12345",
    "loggedDate": "2019-02-08T17:28:04.827Z",
    "text": "i promoted a draft.",
    "geocacheLogType": {
      "id": 2,
      "name": "FoundIt"
    },
    "geocacheCode": "GC12345",
    "usedFavoritePoint": false
  },
  "successfulImages": [],
  "failedImages": [],
  "favoritePointApplied": false,
  "draftDeleted": true
}

{
    "referenceCode": "UW167H5Q",
    "description": "Coordinate Override",
    "isCorrectedCoordinates": true,
    "coordinates": {
        "latitude": 0.6489666666666667,
        "longitude": -0.3481166666666667
    },
    "geocacheCode": "GCK25B"
}

{
    "name": "GCK25B Parking",
    "coordinates": {
        "latitude": 47.64896666666667,
        "longitude": -122.34811666666667
    },
    "description": "test additional waypoint",
    "typeId": 217,
    "visibilityTypeId": 0,
    "typeName": "Parking Area",
    "prefix": "PK",
    "url": "https://geocaching.com/seek/wpt.aspx?WID=12345"
}

{
   "id": 1,
   "name": "Dogs",
   "isOn": true,
   "imageUrl": "https://www.geocaching.com/images/attributes/dogs-yes.gif"
}

{
   "id": 1,
   "name": "Dogs",
   "hasYesOption": true,
   "hasNoOption": true,
   "yesIconUrl": "https://www.geocaching.com/images/attributes/dogs-yes.gif",
   "noIconUrl": "https://www.geocaching.com/images/attributes/dogs-no.gif"
}

{
    "country": "United States",
    "countryId": 2,
    "state": "Washington",
    "stateId": 48
}

{
    "id": 6,
    "name": "Other"
}

{
  "referenceCode": "BM4GC42",
  "lastUpdatedDateUtc": "2017-10-13T17:45:04.603Z",
  "createdDateUtc": "2017-10-13T17:45:04.38Z",
  "count": 1,
  "ownerCode": "PR27A92",
  "name": "HQ Geocaches",
  "description": "to grab the HQ icon",
  "typeId": 2,
  "isPublic": false,
  "isShared": false,
  "url": "https://coord.info/BM4GC42"
}

{
    "referenceCode": "GCK25B",
    "listItemName": "GCHQ!",
    "listItemDescription" "First stop on Seattle trip.",
    "name": "Geocaching Headquarters"
    ...
}

{
    "referenceCode": "GCK25B",
    "name": "Geocaching Headquarters"
}

{
    "successes": [
        "gc1"
    ],
    "failures": [
        {
            "referenceCode": "gc2",
            "message": "gc2 already exists in BM123",
            "statusCode": 409
        }
    ]
}

{
    "referenceCode": "gc2",
    "message": "gc2 already exists in BM123",
    "statusCode": 409
}

{
  "referenceCode": "PR27A92",
  "findCount": 326,
  "hideCount": 0,
  "trackableFindCount": 24,
  "trackableOwnedCount": 20,
  "favoritePoints": 18,
  "username": "MNofMind",
  "membershipLevelId": 3,
  "joinedDateUtc": "2008-05-27 11:39:56.880",
  "avatarUrl": "https://img-stage.geocaching.com/gcstage/{0}/0640f488-9abe-4c2a-a786-bb75cec84357.gif",
  "homeCoordinates": {
    "latitude": 47.6760654544942,
    "longitude": -122.318150997162
  },
  "isFriend": false,
  "optedInFriendSharing": true,
  "souvenirCount": 42,
  "awardedFavoritePoints", 0,
  "geocacheFindCounts": [
    {
      "geocacheType": {
        "id": 3773,
        "name": "Geocaching HQ",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/3773.gif"
      },
      "count": 1
    },
    {
      "geocacheType": {
        "id": 3,
        "name": "Multi-cache",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/3.gif"
      },
      "count": 1
    },
    {
      "geocacheType": {
        "id": 4,
        "name": "Virtual Cache",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/4.gif"
      },
      "count": 2
    },
    {
      "geocacheType": {
        "id": 2,
        "name": "Traditional Cache",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/2.gif"
      },
      "count": 33
    },
    {
      "geocacheType": {
        "id": 11,
        "name": "Webcam Cache",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/11.gif"
      },
      "count": 1
    },
    {
      "geocacheType": {
        "id": 8,
        "name": "Unknown (Mystery) Cache",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/8.gif"
      },
      "count": 7
    }
  ],
  "geocacheHideCounts": [
    {
      "geocacheType": {
        "id": 2,
        "name": "Traditional Cache",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/2.gif"
      },
      "count": 6
    },
    {
      "geocacheType": {
        "id": 3,
        "name": "Multi-cache",
        "imageUrl": "https://www.geocaching.com/images/wpttypes/3.gif"
      },
      "count": 2
    }
  ],
  "trackableFindCounts": [
    {
      "trackableType": {
        "id": 21,
        "name": "Travel Bug Dog Tags",
        "imageUrl": "http://www.geocaching.com/images/wpttypes/21.gif"
      },
      "count": 6
    },
    {
      "trackableType": {
        "id": 22,
        "name": "Moun10Bike Geocoins",
        "imageUrl": "http://www.geocaching.com/images/wpttypes/22.gif"
      },
      "count": 1
    },
    {
      "trackableType": {
        "id": 328,
        "name": "Cache Run Geocoins",
        "imageUrl": "http://www.geocaching.com/images/wpttypes/328.gif"
      },
      "count": 1
    }
  ],
  "trackableOwnedCounts": [
    {
      "trackableType": {
        "id": 21,
        "name": "Travel Bug Dog Tags",
        "imageUrl": "http://www.geocaching.com/images/wpttypes/21.gif"
      },
      "count": 1
    }
  ],
  "geocacheLimits": {
    "liteCallsRemaining": 10000,
    "liteCallsSecondsToLive": null,
    "fullCallsRemaining": 2,
    "fullCallsSecondsToLive": 216000
  }
}

{
  "referenceCode": "GT29",
  "name": "HQ",
  "description": "Enjoy \"The Geocacher's Guide to the Center of Our Universe.\" Created for the Block Party by Geocaching HQ employees, this GeoTour takes you to our favorite spots in Seattle's Fremont neighborhood. The caches are within walking distance and are available year-round. Print a passport to keep track of progress.",
  "postedCoordinates": {
    "latitude": 47.64948,
    "longitude": -122.34775
  },
  "geocacheCount": 9,
  "url": "https://www.geocaching.com/play/geotours/HQ",
  "coverImageUrl": "https://img.geocaching.com/geotours/cover/7d29be9a-1df4-495d-b98e-346388c4389a.png",
  "logoImageUrl": "https://img.geocaching.com/geotours/logo/0f28454a-e295-41e9-863d-6fda3febf43a.png",
  "favoritePoints": 13096,
  "sponsor": {
    "name": "Geocaching HQ",
    "relatedWebPage": "http://www.geocaching.com/travel/",
    "relatedWebPageText": "Make your own GeoTour"
  }
}

{
  "name": "Geocaching HQ",
  "relatedWebPage": "http://www.geocaching.com/travel/",
  "relatedWebPageText": "Make your own GeoTour"
}

{
    "id": 123456,
    "requestorUserCode": "PR123",
    "requestor": {
        "referenceCode": "PR123",
        "username": "fakeusername",
        "avatarUrl": "https://geocaching.com/images/default_avatar.png"
    },
    "requestedUserCode": "PR456",
    "requested": {
        "referenceCode": "PR456",
        "username": "fakeusername2",
        "avatarUrl": "https://geocaching.com/images/default_avatar.png"
    }
    "message": "let's become friends!",
    "isOutgoing": false
}

{
    "liteCallsRemaining": 10000,
    "liteCallsSecondsToLive": null,
    "fullCallsRemaining": 2,
    "fullCallsSecondsToLive": 216000
}

{
  "geocacheType": {
    "id": 3773,
    "name": "Geocaching HQ",
    "imageUrl": "https://www.geocaching.com/images/wpttypes/3773.gif"
  },
  "count": 1
}

{
  "trackableType": {
    "id": 21,
    "name": "Travel Bug Dog Tag",
    "imageUrl": "21.gif"
  },
  "count": 1
}

{
    "imagePath": "https://souvenirs.geocaching.com/SouvenirImages/Ni84LzIwMTA/472f96b3-e23b-489b-a0f2-115df3e362f0.png",
    "thumbImagePath": "https://souvenirs.geocaching.com/SouvenirImages/NS8yMy8yMDE4/ad3ee1df-589a-420b-a349-1611ac84bfcf.png",
    "title": "Geocaching Headquarters",
    "description": "Geocaching Headquarters - also known as the \"lily pad\" - moved to the Fremont neighborhood of Seattle in October 2009. The Headquarters cache (GCK25B) is part of the \"Triad\" - one of the ultimate geocaching goals. To complete the Triad, geocachers must log the HQ cache, the original geocache location (GCGV0P) and the Project A.P.E. cache Mission 9: Tunnel of Light (GC1169).",
    "foundDateUtc": "2016-06-25T01:00:00",
    "url": "https://www.geocaching.com/souvenir?guid=3d451b99-0fb3-4d56-9c48-3f3d9e90be02"
}

{
    "description": "Great Scenery",
    "ownerCode": "PR12345",
    "url": "https://someurl/photo",
    "thumbnailUrl": "https://someurl/avatar/photo",
    "largeUrl": "https://someurl/large/photo",
    "referenceCode": "GLXXX",
    "capturedDate": 2021-05-21T07:00:00
}

{
    "base64ImageData": "base64 data string here",
    "description": "Great Scenery",
    "capturedDate": 2021-05-26T07:00:00
}

{
    "foundDate": "2017-10-03T23:37:53.079Z",
    "dnfDate": "2017-05-03T12:34:26.648Z"
    "correctedCoordinates": {
        "latitude": 0,
        "longitude": 0
    },
    "isFavorited": true,
    "ignored": false,
    "watched": false,
    "note": "personal cache note here"
}

{
    "geocacheLogCode": "GLFNH417",
    "upvoteTypeCounts": [
      {
        "upvoteTypeId": 1,
        "upvoteTypeName": "GreatStory",
        "count": 0,
        "upvotedByUser": false
      },
      {
        "upvoteTypeId": 2,
        "upvoteTypeName": "Helpful",
        "count": 0,
        "upvotedByUser": false
      }
    ]
  }

{
    "upvoteTypeId": 1,
    "upvoteTypeName": "GreatStory",
    "count": 10,
    "upvotedByUser": false
}

{
    "latitude": 47.5,
    "longitude": -122.5
}

{
    "referenceCode": "PRFAKEUSER",
    "username": "fakeusername",
    "avatarUrl": "https://geocaching.com/images/default_avatar.png"
}

{
    "id": "6930bdb4-10b7-4210-9e09-f96f26e8842b",
    "keyImageUrl" : "https://img.geocaching.com/12345.jpg",
    "title": "Test adventure",
    "location": {
        "latitude": 47.6062166666667,
        "longitude": -122.332066666667
    },
    "ratingsAverage": 5.0,
    "ratingsTotalCount": 10,
    "stagesTotalCount": 5,
    "dynamicLink": "https://adventurelab.page.link/testlink",
    "isOwned": false,
    "isCompleted": false
}

{
    "id": "12345678-ABCD-1234-EFGH-123456HIJKLM",
    "firebaseDynamicLink": "https://adventurelab.page.link/ABCD",
    "stages": [
        {
        "id": "87654321-DCBA-4321-HGFE-654321MLKJIH",
        "title": "Dropped Off",
        "stageImageUrl": "https://gsmediadata.blob.core.windows.net/mediacontainer/73847284-shif-4dfc-7dh3-193hd74kamn2",
        "isComplete": false,
        "description": "This is the stage description",
        "location": {
            "latitude": 45.1234,
            "longitude": 122.6789
            }
        }
    ]
}

{
    "id": "12345678-9123-4567-8912-3456789123456",
    "title": "Curry Plaza",
    "location": {
        "latitude": 47.6489666666667,
        "longitude": -122.348116666667
    },
    "ratingsAverage": 2,
    "ratingsTotalCount": 1,
    "stagesTotalCount": 2
}

{
    "take": 10,
    "radiusInMeters": 20,
    "origin": {
        "latitude": 45.1234,
        "longitude": 122.6789
    },
    "excludedAdventures": [ "12345678-ABCD-1234-EFGH-123456HIJKLM" ],
    "excludeOwned": false,
    "excludeCompleted": false,
    "excludeUnPlayable": false,
    "adventureTypes": [ "sequential" ]
}