published

Nager.Date API

The Nager.Date API offers developers free access to public holiday data and calendar information across more than 100 countries, enabling efficient application development for scheduling and reminders.

Developed by Nager

Live API
99.90%Uptime
150msLatency
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
  • Creating applications that need to manage scheduling based on public holidays.Optimized Capability
  • Developing reminder applications that alert users of upcoming holidays.Optimized Capability
  • Integrating holiday data into internationalized workflows for global teams.Optimized Capability
  • Avoiding scheduling events on public holidays in calendar applications.Optimized Capability
  • Building custom reports or analytics involving holiday trends.Optimized Capability
Advantages
  • ✓ No authentication or API keys required, simplifying integration.
  • ✓ Free unlimited access with no documented rate limits.
  • ✓ Supports over 100 countries with detailed holiday metadata.
  • ✓ CORS enabled for easy use in web applications.
  • ✓ Multiple deployment options including Docker and NuGet.
Limitations
  • ✗ Limited to public holiday and calendar-related data only.
  • ✗ No official SDKs available, requiring manual integration.
  • ✗ API responses limited to JSON format without XML support.
  • ✗ Occasional updates or latency may occur during high traffic.
  • ✗ No premium support or SLA guarantees.

FAQs

API Specifications

v3
Pricing Model
Free
Credit Card
Not Required
Response Formats
JSON
Supported Languages
7 Languages
SDK Support
REST Only
Time to Hello World

Less than 5 minutes

Rate Limit

Unlimited

Free Tier Usage

100% free access with unlimited requests and no restrictions.

Use Case: Best For

Developers building applications that need accurate public holiday data without complex authentication or cost.

Not Recommended For

Applications requiring premium support, guaranteed SLAs, or specialized non-holiday data.

Resources

Documentation Official Website Pricing Details Postman Collection
#holidays#calendar

Explore Related APIs

Discover similar APIs to Nager.Date API

View All APIs
PUBLIC

Cal.com Scheduling API

Cal.com provides developers with an open-source REST API to manage schedules, bookings, and event types easily, suitable for cloud and self-hosted applications.

ProductivityView Details