published

Nager.Date API

Nager.Date API provides developers with free access to accurate public holiday data and calendar information, suitable for scheduling and reminder applications.

Developed by Nager.Date

View Source
99.90%Uptime
200msLatency
1.3kStars
No AuthAuth
NoCredit Card
RESTStyle
v3Version
API Endpoints

Reference for available routes, request structures, and live examples.

Lists public holidays for a country/year

Full Endpoint URL
https://date.nager.at/PublicHolidays/{year}/{countryCode}
Implementation Example
curl -X GET 'https://date.nager.at/PublicHolidays/{year}/{countryCode}'
Request Payload
{
  "year": 2023,
  "countryCode": "US"
}
Expected Response
[
  {
    "date": "2023-01-01",
    "name": "New Year's Day",
    "localName": "New Year's Day"
  }
]
Version:v3
Real-World Applications
  • Avoid scheduling events on bank holidays across countriesOptimized Capability
  • International e‑commerce shipping cutoff planningOptimized Capability
  • HR leave planner respecting local holidaysOptimized Capability
  • Travel app notifying users of destination holidaysOptimized Capability
  • Automated calendar content scheduling aware of holidaysOptimized Capability
Advantages
  • ✓ Free and open‑source with no signup required
  • ✓ Supports 100+ countries with subdivision‑level detail
  • ✓ CORS enabled and easy to integrate
  • ✓ Offline options via Docker and NuGet
Limitations
  • ✗ No authentication or usage tracking, might result in unexpected usage
  • ✗ No support for city‑level or ultra‑granular holidays
  • ✗ Islamic lunar holidays may be missing or inaccurate
  • ✗ No XML or other response formats beyond JSON

FAQs

API Specifications

v3
Pricing Model
Free / open‑source; optional sponsorship for offline license key
Credit Card
Not Required
Response Formats
JSON
Supported Languages
5 Languages
SDK Support
C# (.NET NuGet), Docker container
Time to Hello World

Less than 5 minutes for basic REST integration

Rate Limit

Unlimited (no enforced limit)

Free Tier Usage

Unlimited free access to REST API with no signup or API key required

Use Case: Best For

Global holiday‑aware apps, scheduling tools, calendar integrations, logistics planning

Not Recommended For

City‑level holiday queries, workflows needing strict API usage monitoring

Resources

Documentation Official Website Source Code
#holidays#calendar

Explore Related APIs

Discover similar APIs to Nager.Date API

View All APIs
FREEMIUM

Cal.com Scheduling API

Cal.com offers developers an open-source REST API for managing schedules, bookings, and event types, with support for both cloud and self-hosted environments.

ProductivityView Details