Question 1

What does Public Holiday API do?

Accepted Answer

Public Holiday API by Calendarific is a comprehensive global holiday data service covering 230+ countries and 3,000+ states and provinces, providing developers with programmatic access to national public holidays, state-level holidays, observances, and religious celebrations for any location and year. Widely regarded as one of the most complete and developer-friendly holiday APIs available, Calendarific is used by thousands of applications including payroll systems, scheduling tools, HR software, e-commerce platforms, and calendar applications that need accurate holiday data for their global or multi-country user bases. For Nigerian developers, Calendarific offers authoritative data on all 12 Nigerian national public holidays with correct year-specific dates for moveable holidays.

Nigeria holiday data from Calendarific covers all statutory public holidays established under Nigerian federal law: New Year's Day, Workers Day, Democracy Day, Independence Day, Christmas Day, Boxing Day, and the six moveable religious holidays (Good Friday, Easter Monday, Eid al-Fitr, second Eid al-Fitr day, Eid al-Adha, and Id el Maulud). Each holiday entry includes the name, date, type (national, observance, or religious), and description. The API computes the correct dates for moveable holidays based on Calendarific's calendar calculation system, which accounts for the annual variation in Easter and Islamic calendar dates.

State-level holiday coverage is available for countries where sub-national holidays differ from national ones. In Nigeria's context, the 36 states and FCT have limited state-specific public holidays, but some Nigerian states occasionally declare additional local public holidays. For applications requiring awareness of both federal and state-level Nigerian holidays, Calendarific's state-level data provides additional granularity beyond the 12 national holidays.

Multi-country support makes Calendarific particularly valuable for Nigerian businesses operating in multiple countries. A Nigerian company with offices in the UK, US, and Ghana alongside its Nigerian headquarters can query Calendarific for all four countries' holiday calendars simultaneously — ensuring meeting scheduling tools, project planning software, and payroll systems are configured with the correct holidays for each location without maintaining four separate country-specific data sources.

Historical and future holiday data through Calendarific extends from recent decades into future years, enabling both retrospective analysis and forward planning. Nigerian payroll systems can generate a full year's holiday calendar in January by querying Calendarific for all Nigerian holidays in the upcoming year. Financial technology platforms can retroactively verify correct business day calculations for past periods by checking historical holiday dates.

The API returns holiday data in JSON format with clean, parseable structure: holiday name, description, date (ISO 8601), type array, and country data. Integration into Nigerian applications follows standard REST API patterns with API key authentication in the request URL or header. Rate limits are enforced per API key based on the subscription plan.

Calendarific pricing includes a free tier of up to 1,000 API calls per month — sufficient for small Nigerian applications and development/testing. Paid plans start affordably and scale by call volume, making Calendarific economically accessible for Nigerian startups through enterprise users who need higher call volumes or priority support. Calendarific's free tier of 1,000 calls/month is enough for most Nigerian apps that only need to query holidays at app startup or once daily to cache the full year's holiday list locally, keeping API costs minimal.

Question 2

How much does Public Holiday API cost?

Accepted Answer

Public Holiday API is free to start, with paid tiers for higher usage (freemium). Free tier: 1,000 requests/month, Paid available

Question 3

How do I authenticate with the Public Holiday API API?

Accepted Answer

API Key

Question 4

Is there a rate limit on Public Holiday API?

Accepted Answer

1,000/month (free)

Question 5

Does Public Holiday API offer a sandbox or test mode?

Accepted Answer

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

Question 6

What is Public Holiday API best suited for?

Accepted Answer

Holiday calendars, scheduling, event planning, public holidays

Question 7

Is there anything else I should know before integrating Public Holiday API?

Accepted Answer

Calendarific covers Nigeria's public holidays including both statutory national holidays and Nigerian observances of Eid and Easter that shift annually

Question 8

Where can I find Public Holiday API's documentation?

Accepted Answer

The official API documentation is at https://calendarific.com/api-documentation. The provider's website is https://calendarific.com.

Question 9

Does Public Holiday API support Nigerian developers?

Accepted Answer

Yes — Public Holiday API explicitly supports Nigerian developers/use cases.

Public Holiday API

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