Generating your token

To be able to use the package you’ll need a CLIENT_ID and CLIENT_SECRET from the WHO website. Follow these instructions to obtain it:

1. Go to the WHO ICD API website at https://icd.who.int/icdapi and click on Register inside the API Access section:

Image of the ICD API website indicating where the Register button for the API lies

2. Fill out your information and verify your email.

Image of the API website with the register form

3. Once your email is verified go to the Login page. Enter your email and password:

API login page requesting the user for email and password

4. Read and accept the terms and conditions for the API

Image of API website indicating where is the button to accept terms and conditions

5. Under API Access click on View API access key(s)

Image of API website indicating where is the button to View the API access keys

6. Your client id and secret will be required by the WHOicd library. Copy them, they are the equivalent to a user and password for this API. You’ll need them to interact with the WHO ICD. Don’t share them!!

Image of API website indicating where is the button to View the API access keys

7. Now go back to R and use them!

library(WHOicd)

#Substitute for your ID and SECRET
token <- get_token(CLIENT_ID, CLIENT_SECRET)

#Check that they work by searching all ICD-10 releases
icd10_releases(token)
#> [1] "2019" "2016" "2010" "2008"