{"openapi":"3.1.0","info":{"title":"Synaxar Name Day API","version":"1.0.0","description":"Public read-only name-day data and calendar feeds."},"servers":[{"url":"https://synaxar.com"}],"externalDocs":{"description":"Synaxar API reference","url":"https://synaxar.com/docs/api"},"paths":{"/api/portal/{market}/date/{date}":{"get":{"operationId":"getNameDays","summary":"Name days by date","description":"Returns the names and feast titles for one civil date in one market. An empty names array is a valid result.","parameters":[{"name":"market","in":"path","required":true,"description":"Two-letter market code.","schema":{"type":"string","enum":["el","pl","es","ro","sv","cs","sk"]},"example":"el"},{"name":"date","in":"path","required":true,"description":"Local YYYY-MM-DD date within the market’s supported years.","schema":{"type":"string","format":"date"},"example":"2026-11-06"}],"responses":{"200":{"description":"Returns the names and feast titles for one civil date in one market. An empty names array is a valid result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Day"}}}},"404":{"description":"Unknown market, unknown name slug, or invalid or unsupported date.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/portal/{market}/daily.ics":{"get":{"operationId":"getDailyCalendar","summary":"Daily calendar feed","description":"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.","parameters":[{"name":"market","in":"path","required":true,"description":"Two-letter market code.","schema":{"type":"string","enum":["el","pl","es","ro","sv","cs","sk"]},"example":"el"},{"name":"download","in":"query","description":"Use 1 to request an attachment.","schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"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.","content":{"text/calendar":{"schema":{"type":"string"}}}},"404":{"description":"Unknown market, unknown name slug, or invalid or unsupported date.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/portal/{market}/calendar/{slug}.ics":{"get":{"operationId":"getNameCalendar","summary":"Calendar for one name","description":"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.","parameters":[{"name":"market","in":"path","required":true,"description":"Two-letter market code.","schema":{"type":"string","enum":["el","pl","es","ro","sv","cs","sk"]},"example":"el"},{"name":"slug","in":"path","required":true,"description":"Exact ASCII slug from a name page in the selected market.","schema":{"type":"string"},"example":"giorgos"}],"responses":{"200":{"description":"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.","content":{"text/calendar":{"schema":{"type":"string"}}}},"404":{"description":"Unknown market, unknown name slug, or invalid or unsupported date.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"Service status and releases","description":"Reports the page release, data release, supported markets, build year, name count and storage readiness.","parameters":[],"responses":{"200":{"description":"Reports the page release, data release, supported markets, build year, name count and storage readiness.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"503":{"description":"The required catalog database is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}}},"components":{"schemas":{"Day":{"type":"object","required":["iso","year","month","day","weekday","names","feasts","movable"],"properties":{"iso":{"type":"string","format":"date","description":"The requested local civil date in YYYY-MM-DD format."},"year":{"type":"integer","description":"Four-digit calendar year."},"month":{"type":"integer","minimum":0,"maximum":11,"description":"Zero-based month. January is 0."},"day":{"type":"integer","minimum":1,"maximum":31,"description":"Day of the month."},"weekday":{"type":"integer","minimum":0,"maximum":6,"description":"Day of the week. Sunday is 0."},"names":{"type":"array","items":{"type":"string"},"description":"Listed names in the local spelling. The array is empty when the catalog has no names for that date."},"feasts":{"type":"array","items":{"type":"string"},"description":"Feast titles recorded for the day, in the local language."},"movable":{"type":"boolean","description":"True when a movable rule contributes to this date."},"commemoration":{"$ref":"#/components/schemas/Commemoration","description":"Optional Romanian observance with its own title, source URL and source ID. Display it separately from names."}}},"Commemoration":{"type":"object","required":["title","source","sourceId"],"properties":{"title":{"type":"string"},"source":{"type":"string","format":"uri"},"sourceId":{"type":"string"}}},"Health":{"type":"object","required":["service","release","dataRelease","markets","staticYear","names","database","assets"],"properties":{"service":{"type":"string"},"release":{"type":"string"},"dataRelease":{"type":"string"},"markets":{"type":"array","items":{"type":"string","enum":["el","pl","es","ro","sv","cs","sk"]}},"staticYear":{"type":"integer"},"names":{"type":"integer"},"database":{"type":"string","enum":["ready","unavailable","not-bound"]},"assets":{"type":"boolean"},"catalog":{"type":"object","additionalProperties":{"type":"string"}}}}}}}