Getting Started with Medova API

Welcome to the Medova API — the programmatic interface to travel health intelligence covering vaccination requirements, disease risks, and clinic locations for 200+ countries.

Quick Start

1. Create an Account

Sign up at medova.health/register and select a Clinic or Developer plan. Free tier includes 1,000 requests/month.

2. Generate an API Key

Navigate to Dashboard → API Keys and click Create Key. Copy the key — it will only be shown once.

3. Make Your First Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept: application/json" \
     https://api.medova.health/v1/countries/TH/requirements

This returns vaccination requirements for Thailand, including recommended and required vaccines, disease risks, and travel alerts.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_...

Test keys (prefixed sk_test_) work against sandbox data.

Rate Limits

Rate limit headers are included in every response:

• X-RateLimit-Limit — your plan limit
• X-RateLimit-Remaining — remaining requests
• X-RateLimit-Reset — UTC epoch when the window resets

Response Format

All endpoints return JSON. Successful responses use HTTP 200 with a data wrapper:

{
  "data": { ... },
  "meta": { "request_id": "req_abc123", "timestamp": "2026-04-16T10:00:00Z" }
}

Errors return appropriate HTTP status codes with an error object:

{
  "error": { "code": "not_found", "message": "Country not found", "status": 404 }
}

SDKs

Official SDKs are coming soon for JavaScript/TypeScript and Python. In the meantime, the REST API works with any HTTP client.

Next Steps

• API Reference — full endpoint documentation
• Data Sources — where our data comes from
• Security — authentication and data protection details