← Back to Dashboard

API Documentation

Public API for integrating epidemiological week calculations into your applications.

Base URL

https://epiweek.com/api/v1

All endpoints support CORS and return JSON responses.

GET /api/v1/now

Get the current epidemiological week.

Query Parameters

  • standard (optional) - MMWR or ISO. Default is MMWR
  • date (optional) - Date in YYYY-MM-DD format. Default is today

Example Request

curl https://epiweek.com/api/v1/now?standard=MMWR

Example Response

{
  "week": 1,
  "year": 2026,
  "startDate": "2026-01-04T00:00:00.000Z",
  "endDate": "2026-01-10T00:00:00.000Z",
  "standard": "MMWR"
}

GET /api/v1/convert

Convert a specific date to its epidemiological week.

Query Parameters

  • date (required) - Date in YYYY-MM-DD format
  • standard (optional) - MMWR or ISO. Default is MMWR

Example Request

curl "https://epiweek.com/api/v1/convert?date=2025-12-25&standard=ISO"

Example Response

{
  "week": 52,
  "year": 2025,
  "startDate": "2025-12-22T00:00:00.000Z",
  "endDate": "2025-12-28T00:00:00.000Z",
  "standard": "ISO"
}

GET /api/v1/calendar/[year]

Get all epidemiological weeks for a specific year.

Path Parameters

  • year (required) - Year between 1900-2100

Query Parameters

  • standard (optional) - MMWR or ISO. Default is MMWR

Example Request

curl https://epiweek.com/api/v1/calendar/2026

Example Response

{
  "year": 2026,
  "standard": "MMWR",
  "totalWeeks": 52,
  "weeks": [
    {
      "week": 1,
      "year": 2026,
      "startDate": "2026-01-04",
      "endDate": "2026-01-10",
      "standard": "MMWR"
    }
  ]
}

Calendar Subscription

Subscribe to epidemiological weeks in your calendar app.

Subscription URL

https://epiweek.com/calendar.ics

Add this URL to Google Calendar, Apple Calendar, or Outlook to automatically see epidemiological weeks.

Download .ics File

Rate Limiting

API requests are limited to 100 requests per minute per IP address. For higher limits, please contact us at [enable JavaScript].