rhdx is an R client for the Humanitarian Exchange Data platform.


The Humanitarian Data Exchange platform is the open platform to easily find and analyze humanitarian data.


This package is not on yet on CRAN and to install it, you will need the remotes package. You can get rhdx from Gitlab or Github

rhdx: A quick tutorial


The first step is to connect to HDX using the set_rhdx_config function and check the config using get_rhdx_config

Now that we are connected to HDX, we can search for dataset pages using search_datasets, access resources on the dataset pages with the get_resources function and finally read the data directly into the R session using read_session. magrittr pipes operator are supported

read_session will not work for all data in HDX, so far the following format are supported: csv, xlsx, xls, json, geojson, zipped shapefile, kmz, zipped geodatabase and zipped geopackage. I will consider adding more data types in the future.

Getting data in R a short tutorial

Connect to a server

In order to connect to HDX, we can use the set_rhdx_config function

set_rhdx_config(hdx_site = "prod")

Choose the dataset you want to manipulate in R, in this case we will take the first one.

The result of search_datasets is a list of HDX datasets, you can manipulate this list like any other list in R. We can use purrr::pluck to select the element we want in our list, here it is the first.

Choose a resource we need to download/read

For this example, we are looking for the displacement data and it’s the first resource in the dataset page. We can use pluck on the list of resources or the helper function get_resource(resource, resource_index) to select the resource we want to use. The selected resource can be then downloaded and store for further use or directly read into your R session using the read_session function. The resource is a json file and it can be read directly using jsonlite package, we added a simplify_json option to get a vector or a data.frame when possible instead of a list.