Czech Namedays Calendar API

⭐ Beginner's Pick Calendar / No Auth Required Beginner HTTP
Free to Use Varies (check documentation)

Overview

The Czech Namedays Calendar API lets you look up the Czech or Slovak nameday (svátek) associated with a given first name, or find whose nameday falls on a specific date. It is completely free with no authentication required and supports JSON responses. Responses are instant and lightweight, making it great for beginners.

💡

Beginner Tip

No API key needed — call the endpoint directly. To get today's nameday, try https://api.abalin.net/today?country=cz. Supported country values are "cz" and "sk".

Available Data

event dates and names
holiday lists by country
date metadata

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Czech Namedays Calendar",
    "description": "Lookup for a name and returns nameday date",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

data.day Day of the month for the nameday result.
data.month Month number for the nameday result.
data.name_cz The Czech name celebrated on this day.
data.name_sk The Slovak name celebrated on this day, which may differ from the Czech name.

Implementation Example

const url = "https://svatky.adresa.info/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Null or missing name in response Queried a date that has no assigned nameday in that country
Not every date has a nameday; always check the field for null before using it in your UI.
400 Bad Request on name lookup Name contains Czech special characters that were not URL-encoded
URL-encode Czech characters before passing the name as a query parameter, e.g., "Tom%C3%A1%C5%A1" for "Tomáš".
Unsupported country error Passing a country code other than cz or sk
The API only supports "cz" (Czech) and "sk" (Slovak); any other value returns an error.

Matrix Score Breakdown

🌐 Reachability 0/30
⚡ Speed 20/20
🔒 Security 5/15
🛠 Developer XP 15/20
✓ Reliability 15/15
Response Time 43ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS NO
CORS UNKNOWN
Category Calendar
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →