/calendar namespace · APlicious

Public Holidays API — country holiday calendars, working-day counting

The /calendar namespace covers public holidays by country and year, working-day counting that correctly excludes those holidays, date-difference math, and moon-phase calculation.

7calendar endpoints

Get free API key View docs

GET /api/v1/calendar/holidays

const res = await fetch(
  'https://aplicious.com/api/v1/calendar/holidays?country=US&year=2026',
  { headers: { 'X-API-Key': 'lapi_live_••••' } }
);
const { data } = await res.json();
// { holidays: [{ date: "2026-01-01", name: "New Year's Day" }, ...] }

No credit card · Free tier forever · X-API-Key header auth

What's included in /calendar

Public holidays by country

Returns the holiday calendar for any supported country and year — the data source working-day calculations are built on.

Working-day calculator

Counts business days between two dates, correctly excluding weekends and public holidays for the specified country.

Date difference and countdown

Calculate the exact difference between two dates, or a countdown to a future date.

Week number and age

ISO week number for any date, and age calculation from a birth date.

Moon calendar

Moon phase calculation for any date — useful for agricultural, cultural, or novelty calendar apps.

Start using the public holidays API today

Free tier — 500 calls/month, no credit card. Upgrade when you need more.

Get free API key Explore /calendar docs

Frequently asked questions

Does the working-days calculator account for holidays?

Yes — it excludes both weekends and the public holidays returned by /holidays for the specified country.

Can I calculate age from a birth date?

Yes — /age takes a birth date and returns the current age, with exact year/month/day breakdown.

Is there a free tier?

Yes — 500 calls/month forever, no credit card required.

Related API guides

One key unlocks all 34 namespaces — weather, finance, fitness, astrology, and more.

View all plans and pricing →