grepigrEPI

Global Repository of Epidemiological Parameters

About

grEPI

grEPI is a digital public good for health, a free and open-access software product whose aim is to serve as a living, global, standardized repository (library) of epidemiological parameter estimates by enabling user-friendly online interface for exploring, retrieving and providing data throught web application features as well as API services as machine-readable interface for retrieving desired data programatically.

While the World Health Organization hosts grEPI on its dedicated cloud infrastructure, the product is being designed, developed and maintained by the Epidemiological Parameters Community of Practice under the Collaboratory initiative.

Envisioned as a living resource that continuously evolves through community feedback loops and contributions, grEPI, in its initial proof-of-concept version, brings together epidemiological parameter estimates extracted from the scientific literature by subject matter experts. It provides a central view with standardized vocabulary, such as disease and pathogen context, as well as methodological details and, references to the corresponding data sources. By providing transparent and adjustable views on epidemiological parameter estimates and related data sources, grEPI aims to enable quick identification of relevant epidemiological parameter estimates and support more efficient, reproducible, and consistent epidemiological analyses, strengthening evidence-based decision-making in public health.

Highlights

diamondStandards and quality

To address the main challenge of data heterogeneity and the significant amount of time and effort needed to adjust the data to be able to use it further, grEPI is currently adhering to the WHO International Classification of Diseases(ICD-11), legally cleared WHO Geo Data standard for Health Boundaries for Administrative Level 0 (Countries, Territories, Areas) and is also implementing best practices for classifying and categorizing specific properties of an epidemiological parameter estimate or a literature item.

Using standardized actively maintained vocabulary increases the data quality and enables better understanding of the context.

Learn more arrow_right_alt

exploreAccessibility and Usability

Using main features of grEPI, such as browsing and exporting epidemiological parameter estimates and literature in both web application and API, does not bear any licensing cost and does not require creating an application account. As a digital public good for health, access to grEPI is free and open. One only needs to be connected to the Internet to be able to use grEPI in their web browser.

Using grEPI web application interface does not require any specific technical background or skillset. The interface is designed to be user-friendly as possible and to enable smooth user journeys to the desired outcomes.

Learn more arrow_right_alt

lock_open_rightFlexibility and scalability

The design approach of grEPI enables quick adaptation and response to changes in the field with the goal of serving as a global digital public good for health. grEPI is not limited to a disease, pathogen, geography, primary data source or any other specific context. The underlying relational database is designed to support entities and relations rather than hardcoding specific contexts for specific use cases.

Reference data module serves as a core feature of grEPI web application to enable quick configuration of new specific contexts or changes to the existing ones.


Learn more arrow_right_alt

codeCommunity-driven resource

grEPI aims to be a living, community-driven resource, with additional data continuously added and refined over time.
Future improvements are determined taking into consideration community feedback and priorities defined by the GREP Core Working Group.

grainStructured and traceable data

Each epidemiological parameter estimate includes structured metadata - such as parameter definition, disease and pathogen properties, quantitative representations, population study and other methodological details - and links to source publications, ensuring transparency, comparability, and reuse.​

linkInteroperability

There are existing tools already adopted by the experts in the field as well as exciting tools under development with great potential to introduce further improvements. The aim of grEPI is to contribute to the existing epi ecosystem in the most useful ways. The first goal is to explore ways of using grEPI as a data source - epidemiological parameter estimate library by epiparameter tool.

Features

Explore data and adjust data view to your own needs

analyticsEpidemiological parameters

The interactive view enables you to quickly discover epidemiological parameter estimates, articles those were derived from and data sources they were pulled from by:

  • applying full-text search and/or sorting the grid by specific column and/or applying filters in one or more columns
  • selecting properties of interest to display in the grid and appear in the exported file
  • exporting the full dataset or only specific records to your local drive in csv file format

articleLiterature

The interactive view enables you to quickly discover scientific articles of interest by:

  • applying full-text search and/or sorting the grid by specific column and/or applying filters in one or more columns
  • selecting properties of interest to display in the grid and appear in the exported file
  • exporting the full dataset or only specific records to your local drive in csv file format

databaseReference data

The interactive view provides an overview of the common dictionary and related standards used to define certain properties of an epidemiological parameter estimate or an article.


The public view offers a limited view of the reference data library. The authenticated view, which does require an active Collaboratory account, allows a full view of the reference data library.

lightbulb
Explore grEPI!

Check out our grEPI Web Application Guide and learn how to access grEPI and adjust data views to best serve your needs.

grEPI Web App Guide arrow_right_alt
 

Check out our grEPI API Guide to learn how to access and use grEPI public API endpoints to retrieve the data of your interest.

