Nameday Abalin Nameday API
71
AI ReadinessAI-Aware (A-)71/100
Agent-ready OpenAPI document · curated by JenticData EnrichmentData Transformationnone3 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Look up name days for a person's name or fetch today's namedays across European country calendars. Read-only, no auth.
Use for: Find today's namedays in Czech Republic and Slovakia, Retrieve the nameday calendar entry for March 19 in Hungary, Search for the date when 'Eva' is celebrated in Poland, I need to send a name day greeting to a colleague in Germany
Not supported: Does not handle public holidays, birthdays, or generic calendar events - use for nameday calendar lookups only.
Jentic publishes the only available OpenAPI specification for Nameday API, keeping it validated and agent-ready. The Nameday API is a free service from Abalin that returns name day data for a wide range of countries including Czech Republic, Slovakia, Hungary, Poland, Germany, Spain, France, Italy, Croatia, Sweden, Austria, and the United States. Three lightweight endpoints let agents fetch today's namedays per country, retrieve namedays for a specific date, or search for the date associated with a given name.
Install Jentic One Beta
Connect the Nameday API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nameday API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnameday.abalin.net%2Fnameday-abalin" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnameday.abalin.net%2Fnameday-abalin" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Nameday API.
Retrieve today's namedays for one or many countries in a single request
Fetch all namedays falling on a specific calendar date across supported countries
Search the date associated with a given first name in a country's nameday calendar
Filter results by ISO timezone to align nameday boundaries with the user's locale
Return parallel namedays from multiple countries to support multilingual greeting cards
Use Cases
Patterns agents use Nameday API for, with concrete tasks.
★ Personalised Greeting Automation
Many Central and Eastern European cultures celebrate name days alongside birthdays. Apps that send automated greetings call the today endpoint each morning, match the returned names against a contact list, and trigger personalised emails or SMS. The integration takes minutes because no authentication is required and responses are small JSON payloads.
Call GET /V2/today/Europe%2FPrague and email any contact whose first name appears in the Czech namedays list.
Nameday Lookup in Multilingual Apps
Localised calendar apps display the nameday for the current date alongside holidays. By calling GET /V2/date for a given month and day, the app gets parallel nameday entries for every supported country, letting users see what their name corresponds to in another locale. Three endpoints cover the entire feature without needing a custom data set.
Fetch namedays for month=11 day=19 and surface the Hungarian, Polish, and Slovak names side by side in a calendar widget.
Search a Name's Celebration Date
When users want to know when their name is celebrated, the search endpoint takes a first name and country and returns the matching date in the local nameday calendar. This is useful for diaspora communities and travel apps that surface cultural cues to visitors. The POST /V2/getname endpoint accepts a name and country code and returns the day and month of celebration.
POST to /V2/getname with name='Eva' and country='cz' to retrieve the date Eva is celebrated in Czech Republic.
AI Agent Cultural Awareness
An AI assistant invoked through Jentic can answer culturally aware queries like 'is it Karol's name day today in Slovakia?' Because the API needs no auth, the agent calls it through the Jentic SDK with no vault configuration, blending nameday data with calendar reasoning to suggest greetings, social-media posts, or messaging cues for the user.
Search Jentic for 'todays namedays', load the GET /V2/today/{timezone} operation, and execute it for Europe/Bratislava to surface Slovak namedays.
Key Endpoints
3 endpoints — jentic publishes the only available openapi specification for nameday api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/V2/today/{timezone}
Get today's namedays per country, scoped to a timezone
GET
/V2/date
Get namedays for a specific month and day
POST
/V2/getname
Search for a name's celebration date in a country
GET
/V2/today/{timezone}
Get today's namedays per country, scoped to a timezone
GET
/V2/date
Get namedays for a specific month and day
POST
/V2/getname
Search for a name's celebration date in a country
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
N
Nameday API
- AI-Aware (A-)71/100
100
Foundational Compliance63
Developer Experience & Jentic Compatibility49
AI-Readiness & Agent Experience94
Agent Usability100
Security75
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
100
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A+Signals: 4
99%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
63
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B-Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
50%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
49
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: D+Signals: 4
44%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
50%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
100
Security
Trust, risk posture, and security compliance.
Grade: A+Signals: 1
100%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
75
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: A-Signals: 1
75%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
The Nameday API needs no credentials, but wiring it by hand still means building calls against nameday.abalin.net/api and mapping its today, date, and getname endpoints yourself. Through Jentic you install once, import the Nameday API from the API Directory, and your agent calls it with one audited outbound path.
Permission scoping
The Nameday API passes the timezone and name through request parameters and bodies rather than a resource id in the URL path, so scope the agent to the operations it needs, such as reading today's namedays or searching by name, and leave any others out of the allowed set unless you include them.
Credential isolation
The Nameday API has no credentials to store, so there is no secret to manage. Requests still run through your own Jentic One instance, which keeps them out of the agent's prompt, logs, and context.
Intent-based discovery
Agents search Jentic by intent such as 'find todays namedays' or 'search a nameday by name', and Jentic returns the matching Nameday operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Nameday API through Jentic.
Why is there no official OpenAPI spec for Nameday API?
Abalin does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Nameday API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Nameday API use?
The Nameday API is open and requires no API key, OAuth token, or basic auth. When called through Jentic the agent receives the operation schema and calls the endpoint anonymously, so no vault entry is needed.
Which countries does the Nameday API cover?
The API supports parallel nameday calendars for Czech Republic, Slovakia, Hungary, Poland, Germany, Spain, France, Italy, Croatia, Sweden, Austria, and the United States. Each response from /V2/today and /V2/date contains a per-country namedays object so you can read multiple locales in a single call.
Can I look up the date a specific name is celebrated through the Nameday API?
Yes. POST /V2/getname accepts a name and country code (for example name='Eva', country='cz') and returns the matching month and day from that country's nameday calendar. Use this when users ask 'when is my name day' rather than 'who has a name day today'.
What are the rate limits for the Nameday API?
Abalin does not publish a formal rate limit in the spec. Because nameday data for a given date is stable across years for most countries, agents should cache /V2/today and /V2/date responses for at least 24 hours to avoid hitting the public service unnecessarily.
How do I fetch today's namedays for Slovakia through Jentic?
Run jentic.search('todays namedays by country'), load the GET /V2/today/{timezone} operation, then execute it with timezone='Europe/Bratislava'. The returned JSON contains a 'namedays' object with a 'sk' field listing names celebrated in Slovakia today.
Can I limit what my agent is allowed to do with the Nameday API?
Yes. Because you run Jentic One yourself, your own rules decide which Nameday operations the agent may call, so you can allow only the ones it needs. For example, you can permit reading today's namedays through GET /V2/today/{timezone} or looking up a date with GET /V2/date while leaving the POST /V2/getname name search out of the allowed set. Since this API passes the timezone and name through request parameters and bodies rather than a resource id in the URL path, scoping is done at the operation level by choosing which endpoints the agent is permitted to run.
GET STARTED