Question 1

What does Timeanddate Public Holidays do?

Accepted Answer

Timeanddate Public Holidays API provides access to the comprehensive public holiday and observance database maintained by timeanddate.com — one of the world's most trusted sources for time zone, calendar, and astronomical data, operating since 1995. The Timeanddate holidays dataset covers over 230 countries and territories with exceptional accuracy, including Nigeria's national public holidays with correct dates for moveable feasts like Easter and Islamic holidays calculated for each year. For Nigerian businesses and developers who need authoritative, accurate holiday data backed by decades of calendar expertise, Timeanddate is one of the most reliable sources available.

The Timeanddate holiday API returns structured data for each public holiday: the holiday name, date, type (national, observance, religious), and description. For Nigerian holidays, this includes the statutory national holidays plus major religious observances: New Year's Day, Workers Day (May 1), Democracy Day (June 12), Independence Day (October 1), Christmas Day, Boxing Day, Good Friday, Easter Monday, Eid al-Fitr, Eid al-Adha, and Mawlid al-Nabi. The religious holidays are returned with the year-specific dates computed by Timeanddate's calendar calculation system, which has a long track record of accuracy.

Business day calculation using Timeanddate holiday data is a critical function for Nigerian financial services and legal technology. Loan processing timelines specified in "business days," contract cooling-off periods, regulatory filing deadlines, and legal notice periods all require accurate knowledge of which days are public holidays in Nigeria. A fintech platform promising a 3-business-day loan disbursement needs to correctly skip public holidays in that calculation — using Timeanddate's authoritative holiday data ensures the calculation is defensible and accurate.

International scheduling across time zones and holiday calendars is a strength of Timeanddate's integrated platform. The Timeanddate API includes both time zone and holiday data, enabling Nigerian companies coordinating with international counterparts to check simultaneously whether a proposed meeting date conflicts with any party's public holiday, and to convert the proposed time to each party's local time zone. For Nigerian professional services firms, consulting companies, and tech companies with international clients, this integrated time zone and holiday functionality simplifies scheduling workflows.

Sun and moon calculations from Timeanddate (available in related API products) include sunrise, sunset, moonrise, moonset, and moon phase data — useful for Nigerian agricultural apps planning outdoor activities around daylight hours, Nigerian security platforms scheduling outdoor operations, and Nigerian event planners arranging outdoor events around natural light.

The Timeanddate API is commercially licensed through a subscription model, with pricing that reflects the premium quality and reliability of the underlying data. For Nigerian businesses building compliance-sensitive applications where incorrect holiday dates could cause regulatory violations, missed deadlines, or customer complaints, the Timeanddate commercial license with its data accuracy guarantee is worth the investment.

API access uses standard REST calls with API key authentication, returning JSON responses. The Timeanddate developer documentation is comprehensive, covering all endpoint parameters, response formats, and country codes. Nigerian developers integrating Timeanddate holiday data can expect well-maintained documentation and a stable API suitable for production use in business-critical scheduling applications.

Question 2

How much does Timeanddate Public Holidays cost?

Accepted Answer

Timeanddate Public Holidays is free to start, with paid tiers for higher usage (freemium). Free browser access, API available with subscription

Question 3

How do I authenticate with the Timeanddate Public Holidays API?

Accepted Answer

API Key

Question 4

Is there a rate limit on Timeanddate Public Holidays?

Accepted Answer

Varies by subscription

Question 5

Does Timeanddate Public Holidays offer a sandbox or test mode?

Accepted Answer

Yes — Timeanddate Public Holidays provides a sandbox or test environment so you can integrate and test before going live.

Question 6

What is Timeanddate Public Holidays best suited for?

Accepted Answer

Holiday calendars, scheduling, professional planning

Question 7

Is there anything else I should know before integrating Timeanddate Public Holidays?

Accepted Answer

Timeanddate is authoritative for time zones, sun/moon calculations, and holiday data. Well-established with comprehensive Nigerian data and excellent documentation

Question 8

Where can I find Timeanddate Public Holidays's documentation?

Accepted Answer

The official API documentation is at https://www.timeanddate.com/holidays/. The provider's website is https://www.timeanddate.com.

Question 9

Does Timeanddate Public Holidays support Nigerian developers?

Accepted Answer

Yes — Timeanddate Public Holidays explicitly supports Nigerian developers/use cases.

Timeanddate Public Holidays

Features Included

Key Highlights

Required Access Documents

Use Cases

Ask question or give feedback

Sign in to participate

Discover similar API's

Ask question or give feedback

Sign in to participate