World Holidays lists public holidays and observances for any two-letter country code. It returns holiday dates, official names, and event types across the year.
The World Holidays API provides a simple, reliable way to integrate world holidays functionality into your applications. Built for developers who need production-ready world holidays capabilities without the complexity of building from scratch.
Available on:
async function callWorldHolidaysAPI() {
try {
const params = new URLSearchParams({
country: 'US'
});
const response = await fetch(`https://api.apiverve.com/v1/worldholidays?${params}`, {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
});
const data = await response.json();
console.log(data);
} catch (error) {
console.error('Error:', error);
}
}
callWorldHolidaysAPI();curl -X GET "https://api.apiverve.com/v1/worldholidays?country=US" \
-H "x-api-key: YOUR_API_KEY_HERE"Get your API key: https://apiverve.com
📁 For more examples, see the examples folder
Choose your preferred programming language:
npm install @apiverve/worldholidaysView NPM Package → | Package Code →
dotnet add package APIVerve.API.WorldHolidaysView NuGet Package → | Package Code →
pip install apiverve-worldholidaysView PyPI Package → | Package Code →
gem install apiverve_worldholidaysView RubyGems Package → | Package Code →
composer require apiverve/worldholidaysView Packagist Package → | Package Code →
dart pub add apiverve_worldholidaysView pub.dev Package → | Package Code →
implementation 'com.github.apiverve:worldholidays-api:1.0.0'go get github.com/apiverve/worldholidays-api/go| Feature | Benefit |
|---|---|
| Multi-language SDKs | Native packages for JavaScript, Python, C#, Go, and Android |
| Simple Integration | Single API key authentication, consistent response format |
| Production Ready | 99.9% uptime SLA, served from 24 global regions |
| Comprehensive Docs | Full examples, OpenAPI spec, and dedicated support |
- 🏠 API Home: World Holidays API
- 📚 API Reference: docs.apiverve.com/ref/worldholidays
- 📖 OpenAPI Spec: openapi.yaml
- 💡 Examples: examples/
The World Holidays API is commonly used for:
- Web Applications - Add world holidays features to your frontend or backend
- Mobile Apps - Native SDKs for Android development
- Automation - Integrate with n8n, Zapier, or custom workflows
- SaaS Products - Enhance your product with world holidays capabilities
- Data Pipelines - Process and analyze data at scale
All requests require an API key in the header:
x-api-key: YOUR_API_KEY_HERE
Get your API key: https://apiverve.com
Every APIVerve endpoint returns the same envelope — check status, then read data:
{
"status": "ok",
"error": null,
"data": { ... }
}A real response from the World Holidays API:
{
"status": "ok",
"error": null,
"data": {
"country": "US",
"year": "2025",
"holidays": [
{
"date": "2025-01-01 00:00:00",
"start": "2025-01-01T05:00:00Z",
"end": "2025-01-02T05:00:00Z",
"name": "New Year's Day",
"type": "public"
},
{
"date": "2025-01-20 00:00:00",
"start": "2025-01-20T05:00:00Z",
"end": "2025-01-21T05:00:00Z",
"name": "Martin Luther King Jr. Day",
"type": "public"
},
{
"date": "2025-02-14 00:00:00",
"start": "2025-02-14T05:00:00Z",
"end": "2025-02-15T05:00:00Z",
"name": "Valentine's Day",
"type": "observance"
},
{
"date": "2025-02-17 00:00:00",
"start": "2025-02-17T05:00:00Z",
"end": "2025-02-18T05:00:00Z",
"name": "Washington's Birthday",
"type": "public"
},
{
"date": "2025-03-17 00:00:00",
"start": "2025-03-17T04:00:00Z",
"end": "2025-03-18T04:00:00Z",
"name": "St. Patrick's Day",
"type": "observance"
},
{
"date": "2025-04-15 00:00:00",
"start": "2025-04-15T04:00:00Z",
"end": "2025-04-16T04:00:00Z",
"name": "Tax Day",
"type": "observance"
},
{
"date": "2025-04-20 00:00:00",
"start": "2025-04-20T04:00:00Z",
"end": "2025-04-21T04:00:00Z",
"name": "Easter Sunday",
"type": "observance"
},
{
"date": "2025-04-23 00:00:00",
"start": "2025-04-23T04:00:00Z",
"end": "2025-04-24T04:00:00Z",
"name": "Administrative Professionals Day",
"type": "observance"
},
{
"date": "2025-05-11 00:00:00",
"start": "2025-05-11T04:00:00Z",
"end": "2025-05-12T04:00:00Z",
"name": "Mother's Day",
"type": "observance"
},
{
"date": "2025-05-26 00:00:00",
"start": "2025-05-26T04:00:00Z",
"end": "2025-05-27T04:00:00Z",
"name": "Memorial Day",
"type": "public"
},
{
"date": "2025-06-15 00:00:00",
"start": "2025-06-15T04:00:00Z",
"end": "2025-06-16T04:00:00Z",
"name": "Father's Day",
"type": "observance"
},
{
"date": "2025-06-19 00:00:00",
"start": "2025-06-19T04:00:00Z",
"end": "2025-06-20T04:00:00Z",
"name": "Juneteenth",
"type": "public"
},
{
"date": "2025-07-04 00:00:00",
"start": "2025-07-04T04:00:00Z",
"end": "2025-07-05T04:00:00Z",
"name": "Independence Day",
"type": "public"
},
{
"date": "2025-09-01 00:00:00",
"start": "2025-09-01T04:00:00Z",
"end": "2025-09-02T04:00:00Z",
"name": "Labor Day",
"type": "public"
},
{
"date": "2025-10-13 00:00:00",
"start": "2025-10-13T04:00:00Z",
"end": "2025-10-14T04:00:00Z",
"name": "Columbus Day",
"type": "public"
},
{
"date": "2025-10-31 18:00:00",
"start": "2025-10-31T22:00:00Z",
"end": "2025-11-01T04:00:00Z",
"name": "Halloween",
"type": "observance"
},
{
"date": "2025-11-11 00:00:00",
"start": "2025-11-11T05:00:00Z",
"end": "2025-11-12T05:00:00Z",
"name": "Veterans Day",
"type": "public"
},
{
"date": "2025-11-27 00:00:00",
"start": "2025-11-27T05:00:00Z",
"end": "2025-11-28T05:00:00Z",
"name": "Thanksgiving Day",
"type": "public"
},
{
"date": "2025-11-28 00:00:00",
"start": "2025-11-28T05:00:00Z",
"end": "2025-11-29T05:00:00Z",
"name": "Day after Thanksgiving Day",
"type": "observance"
},
{
"date": "2025-12-24 00:00:00",
"start": "2025-12-24T05:00:00Z",
"end": "2025-12-25T05:00:00Z",
"name": "Christmas Eve",
"type": "optional"
},
{
"date": "2025-12-25 00:00:00",
"start": "2025-12-25T05:00:00Z",
"end": "2025-12-26T05:00:00Z",
"name": "Christmas Day",
"type": "public"
},
{
"date": "2025-12-31 00:00:00",
"start": "2025-12-31T05:00:00Z",
"end": "2026-01-01T05:00:00Z",
"name": "New Year's Eve",
"type": "observance"
}
]
}
}- 🏠 API Home: World Holidays API
- 💬 Support: https://apiverve.com/contact
- 🐛 Issues: GitHub Issues
- 📖 Documentation: https://docs.apiverve.com
- 🌐 Website: https://apiverve.com
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
For security concerns, please review our Security Policy.
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ by APIVerve
Copyright © 2026 APIVerve. All rights reserved.