Dokumentacja API

Publiczny punkt końcowy — klucz API nie jest wymagany. Zwraca true, jeśli podana data jest dniem wolnym od pracy na Litwie (niedziela lub święto państwowe), lub false w przeciwnym razie.

Zwraca również pole shorter_workday — zgodnie z art. 113 litewskiego Kodeksu pracy dzień roboczy bezpośrednio przed świętem państwowym jest skrócony o jedną godzinę. Dotyczy to nawet wtedy, gdy święto wypada w sobotę.

Limit: 60 żądań na minutę i 10 000 żądań miesięcznie, śledzony po adresie IP.

Parametry

Parametr	Typ	Wymagany	Opis
date	string	Tak	Data w formacie YYYY-MM-DD

Pola odpowiedzi

Parametr	Typ	Opis
date	string	Date in YYYY-MM-DD format
laisvadienis	boolean	true if non-working day (weekend or red holiday)
reason	string|null	"saturday", "sunday", "public_holiday", or null
holiday_name	string|null	Lithuanian holiday name when reason is "public_holiday", otherwise null
shorter_workday	boolean	true, gdy jest to dzień roboczy (laisvadienis: false) i następny dzień kalendarzowy jest czerwonym świętem państwowym — dzień roboczy skrócony o 1 godz. zgodnie z art. 113 KP. Zawsze false w dni wolne.

Przykładowe żądanie

curl "https://calendar.lt/api/v1/laisvadienis?date=2026-06-23"

Przykładowa odpowiedź

// Tuesday before Rasos ir Joninių diena (Jun 24) — workday is shortened:
{
  "date": "2026-06-23",
  "laisvadienis": false,
  "reason": null,
  "holiday_name": null,
  "shorter_workday": true
}

// The red holiday itself:
{
  "date": "2026-06-24",
  "laisvadienis": true,
  "reason": "public_holiday",
  "holiday_name": "Rasos ir Joninių diena",
  "shorter_workday": false
}

// Regular working day:
{
  "date": "2026-06-22",
  "laisvadienis": false,
  "reason": null,
  "holiday_name": null,
  "shorter_workday": false
}

// Saturday (holiday falls on Saturday — Friday would be shorter_workday: true):
{
  "date": "2026-01-03",
  "laisvadienis": true,
  "reason": "saturday",
  "holiday_name": null,
  "shorter_workday": false
}

Returns laisvadienis and shorter_workday status for every day in a date range — a batch version of /api/v1/laisvadienis. No API key required.

Rate limits (IP-based): 20 requests/min · 2 000 requests/month. Maximum range: 366 days per request.

Parametry

Parametr	Typ	Wymagany	Opis
from	string	Tak	Start date in YYYY-MM-DD format (inclusive)
to	string	Tak	End date in YYYY-MM-DD format (inclusive). Must not be earlier than from.

Pola odpowiedzi

Parametr	Typ	Opis
from	string	Echoes the from parameter
to	string	Echoes the to parameter
count	integer	Number of days in the response
days[].date	string	Date in YYYY-MM-DD format
days[].laisvadienis	boolean	true if non-working day (weekend or red public holiday)
days[].holiday_name	string|null	Lithuanian name of the red public holiday, or null
days[].shorter_workday	boolean	true, gdy jest to dzień roboczy (laisvadienis: false) i następny dzień kalendarzowy jest czerwonym świętem państwowym — dzień roboczy skrócony o 1 godz. zgodnie z art. 113 KP. Zawsze false w dni wolne.

Przykładowe żądanie

curl "https://calendar.lt/api/v1/days?from=2026-05-01&to=2026-05-31"

Przykładowa odpowiedź

{
  "from": "2026-05-01",
  "to": "2026-05-31",
  "count": 31,
  "days": [
    {
      "date": "2026-05-01",
      "laisvadienis": true,
      "holiday_name": "Tarptautinė darbo diena",
      "shorter_workday": false
    },
    {
      "date": "2026-05-02",
      "laisvadienis": false,
      "holiday_name": null,
      "shorter_workday": false
    },
    {
      "date": "2026-05-03",
      "laisvadienis": true,
      "holiday_name": "Motinos diena",
      "shorter_workday": false
    },
    {
      "date": "2026-05-04",
      "laisvadienis": false,
      "holiday_name": null,
      "shorter_workday": false
    }
  ]
}

Error responses

