HOLIDAYS 2025 API

     API Endpoint
 
        https://calendar-2025.org/
                 

The Calendar 2025 API provides you holidays of 2025 of the country you pass as parameter.

Using this API doesn't require any api key and it is free for all.

GET HOLIDAYS

 # Here is a curl example to get holidays of 2025 of United States
 curl \
 -X GET https://calendar-2025.org/holidays?country=us \
 -F 'Accept: *' \
                 

To get a country's holiday for 2025 in json, make a GET call to the following url and pass the country code:
https://calendar-2025.org/holidays?country=us

 Result example :
 
 {
    [{"date":"2025-01-01","localName":"New Year's Day","name":"New Year's Day","countryCode":"US","fixed":false,"global":true,"counties":null,"launchYear":null,"types":["Public"]},{"date":"2025-01-20","localName":"Martin Luther King, Jr. Day","name":"Martin Luther King, Jr...
 }
                 

QUERY PARAMETERS

Field	Type	Description
country	String	Country code ex. US or IN

Errors

The Calendar-2025.org API uses the following error codes:

Error Code	Meaning
500	Server related error. The error message will be shown to you.
400	Bad request. Check your request params.
402	Request exceeds daily limit. Payment required. An error message will be shown to you.
403	Forbidden. Maybe due to attempting a prohibited action.
404	Resource not found. An error message will be shown to you.
405	Method not allowed. Make sure to use correct GET or POST method.
204	No content. The country's calendar is not present in the database. An error message will be shown to you.
301	Moved permanently. The country's calendar is not present in the database. An error message will be shown to you.
304	Not modified. Calendar's data is not modified in the database. An error message will be shown to you.
307	Temporary redirect. An error message will be shown to you.
308	Permanent redirect. An error message will be shown to you.

API status

The Calendar-2025.org API status can be checked on API status page.