Built for Developers

// Ruby Example
require 'festivo'
client = Festivo::Client.new('YOUR_API_KEY')
holidays = client.get_holidays(country: 'IT', regions: 'IT-MILAN', year: 2026)
puts holidays

// Java Example
import com.festivo.FestivoClient;
FestivoClient client = new FestivoClient("YOUR_API_KEY");
FestivoClient.HolidaysResponse holidays = client.getCityHolidays("IT", "IT-MILAN", 2026, null);
System.out.println(holidays.holidays);

// Node.js Example
const axios = require('axios');
const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://api.getfestivo.com/v3';
async function getHolidays(country, year) {
  const response = await axios.get(
    `${BASE_URL}/public-holidays/list`,
    {
      params: { country, year },
      headers: { 
        'X-API-Key': API_KEY
      }
    }
  );
  
  return response.data.holidays;
}

// Usage
const holidays = await getHolidays('US', 2024);
console.log('US Holidays:', holidays);