Name Day and Calendar API
Our API provides programmatic access to name day and calendar data. With the API, companies and organisations can use up-to-date and reliable almanac information as part of their own digital services, websites and mobile solutions.
In addition to name days, the API provides access to essential calendar data. The data can be retrieved using versatile search criteria, such as by name, date or calendar type. The API is suitable both for retrieving individual data points and for more extensive integration of calendar information into digital services.
The use of name day data in digital services and mobile applications is subject to copyright. When name days are retrieved via the API and used as part of applications or other digital services, the use complies with applicable copyright terms. The use of name day and calendar data is included in the annual API fee, and no additional charges apply for applications, websites or other digital use.
The API is intended especially for companies and organisations that wish to integrate name day and calendar data into their own systems or services. Use of the API requires an access key, and pricing is based on the number of users of the service.
You can obtain an access key by contacting our customer service.
Try it for free!
-
Free tier:
Free of charge for small projects and organisations. Maximum 100 API requests per hour. Attribution required: Calendar and name day data provided by the University of Helsinki Almanac Office. - Paid tiers:
Higher request limits and priority support. No attribution requirement.
| Users | € / year |
| 0–99 |
0 |
| 100–999 |
500 |
| 1000–9 999 | 2 000 |
| 10 000–99 999 | 6 000 |
|
100 000–999 999 |
8 000 |
Data available via the API
Name day data
- Finnish name days
- Finland-Swedish name days
- Orthodox name days
- Sámi name days
- Name days for cats, dogs and horses
- Historical name days
Calendar data
- Day number
- Day of the week
- Month and year
- Week number
- Public holidays
- Flag days
- Commemorative days
Technical features of the API
- User count = monthly active users
- REST-based API
- Data returned in JSON format
- JWT authentication
- Support for pagination of search results
OpenAPI description of the Name Day API
The OpenAPI specification, formerly known as the Swagger Specification, is a standard for machine-readable API definitions. It is used to describe, produce, consume and visualise REST-based web services.