Namedays Calendar API

Beginner's Pick Calendar / No Auth Required Beginner HTTPS CORS

Free to Use

77 B

Metadata Score Metadata estimate · not endpoint-tested

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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

country name and code

population

capital city

region and subregion

flag image URL

event dates and names

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://nameday.abalin.net/api/V1/today?country=us";
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

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

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.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →