Timeanddate Public Holidays
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.