The API is offered through a REST interface.  You can use your browser to access URLs, and you can use pretty much any HTTP client in any programming language to interact with the API.


REST stands for REpresentational State Transfer.  Following the REST architecture means that all the public data has about geocaches, log, users, etc. as well as methods to find groups of geocaches, logs, users, etc. are available on the internet through a unique resource identifier (a URI or URL). These resources make up the API. You can access these resources just like you would any other resource on the internet, by calling its URL and specifying parameters for that URL.

For example:
To get information about a geocache with OX code OXERF4R, call
To get information about a user with id 98428 call To find all the geocaches in an area call,234,-94.549, 48,477,-94.778.

This documentation details where all of these resources are located and what parameters you can pass to them to control what information you receive.

Standard HTTP

Using a rest interface means that the API is accessible through standard HTTP requests. No additional wrapping or meta data is required.

Since web browsers already use HTTP, requesting data from the API can be tested by pasting the request into the browser's address bar and looking at the result in the browser.

Using standard HTTP also eliminates many problems that are caused by firewalls.


HTTP supports several different types of methods when making a request. The API takes different actions depending on which method is used.

GET requests should be made when you want to fetch or read information from the database.

POST requests should be made when you want to add a new object to the database or modify existing data.