Pen and paper — the basis of good design

REST APIs and SDK

Integrate Calidario in your service

Integrate Calidario into your own services: with our Data API, Calendar API, and SDK for PHP, you can leverage our strengths in your applications.

The Calidario Data API

With the Calidario Data API you have access to all the information you need for your calendar. The data is continuously updated and guarantees you error-free calendars.

Reliably obtain calendar information

At Calidario, the API has been used for the calendar configurator and for individual calendars for years. However, it is also available to third parties and is ideal for online and offline applications.

The data is continually updated and checked. Calidario is aware of the high demands and his responsibility in the calendar industry. For this reason, all public holidays and holiday dates will be provided with a source and update date.

By combining a wide variety of information, updating and validating it, Calidario offers the largest and most reliable data set for calendars.

For technical information and technical support, please contact Bit&Black.

Address and endpoints

The REST-API can be called under api.calidar.io. A token is required for the query.

Request prices and token now

Calendar systems

The country-specific calendar type, the day on which a year begins and the year 0, from which all other years are counted, sorted by country.

Example response from api.calidario/v1/calendarsystems with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1,
            "language_code": "de",
            "type_of_calendar": "CAL_GREGORIAN",
            "first_day_of_year": "0101",
            "year_from_christ": 0
        }
    ]
}

Cities

All cities sorted by country, including postcode, state/region, and geographic coordinates.

Example response from api.calidario/v1/cities with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 93077,
            "country_code": "DE",
            "postal_code": "70372",
            "place_name": "Stuttgart Bad Cannstatt",
            "admin_name1": "Baden-Württemberg",
            "admin_code1": "BW",
            "admin_name2": "Reg.-Bez. Stuttgart",
            "admin_code2": "081",
            "admin_name3": "Stuttgart",
            "admin_code3": "08111",
            "latitude": "48.8056",
            "longitude": "9.2141",
            "accuracy": 0
        }
    ]
}

Countries

All countries in the world with their country code according to ISO 3166 Alpha-2 and ISO 3166 Alpha-3, the currency, the population, the continent, the capital, the language codes of the languages spoken there, the geographical coordinates and the area in square kilometers.

Example response from api.calidario/v1/countries with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 57,
            "country_code": "de",
            "country_name": "Germany",
            "currency_code": "EUR",
            "population": "81802257",
            "fips_code": "GM",
            "iso_numeric": "276",
            "north": "54.9113475100612",
            "south": "47.2701236047002",
            "east": "15.0418156516163",
            "west": "5.86625035072566",
            "capital": "Berlin",
            "continent_name": "Europe",
            "continent": "EU",
            "area_in_sq_km": "357021.0",
            "languages": "de",
            "iso_alpha3": "DEU",
            "geoname_id": 2921044
        }
    ]
}

Country names

All countries in the world translated into other languages.

Example response from api.calidario/v1/countrynames with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 28,
            "en_gb": "Germany",
            "de_de": "Deutschland",
            "de_at": "Deutschland",
            "de_ch": "Deutschland",
            "en_us": "Germany"
        }
    ]
}

Days

The day names in almost all languages on earth.

Example response from api.calidario/v1/days with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 57,
            "language_code": "de-de",
            "day1": "Sonntag",
            "day2": "Montag",
            "day3": "Dienstag",
            "day4": "Mittwoch",
            "day5": "Donnerstag",
            "day6": "Freitag",
            "day7": "Samstag"
        }
    ]
}

Holidays

The holidays of all European countries. It contains the name, the date and the respective federal states/regions in which the holiday is celebrated.

Example response from api.calidario/v1/holidays with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 15,
            "date_code": "",
            "description": "Pfingstsonntag",
            "names": [],
            "country_code": "de",
            "state": [
                "Brandenburg"
            ],
            "day_formula": [
                "+49 days"
            ],
            "day_origin": "easter",
            "year": null,
            "calendar_type": "gregorian",
            "source_of_information": "https://de.wikipedia.org/wiki/Pfingsten",
            "date_information_updated": "2026-03-20T10:45:37+01:00",
            "translation_en": "Pentecost Sunday",
            "identifiers": [
                "PENTECOST_DATE"
            ]
        }
    ]
}

Languages

All languages on earth. The list contains the country code according to ISO 639-1, the language code according to LCID, the description and the country-specific calendar type.

Example response from api.calidario/v1/languages with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 39,
            "language_code": "de-de",
            "language_description": "Deutsch (Deutschland)",
            "country_code": "DE",
            "type_of_calendar": "CAL_GREGORIAN"
        }
    ]
}

Months

The month names in almost every language on earth.

