DEVELOPER REFERENCE

Name Day API Reference

Use the public Synaxar name-day API for date lookups, iCalendar feeds and service status across seven local calendars.

Quickstart

Base URL https://synaxar.com. The API is public and read-only. Use HTTPS and GET to fetch data. An API key is unnecessary.

Run this request to get the Greek name days for 6 November 2026.

curl -fsS 'https://synaxar.com/api/portal/el/date/2026-11-06'

Open the live response OpenAPI JSON

Endpoints

Name days by date

GET/api/portal/{market}/date/{date}

Returns the names and feast titles for one civil date in one market. An empty names array is a valid result.

Open example JSONapplication/json

Daily calendar feed

GET/api/portal/{market}/daily.ics

Returns a rolling 366-day calendar from the local date, with events for days with listed names or a commemoration. Add download=1 for an attachment.

Open calendar feedtext/calendar

Calendar for one name

GET/api/portal/{market}/calendar/{slug}.ics

Downloads up to three upcoming celebrations for a name as separate all-day events. Use the last part of its local name page URL as the slug.

Download name calendartext/calendar

Service status and releases

GET/api/health

Reports the page release, data release, supported markets, build year, name count and storage readiness.

Open live service statusapplication/json

Date response fields

{
  "iso": "2026-11-06",
  "year": 2026,
  "month": 10,
  "day": 6,
  "weekday": 5,
  "names": [
    "Λεονάρδος"
  ],
  "feasts": [],
  "movable": false
}

Field	Meaning
`iso`	The requested local civil date in YYYY-MM-DD format.
`year`	Four-digit calendar year.
`month`	Zero-based month. January is 0.
`day`	Day of the month.
`weekday`	Day of the week. Sunday is 0.
`names`	Listed names in the local spelling. The array is empty when the catalog has no names for that date.
`feasts`	Feast titles recorded for the day, in the local language.
`movable`	True when a movable rule contributes to this date.
`commemoration`	Optional Romanian observance with its own title, source URL and source ID. Display it separately from names.

Check names before answering who celebrates. An empty array can accompany a Romanian commemoration. See a Romanian example

Market codes and date ranges

Pass the two-letter code and a valid YYYY-MM-DD civil date. For a “today” lookup, compute the date in the selected market’s time zone before calling the endpoint.

Code	Country	Time zone	Years
`el`	Greece	`Europe/Athens`	2000–2099
`pl`	Poland	`Europe/Warsaw`	2000–2099
`es`	Spain	`Europe/Madrid`	2026–2099
`ro`	Romania	`Europe/Bucharest`	2000–2099
`sv`	Sweden	`Europe/Stockholm`	2022–2099
`cs`	Czechia	`Europe/Prague`	2026–2099
`sk`	Slovakia	`Europe/Bratislava`	2025–2099

Year ranges describe supported calculations. Coverage and source editions are listed in the country guide.

Status, formats and caching

200 returns JSON or iCalendar in UTF-8. Use HEAD to check status and headers.
404 covers an unknown market, an unknown name slug or an invalid or unsupported date. Check the HTTP status before parsing. Error pages use HTML.
405 applies to unsupported methods on calendar and date routes. 503 on the status endpoint indicates a required database is unavailable.
Date responses are cached for up to an hour. Calendar feeds can be cached at the edge for an hour. The status response is uncached.

For a browser app hosted on another origin, make requests through your backend. The dataRelease field in service status identifies the calendar data revision.

For apps and AI tools

Load OpenAPI JSON into a compatible client to see request parameters and response schemas. For the public page links and sources, start at llms.txt or the documentation guide.