4,421+
Name Days
3,220
Fixed Dates
1,194
Easter-Relative
v1
API Version
馃殌 Quick Start
馃摎 API Endpoints
GET Health Check
/api/health
Check if the API is running and get basic information.
Example Request:
GET http://localhost:3000/api/healthResponse:
{
"status": "ok",
"timestamp": "2026-01-05T14:00:00.000Z",
"version": "v1"
}GET Get Name Days for a Date
/api/v1/name-days?date=YYYY-MM-DD
Get all names celebrated on a specific date.
Example Request:
GET http://localhost:3000/api/v1/name-days?date=2026-01-01Response:
{
"date": "2026-01-01",
"names": ["螔伪蟽委位畏蟼", "螔伪蟽喂位喂魏萎", ...],
"count": 21
}
Format: YYYY-MM-DD
GET Get Today's Name Days
/api/v1/name-days/today
Get all names celebrated today.
Example Request:
GET http://localhost:3000/api/v1/name-days/todayResponse:
{
"date": "2026-01-05",
"names": ["...", "..."],
"count": 6
}GET Get Dates for a Name
/api/v1/name-days/:name/api/v1/name-days/:name?year=YYYY
Get all dates when a specific name is celebrated. Optionally specify a year for Easter-relative names.
Example Request:
GET http://localhost:3000/api/v1/name-days/螔伪蟽委位畏蟼
GET http://localhost:3000/api/v1/name-days/螛蠅渭维蟼?year=2026Response:
{
"name": "螔伪蟽委位畏蟼",
"dates": ["2026-01-01", "2027-01-01"],
"count": 2
}
For Easter-relative names
GET Search Names
/api/v1/name-days/search?q=query
Search for names by partial match (minimum 2 characters).
Example Request:
GET http://localhost:3000/api/v1/name-days/search?q=螔伪蟽Response:
{
"query": "螔伪蟽",
"names": ["螔伪蟽委位畏蟼", "螔伪蟽喂位喂魏萎", ...],
"count": 15
}
Minimum 2 characters
GET Get Easter Date
/api/v1/easter?year=YYYY
Calculate Orthodox Easter date for a given year using the Gauss algorithm.
Example Request:
GET http://localhost:3000/api/v1/easter?year=2026Response:
{
"year": 2026,
"easter_date": "2026-04-12",
"day_of_week": "Sunday"
}
Between 1583 and 3000
馃挕 Usage Examples
Using curl:
curl http://localhost:3000/api/v1/name-days?date=2026-01-01
curl http://localhost:3000/api/v1/name-days/search?q=螕蔚
curl http://localhost:3000/api/v1/easter?year=2026Using JavaScript (fetch):
// Get name days for a date
const response = await fetch('http://localhost:3000/api/v1/name-days?date=2026-01-01');
const data = await response.json();
console.log(data.names); // ["螔伪蟽委位畏蟼", "螔伪蟽喂位喂魏萎", ...]
// Search names
const searchResponse = await fetch('http://localhost:3000/api/v1/name-days/search?q=螔伪蟽');
const searchData = await searchResponse.json();
console.log(searchData.names);
// Get Easter date
const easterResponse = await fetch('http://localhost:3000/api/v1/easter?year=2026');
const easterData = await easterResponse.json();
console.log(easterData.easter_date);Using PowerShell:
Invoke-RestMethod -Uri "http://localhost:3000/api/v1/name-days?date=2026-01-01"
Invoke-RestMethod -Uri "http://localhost:3000/api/v1/easter?year=2026"馃摉 Data Types
- Fixed dates: Name days that occur on the same date every year (e.g., January 1st)
- Easter-relative: Name days calculated relative to Easter (e.g., first Sunday after Easter)
- Clean Monday relative: Name days 48 days before Easter
- Palm Sunday relative: Name days 7 days before Easter