whatweek.ca
See what week of the year it is right now in Canada, including the current week number and the dates this week starts and ends.
API keys & rate limits
Our public API is free and key-less for light use. For higher volume, request a free partner key — non-commercial uses included.
Default limits
| Access tier | Per-minute limit | Mode |
|---|---|---|
| Anonymous (per IP) | 60 | No key required |
| Partner key | 600+ | X-API-Key or ?api_key= |
Headers X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset are returned on every response. When exceeded, the API returns 429 with a Retry-After header.
How to authenticate
Once you receive your key, send it as the X-API-Key header, an Authorization: Bearer <key> header, or an api_key= query parameter.
# Header (recommended)
curl -H "X-API-Key: $WHATWEEK_KEY" \
"https://whatweek.ca/api/holidays.json?province=on&year=2026"
# Query parameter
curl "https://whatweek.ca/api/week.json?api_key=$WHATWEEK_KEY"Request a key
Email us your name, project, and estimated volume. We typically reply within 48 hours.
Best practices
- Cache responses on your side — holidays rarely change.
- Respect the Retry-After header when you receive a 429.
- Don't expose your key in client-side code or public repos.
- Identify yourself with a descriptive User-Agent.