Example response from api.calidario/v1/months with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 32,
            "language_code": "de-de",
            "month1": "Januar",
            "month2": "Februar",
            "month3": "März",
            "month4": "April",
            "month5": "Mai",
            "month6": "Juni",
            "month7": "Juli",
            "month8": "August",
            "month9": "September",
            "month10": "Oktober",
            "month11": "November",
            "month12": "Dezember"
        }
    ]
}

Moon phases

The phases of the moon in different languages.

Example response from api.calidario/v1/moonphases with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1,
            "language_code": "de-de",
            "new_moon": "Neumond",
            "waxing_crescent": "Erstes Viertel",
            "first_quarter": "Zunehmender Halbmond",
            "waxing_gibbous": "Zweites Viertel",
            "full_moon": "Vollmond",
            "waning_gibbous": "Drittes Viertel",
            "third_quarter": "Abnehmender Halbmond",
            "waning_crescent": "Letztes Viertel"
        }
    ]
}

Name days

The name days of all European countries.

Example response from api.calidario/v1/namedays with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 3,
            "country_code": "de",
            "name": "Abraham",
            "date": [
                "0910",
                "2910"
            ],
            "sex": "male"
        }
    ]
}

Zodiac signs

The names of the signs of the zodiac in different languages.

Example response from api.calidario/v1/starsigns with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1,
            "language_code": "de-de",
            "starsign1": "Steinbock",
            "starsign2": "Wassermann",
            "starsign3": "Fische",
            "starsign4": "Widder",
            "starsign5": "Stier",
            "starsign6": "Zwilling",
            "starsign7": "Krebs",
            "starsign8": "Löwe",
            "starsign9": "Jungfrau",
            "starsign10": "Waage",
            "starsign11": "Skorpion",
            "starsign12": "Schütze"
        }
    ]
}

Federal states/regions

The federal states/regions of different countries.

Example response from api.calidario/v1/states with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 143,
            "country_code": "de",
            "state_name": "Baden-Württemberg"
        }
    ]
}

School holidays

The school holidays of different countries including the name, beginning and end as well as the indication of the respective federal state or the respective region.

Example response from api.calidario/v1/vacations with a single entry: 
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1016,
            "vacation_name": "Weihnachtsferien",
            "first_day_date_code": "2027-12-23",
            "last_day_date_code": "2028-01-08",
            "country_code": "de",
            "state_name": "Baden-Württemberg",
            "source_of_information": "https://km.baden-wuerttemberg.de/de/service/ferien",
            "date_information_updated": "2026-02-23T08:00:00+01:00"
        }
    ]
}

The Calidario Calendar API

Calidario's calendar API allows the generation of all kinds of calendars.

Automatically generate complete calendars

Our calendar interface enables the fully automated generation of calendar (layouts). All relevant data formats are supported, including:

  • Web and print PDF,
  • IDML for Adobe InDesign, QuarkXPress and Affinity,
  • HTML and CSS,
  • JPEG, PNG etc.

The open data allows post-processing of all information and design elements.

Individual calendars with your own corporate design, your own logo, your own images, etc. are possible.

Access is via REST API.

Address and endpoints

The REST API can be accessed at calendar-api.calidar.io. A token is required to make a request.

Request prices and token now

The Calidario SDK for PHP

The Calidario SDK is a useful addition for handling the calendar information from the Calidario API. With the help of the library, this information could be formatted and processed more easily.

Functions

The Calidario SDK offers these functionalities:

  • Dates can be converted to other calendar systems. That means: dates from the Gregorian, the Julian and the Islamic calendar (Hijri) can each be converted.
  • Day names can be requested for a specific language.
  • The number of a day in a week can be calculated.
  • The Easter date for the Western and Eastern Churches can be calculated for a specific year.
  • The beginning of spring and the beginning of autumn can be calculated for a specific year.
  • It can be checked whether a certain day includes a public holiday. The distinction between national holidays and partial holidays is possible.
  • Month names can be queried for a specific language.
  • The first and last day and the total number of days in a given month can be calculated.
  • Name days can be queried by day or by name.
  • Signs of the zodiac can be queried.
  • Moon phases can be queried and output in different languages.
  • Federal states/regions can be queried for a specific country.
  • The sunrise and sunset can be calculated for a specific geographical position.
  • The school holidays of a certain country can be queried.
  • The week number on a specific date can be calculated.

Installation and technical requirements

The Calidario SDK is available as a PHP library and can be integrated via Composer. It is a private library that requires a token. The library requires PHP >=7.4 as well as the calendar extension (ext-calendar), the JSON extension (ext-json) and the multibyte string extension (ext-mbstring).

Request prices and token now

Ask

Are you interested in the Calidario API or the Calidario SDK? Write us!