API Reference

Base URL: https://api.medova.health/v1

All endpoints require authentication via Bearer token. See Getting Started for setup.

Countries

GET /v1/countries

List all countries with basic health metadata.

Query Parameters:

• region — filter by WHO region (e.g., AFRO, EURO, SEARO)
• risk_level — filter by health risk level (low, medium, high, very_high)
• locale — response language (default: en, supports 15 locales)

GET /v1/countries/{iso2}

Get detailed country profile including health score, vaccination requirements, disease risks, travel alerts, and climate data.

GET /v1/countries/{iso2}/requirements

Get vaccination requirements for a specific country — required, recommended, and situational vaccines with dosage schedules.

GET /v1/countries/{iso2}/diseases

Get disease risks for a country with prevalence, seasonality, and prevention measures.

Diseases

GET /v1/diseases

List all tracked diseases with ICD-11 codes and risk categories.

GET /v1/diseases/{slug}

Get detailed disease profile — symptoms, transmission, prevention, treatment, and affected countries.

Vaccines

GET /v1/vaccines

List all vaccines with ATC codes, manufacturers, and schedules.

GET /v1/vaccines/{slug}

Get detailed vaccine profile — dosage, contraindications, side effects, and country requirements.

Clinics

GET /v1/clinics

Search travel health clinics by location.

Query Parameters:

• lat, lng — coordinates for proximity search
• radius — search radius in km (default: 25, max: 100)
• country — ISO2 country code filter
• city — city slug filter
• services — comma-separated service filter

GET /v1/clinics/{id}

Get clinic details — address, services, opening hours, accepted insurance, and available vaccines.

Health Scores

GET /v1/health-scores/{iso2}

Get the composite health score (0–100) for a country, broken down by component: disease risk, healthcare access, vaccination coverage, environmental factors, and travel advisories.

Travel Alerts

GET /v1/alerts

Get active travel health alerts (WHO DONs, CDC notices, outbreak notifications).

Query Parameters:

• country — filter by ISO2 code
• severity — filter by severity (info, warning, critical)
• since — ISO 8601 date, alerts published after this date

Pagination

List endpoints support cursor-based pagination:

• limit — items per page (default: 20, max: 100)
• cursor — opaque cursor from previous response

Error Codes