Greek Name Days API - Documentation

4,421+

Name Days

3,220

Fixed Dates

1,194

Easter-Relative

v1

API Version

...

Page Visits

🚀 Quick Start

Health Check Today's Names Easter 2026 Jan 1 Names

📚 API Endpoints

GET Health Check

/api/health

Check if the API is running and get basic information.

Example Request:

GET http://localhost:3000/api/health

Response:

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

Response:

{
  "date": "2026-01-01",
  "names": ["Βασίλης", "Βασιλική", ...],
  "count": 21
}

Date: 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/today

Response:

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

Response:

{
  "name": "Βασίλης",
  "dates": ["2026-01-01", "2027-01-01"],
  "count": 2
}

Name:

Year (optional): 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
}

Search: 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=2026

Response:

{
  "year": 2026,
  "easter_date": "2026-04-12",
  "day_of_week": "Sunday"
}

Year: 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=2026

Using 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