Get calendar

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

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

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

GET CALENDAR

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

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

 Result example :
 
 {
    January: [1, 2, 3, 4, 5, 6...],
    February: [1, 2, 3, 4, 5, 6...],
    ...
    holidays: [{"name": "Christmas", "date": "25 December"}]
 }
                 

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.
402	Request exceeds daily limit. An error message will be shown to you.

API status

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