SoilGrids banner

REST SoilGrids API

These are the supporting pages of Soilgrids REST API documentation. Here developers can find the necessary documentation to access the REST interface, query data and download tiles. Developers can access soil information and values in a simple and straight forward way, without major technical requirements. For technical support refer to our mailing list.

Please read our data policy and disclaim here: ISRIC data policy

SoilGrids — soil property and class maps

SoilGrids is a collection of updatable soil property and class maps of the world at a relatively coarse spatial resolution (250 m, 1 km) produced using state-of-the-art soil mapping methods. SoilGrids provides global predictions for number of numeric soil properties (organic carbon, bulk density, CEC, pH, soil texture fractions and coarse fragments) at seven standard depths (0, 5, 15, 30, 60, 100 and 200 cm); in addition to predictions of depth to bedrock and soil classes based on the WRB and USDA classification systems. For a complete documentation refer to the SoilGrids homepage.


Examples of use

SoilGrids REST is currently used to display values of soil properties in the SoilInfo App (spatial query by location) and the webmapping interface. Some example of data query outputs can be found here.



REST (representational state transfer) is an easy approach to run web service and the common-joe likes to see the results immediately diplayed on his/her browser. The common choice for data transfer in mobile development is the AJAX call to some REST interface. The soilgrids REST API will provide support for developers to access data, query and display it.

The current API is divided into 2 major URIs: point-query and download. The first is used to query the data, while the second to download specific tiles of data in geotiff format. The Description section contains information about CORS, HTTP Verb support and extra service metadata.