HTTP	Kod błędu	Opis
400	missing_param	Both from and to are required
400	invalid_date	Either date is not a valid YYYY-MM-DD value
400	invalid_range	from is later than to
400	range_too_large	Range exceeds 366 days — split into smaller requests
429	rate_limit_minute	20 requests/minute exceeded
429	rate_limit_month	2 000 requests/month exceeded

Zwraca litewskie święta dla podanej daty lub całego roku.

Parametry

Parametr	Typ	Wymagany	Opis
date	string	Tak*	Data w formacie YYYY-MM-DD — returns holidays for that specific date
year	integer	Tak*	Year (1583–2100) — returns all holidays for the entire year
lang	string	Nie	Język: lt, en, pl, ru (domyślnie: lt)

Provide either date or year — not both.

Pola odpowiedzi

Parametr	Typ	Opis
date / year	string / integer	Echoes the query parameter
count	integer	Number of holidays returned
holidays[].date	string	Date in YYYY-MM-DD
holidays[].name	string	Name in requested language
holidays[].name_lt/en/pl/ru	string	Names in all four languages
holidays[].type	string	public, traditional, religious, school, other
holidays[].is_red	boolean	true if this is a non-working day (laisvadienis) per DK 123 str.

Przykładowe żądanie

// By date:
curl "https://calendar.lt/api/v1/holidays?date=2026-04-05&lang=en" \
  -H "X-API-Key: clt_your_api_key_here"

// Full year:
curl "https://calendar.lt/api/v1/holidays?year=2026&lang=lt" \
  -H "X-API-Key: clt_your_api_key_here"

Przykładowa odpowiedź

{
  "date": "2026-04-05",
  "count": 1,
  "holidays": [
    {
      "date": "2026-04-05",
      "name": "Easter Sunday",
      "name_lt": "Šv. Velykos",
      "name_en": "Easter Sunday",
      "name_pl": "Niedziela Wielkanocna",
      "name_ru": "Пасха",
      "type": "public",
      "is_red": true
    }
  ]
}

Zwraca imieniny obchodzone w danym dniu.

Parametry

Parametr	Typ	Wymagany	Opis
date	string	Tak	Data w formacie YYYY-MM-DD
lang	string	Nie	Język: lt, en, pl, ru (domyślnie: lt)

Przykładowe żądanie

curl "https://calendar.lt/api/v1/name-days?date=2026-03-19&lang=lt" \
  -H "X-API-Key: clt_your_api_key_here"

Przykładowa odpowiedź

{
  "date": "2026-03-19",
  "lang": "lt",
  "count": 3,
  "name_days": [
    { "name": "Juozapas", "gender": "m" },
    { "name": "Juozas",   "gender": "m" },
    { "name": "Juzė",     "gender": "f" }
  ]
}

Zwraca pełne dane dnia: święta i imieniny łącznie.

Parametry

Parametr	Typ	Wymagany	Opis
date	string	Tak	Data w formacie YYYY-MM-DD
lang	string	Nie	Język: lt, en, pl, ru (domyślnie: lt)

Pola odpowiedzi

Parametr	Typ	Opis
date	string	Date in YYYY-MM-DD
lang	string	Language used for names
day_of_week	integer	0 = Sunday, 1 = Monday … 6 = Saturday
is_weekend	boolean	true for Saturday or Sunday
week_number	integer	ISO 8601 week number
holidays[].name	string	Holiday name in requested language
holidays[].name_lt/en	string	Names in Lithuanian and English
holidays[].date	string	Holiday date (YYYY-MM-DD)
holidays[].type	string	Holiday category
holidays[].is_red	boolean	true if non-working day (laisvadienis)
name_days[].name	string	Name-day name
name_days[].gender	string	"m" or "f"

Przykładowe żądanie

curl "https://calendar.lt/api/v1/day?date=2026-05-03&lang=en" \
  -H "X-API-Key: clt_your_api_key_here"

Przykładowa odpowiedź

{
  "date": "2026-05-03",
  "lang": "en",
  "day_of_week": 0,
  "is_weekend": true,
  "week_number": 18,
  "holidays": [
    {
      "name": "Mother's Day",
      "name_lt": "Motinos diena",
      "name_en": "Mother's Day",
      "date": "2026-05-03",
      "type": "traditional",
      "is_red": true
    }
  ],
  "name_days": [
    { "name": "Irma", "gender": "f" }
  ]
}