Rwanda MoH Athena API

Introduction

The Rwanda Ministry of Health Athena API provides a flexible and powerful way to access health data programmatically. This API allows for complex queries and data aggregations.

Base URL

https://api.moh.gov.rw/athena/

Authentication

API requests require authentication. Contact the Rwanda Ministry of Health data team to obtain your API key.

Available Endpoints

• /api/indicators

  - List of all health indicators

• /api/dimensions

  - Available dimensions for data filtering

• /api/data</code

  - Actual indicator data

Query Examples

Get all indicators

GET https://api.moh.gov.rw/athena/api/indicators

Get data for a specific indicator

GET https://api.moh.gov.rw/athena/api/data?indicator=MALARIA_CASES

Get data for multiple indicators

GET https://api.moh.gov.rw/athena/api/data?indicator=MALARIA_CASES,HIV_PREVALENCE&year=2023&district=GASABO

Response Format

The API returns data in JSON format. Here's an example response:

{
                "metadata": {
                    "indicators": ["MALARIA_CASES", "HIV_PREVALENCE"],
                    "year": 2023,
                    "district": "GASABO"
                },
                "data": [
                    {
                    "indicator": "MALARIA_CASES",
                    "value": 1234
                    },
                    {
                    "indicator": "HIV_PREVALENCE",
                    "value": 5.6
                    }
                ]
                }

Advanced Features

Data Aggregation

The Athena API supports data aggregation. You can specify aggregation methods in your query:

 
GET https://api.moh.gov.rw/athena/api/data?indicator=MALARIA_CASES&year=2023&aggregate=SUM&by=district

Time Series Data

You can retrieve time series data by specifying a date range:

GET https://api.moh.gov.rw/athena/api/data?indicator=MALARIA_CASES&startDate=2020-01-01&endDate=2023-12-31&frequency=MONTHLY

Rate Limiting

The API is rate-limited to 1000 requests per hour per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Support

For any questions or issues regarding the API, please contact our support team at api-support@moh.gov.rw.