Features

Everything you need

A complete Czech calendar API with name days, holidays, and localized date information.

📅

366 Name Days

Complete Czech name day calendar including leap year. Every day of the year covered.

🇨🇿

Czech Holidays

All fixed holidays plus Easter-based moveable holidays (Good Friday & Easter Monday) calculated automatically.

🌍

Czech Localization

Day and month names in Czech with both nominative and genitive grammatical cases.

⚡

REST & GraphQL

Choose your preferred interface. Full REST API with path parameters or flexible GraphQL queries.

🚀

Edge Cached

CDN-cached responses for blazing fast performance. Date-specific endpoints cached for 1 hour.

🔒

CORS Enabled

Full CORS support. Call from any browser, mobile app, IoT device, or smart home system.

Try it

Live API Demo

Click an endpoint to see a real response from the API.

GET /api/day

Click an endpoint to load...

REST API

Endpoints

Simple, predictable REST endpoints. All responses are JSON.

Method	Endpoint	Description
GET	`/api/day`	Today's date information
GET	`/api/day/:date`	Specific date (YYYY-MM-DD format)
GET	`/api/day/:date/interval/:days`	Multiple consecutive days from a date
GET	`/api/week/:date`	7 days starting from a date
POST	`/api/graphql`	GraphQL endpoint

Response: Day Object

Day

date string ISO date: "2024-12-24"

dayNumber string Day of month: "24"

dayInWeek string Czech day name: "úterý"

monthNumber string Month number: "12"

month.nominative string Czech nominative: "prosinec"

month.genitive string Czech genitive: "prosince"

year string Year: "2024"

name string Name day: "Adam a Eva"

isHoliday boolean Whether it's a public holiday

holidayName string? Holiday name or null

Integration

Code Examples

Get started in seconds with any language or framework.

        
        
        
        
      

# Get today's name day
curl https://rainbow-salamander-94cbeb.netlify.app/api/day

# Get a specific date
curl https://rainbow-salamander-94cbeb.netlify.app/api/day/2024-12-24

# Get a week
curl https://rainbow-salamander-94cbeb.netlify.app/api/week/2024-12-24

# Get 14 days from a date
curl https://rainbow-salamander-94cbeb.netlify.app/api/day/2024-01-01/interval/14
      

// Fetch today's information
const response = await fetch('https://rainbow-salamander-94cbeb.netlify.app/api/day');
const today = await response.json();

console.log(today.name);        // "Milada"
console.log(today.dayInWeek);   // "sobota"
console.log(today.isHoliday);   // false

// Get Christmas Eve
const xmas = await fetch('https://rainbow-salamander-94cbeb.netlify.app/api/day/2024-12-24')
  .then(r => r.json());

console.log(xmas.holidayName);  // "Štědrý den"
      

import requests

# Get today's info
response = requests.get('https://rainbow-salamander-94cbeb.netlify.app/api/day')
today = response.json()

print(today['name'])        # Name day
print(today['dayInWeek'])   # Czech day name
print(today['isHoliday'])   # True/False

# Get a full week
week = requests.get('https://rainbow-salamander-94cbeb.netlify.app/api/week/2024-12-24').json()
for day in week['week']:
    print(f"{day['date']}: {day['name']}")
      

// Get today's info
$response = file_get_contents('https://rainbow-salamander-94cbeb.netlify.app/api/day');
$today = json_decode($response, true);

echo $today['name'];        // Name day
echo $today['dayInWeek'];   // Czech day name

// Get Christmas
$xmas = json_decode(
    file_get_contents('https://rainbow-salamander-94cbeb.netlify.app/api/day/2024-12-24'),
    true
);
echo $xmas['holidayName'];  // "Štědrý den"
      

GraphQL

GraphQL API

Flexible queries — request only the fields you need.

query {
  day(date: "2024-12-24") {
    date
    name
    dayInWeek
    month {
      nominative
      genitive
    }
    isHoliday
    holidayName
  }
}

query {
  week(startDate: "2024-12-24") {
    week {
      date
      name
      isHoliday
      holidayName
    }
  }
}

curl -X POST https://rainbow-salamander-94cbeb.netlify.app/api/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ day(date: \"2024-12-24\") { date name isHoliday holidayName } }"
  }'

Fair Use

Rate Limiting

Free for everyone with fair usage limits. Response headers tell you your current usage.

60

Requests per minute

1y

CDN cache (specific dates)

<24h

CDN cache (today, expires at midnight)

Response Headers

X-RateLimit-Limit number Maximum requests per window (60)

X-RateLimit-Remaining number Remaining requests in current window

Retry-After number Seconds to wait (only on 429 responses)

Czech Calendar APIfor Developers