grEPI API Guide arrow_right_alt
User Guide

Getting started with grEPI web application

grEPI is a publicly accessible web application organized into sections for epidemiological parameters, literature, and reference data. It supports browsing, search, filtering, customizable views, and CSV export. For full details on each section and how to use grEPI, see the comprehensive user manual or follow the guide below

API

Getting started with grEPI API public endpoints

grEPI provides a public, read-only REST API that returns data in JSON format. No authentication is required. The base URL for all requests is https://collaboratory.who.int/grepi/api. String filters are case-insensitive and support partial matching. For full details, see the grEPI API documentation.

EpiParameterEstimates

Epidemiological parameter estimates extracted from the literature. Filter by disease, pathogen, estimate type, and more.

Estimates
EpiParameterEstimates_Diff

Shows differences between two different versions of the same Epidemiological parameter estimate entry.

Estimates Versioning
PublicArticle

Literature records from which parameter estimates have been extracted. Search by DOI, title, author, or year.

Literature
PathogenTaxonomy

Pathogen taxonomy with grEPI preferred names and ICD codes.

Reference Pathogen ICD-11
DiseaseCausedByPathogen

Disease-to-pathogen mappings with grEPI preferred names and ICD codes.

Reference Disease Pathogen ICD-11
Example
Retrieve Measles Estimates with R
library(httr2)
resp <- request("https://collaboratory.who.int/grepi/api/EpiParameterEstimates") |> req_url_query(Disease_Name_Preferred = "Measles") |> req_perform()
measles <- resp_body_json(resp, simplifyVector = TRUE)
Example
Retrieve Measles Estimates with Python
import requests
response = requests.get( "https://collaboratory.who.int/grepi/api/EpiParameterEstimates", params={"Disease_Name_Preferred": "Measles"} )
measles = response.json()
Release Notes

Changelog

Full version history with breaking changes, new features, bug fixes, and other important deliverables.

v2.0.1 ETA: June 2026 Under development
  • New feature (Community feedback) - grEPI web application: Notification about new grEPI versions and quick access to release notes
  • Existing feature upgrade (Community feedback) - grEPI web application: Epidemiological parameters browse form - Enable clearing of all applied data filters at once
  • Existing feature upgrade (Community feedback) - grEPI web application: Epidemiological parameters browse form - Enable resetting custom view to the default view
  • Existing feature upgrade (Community feedback) - grEPI web application: Epidemiological parameters browse form - Show Other field values in the main fields in the select menu, grid and export for easier processing of the data
  • Existing feature upgrade (Community feedback) - grEPI web application: Epidemiological parameters browse form - Select all columns - change order of columns in the exported file
  • Existing feature upgrade (Community feedback) - grEPI API - Public endpoints: GET EpiParameterEstimates - Show Other field values in the main fields
  • Bug fix (Community feedback) - grEPI web application: Epidemiological parameters browse form - Public view - Created date is not shown (blank)
v2.0.0 19 May 2026 Released
  • New feature - grEPI web application: Role-based access (EpiParameter_Contributor):Epidemiological parameters - Add new version of an epidemiological parameter estimate
  • New feature - grEPI web application: Epidemiological parameters browse form - View current version and access the version history
  • New feature - grEPI web application: Epidemiological parameters browse form - Viwe details: Compare versions of an epidemiological parameter record
  • New feature - grEPI API - Public endpoints: GET EpiParameterEstimatesVersionDiff - Comparing different versions of an epidemiological parameter record
  • Existing feature upgrade (Community feedback) - grEPI web application: Epidemiological parameters browse form - Swap places of Population study year end and start columns in the grid (default view)
  • Existing feature upgrade (Community feedback) - grEPI API - Public endpoints: Implement standard pagination
  • Existing feature upgrade (Community feedback) - grEPI API - Public endpoints: GET EpiParameterEstimates - Rename filters Time From and Time To
  • Existing feature upgrade - grEPI API - Public endpoints: GET EpiParameterEstimates - Add additional properties related to epidemiological parameter estimate record version
  • Bug fix (Community feedback) - grEPI web application: Epidemiological parameters browse form - Select all option does not select all attributes
  • Bug fix (Community feedback) - grEPI web application: Sometimes the sidebar disappears
v1.0.0 13 April 2026 Initial release - Proof of Concept
  • grEPI web application: Public and authenticated views - Epidemiological parameters module, Literature module, Reference data module, User Administration module
  • grEPI API: Public GET endpoints: EpiParameterEstimates, PublicArticle, DiseaseCausedByPathogen, PathogenTaxonomy