M
API Matrix

Namedays Calendar API

⭐ Beginner's Pick Calendar / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)
77 Score
Grade B
Visit Official Site Compare Alternatives

Overview

Namedays Calendar provides name day traditions for dozens of countries, letting you look up which names are celebrated on any given date. It is a no-auth, open REST API that returns JSON, making it ideal for greeting-card apps, HR tools, or calendar widgets. Coverage spans Europe and beyond, with per-country endpoints so you fetch only the data you need.

💡

Beginner Tip

Start with the today endpoint (e.g., GET /api/V1/today?country=us) — it requires zero parameters beyond the country code and returns a name list instantly. Country codes follow the two-letter ISO 3166-1 alpha-2 standard such as de for Germany or pl for Poland.

Available Data

country name and code
population
capital city
region and subregion
flag image URL
event dates and names

Example Response

JSON Response 
{
  "name": "Japan",
  "capital": "Tokyo",
  "population": 125800000,
  "region": "Asia",
  "languages": [
    "Japanese"
  ],
  "flag": "https://flagcdn.com/jp.svg",
  "currencies": [
    {
      "code": "JPY",
      "name": "Japanese yen"
    }
  ]
}

Field Reference

data.name The name celebrated on this day in the specified country
data.country ISO 3166-1 alpha-2 country code reflecting the query parameter
data.day Day of the month (1-31) for the queried nameday
data.month Month number (1-12) for the queried nameday

Implementation Example 

const url = "https://nameday.abalin.net/";
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

404 Not Found for country code Using an unsupported or mis-typed country code such as USA instead of us
✓ Use lowercase two-letter ISO codes like us, de, pl. Check the /countries endpoint for the full supported list.
Empty names array in response Querying a date that has no nameday tradition in the selected country
✓ This is valid data — not every date has a nameday. Handle the empty array gracefully in your code.
CORS error in browser Some browsers block cross-origin requests even when the server allows CORS for simple GET requests
✓ Ensure you are using a plain GET request without custom headers; the API supports CORS for standard requests.

Matrix Score Breakdown

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

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Calendar
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →

Church Calendar

⭐ Beginner's Pick
37

Church Calendar (calapi.inadiutorium.cz) is a free, no-auth REST API that returns the Roman Catholic liturgical calendar for any date or month.

No Auth Beginner 291ms

Czech Namedays Calendar

⭐ Beginner's Pick
55

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.

No Auth Beginner 43ms

Hebrew Calendar

⭐ Beginner's Pick
72

The Hebcal API provides free Jewish calendar data including Hebrew date conversions, Shabbat candle-lighting times, Jewish holidays, and weekly Torah portion readings.

No Auth Beginner 346ms

LectServe

⭐ Beginner's Pick
77

LectServe is a free REST API that returns Revised Common Lectionary readings — Scripture passages assigned to each Sunday and feast day used by many Protestant denominations.

No Auth Beginner 245ms

Nager.Date

⭐ Beginner's Pick
84

Nager.Date is a completely free, open-source REST API providing public holidays for over 90 countries with no API key required.

No Auth Beginner HTTPS 42ms