Chile Holiday API
Chile has 16 public holidays — 7 of which are irrenunciable by law, meaning employers cannot require employees to work them. The API returns this flag on every holiday, so your app knows the difference.
Free plan includes commercial use · no credit card required
Why Chile's calendar can't be hardcoded
Chile's public holiday system has legal distinctions that matter in production — not just for HR, but for payment processors, e-commerce platforms, and any system that calculates dates.
7 out of 16 holidays are irrenunciable — employers are legally barred from requiring work. The API includes an irrenunciable flag on every response so your system can apply the right business rule.
Chile includes Sábado Santo (Holy Saturday) as a public holiday. Most other countries only observe Viernes Santo (Good Friday). If your platform serves multiple countries, this is an easy bug to miss.
When September 18th falls on Tuesday, the government typically decrees a puente on Monday the 17th. This is not published in January — it's decreed weeks before. A static list won't have it.
API response for Chile
The irrenunciable field is unique to Chile's response and tells your system whether the employer can legally require work on that day.
{
"success": true,
"data": [
{
"date": "2026-04-03",
"name": "Viernes Santo",
"type": "national",
"irrenunciable": true
},
{
"date": "2026-04-04",
"name": "Sábado Santo",
"type": "national",
"irrenunciable": false
},
{
"date": "2026-05-01",
"name": "Día Nacional del Trabajo",
"type": "national",
"irrenunciable": true
}
],
"meta": { "country": "CL", "year": 2026, "total": 16 }
}{
"success": true,
"data": {
"date": "2026-09-18",
"is_business_day": false,
"holiday_name": "Independencia Nacional",
"irrenunciable": true
},
"meta": { "country": "CL" }
}Endpoints for Chile
Replace :country with CL.
Free plan includes holidays, is-business-day, and next-holiday.
/v1/CL/holidays/:year Free All public holidays for Chile in a given year. Includes irrenunciable flag on each entry.
"total": 16, "irrenunciable": true /v1/CL/is-business-day?date=YYYY-MM-DD Free Check if a date is a business day in Chile. Returns holiday name and irrenunciable status if applicable.
"is_business_day": false, "irrenunciable": true /v1/CL/business-days/add?date=YYYY-MM-DD&days=N Starter Add N business days to a date, skipping weekends and Chilean holidays. Returns the exact result date.
"result_date": "2026-04-09" /v1/CL/business-days/between?from=YYYY-MM-DD&to=YYYY-MM-DD Starter Count business days between two dates, excluding Chilean holidays.
"business_days": 20 /v1/CL/last-business-day?date=YYYY-MM-DD Starter Get the last business day of the month for the given date. Used for billing cycles and accounting cutoffs.
"last_business_day": "2026-09-30" Validating a payment date in Chile
A common pattern for fintech and subscription billing: check if the scheduled charge date is a business day, and if not, shift to the previous business day.
const API = "https://api.feriados.io/v1";
const KEY = process.env.FERIADOS_API_KEY;
async function resolveChilePaymentDate(date) {
const res = await fetch(
`${API}/CL/is-business-day?date=${date}`,
{ headers: { Authorization: `Bearer ${KEY}` } }
);
const { data } = await res.json();
if (data.is_business_day) return date;
// Shift to previous business day (common practice in Chilean banking)
const prev = await fetch(
`${API}/CL/business-days/subtract?date=${date}&days=1`,
{ headers: { Authorization: `Bearer ${KEY}` } }
);
const { data: shifted } = await prev.json();
return shifted.result_date;
}
// Sep 18 → Fiestas Patrias → shifts to Sep 16
const paymentDate = await resolveChilePaymentDate("2026-09-18");
// → "2026-09-16"Common use cases for Chile
The same API key works for all 11 LATAM countries — Chile is just the country code.
A charge on Viernes Santo or Fiestas Patrias can fail or arrive a day late. Validate before scheduling, not after.
is-business-day Free "Arrives in 3 business days" — without accounting for Semana Santa that promise breaks.
business-days/add Starter Payroll calculations need actual worked days. Irrenunciable holidays cannot be traded or compensated.
business-days/between Starter Legal deadlines in Chile run in business days. A one-day error in a contract can be a breach.
business-days/between Starter High-risk months for Chile in 2026
These are the months where date calculation bugs are most likely to surface in production.
Viernes Santo (Apr 3) + Sábado Santo (Apr 4) — back-to-back, 4-day window with Easter weekend
Fiestas Patrias: Sep 18 (Fri) + Sep 19 (Sat). Potential puente on Sep 17 if decreed — not in static lists
Navidad (Dec 25, Fri) + year-end close. Billing cycles and accounting cutoffs overlap
Día del Trabajo (May 1, Fri) — irrenunciable, long weekend, affects payroll and delivery windows
Also available for 10 more LATAM countries
Same API, same endpoints — just swap the country code.
Ready for production
Free API key in 30 seconds. Free plan includes is-business-day for Chile with commercial use.
Starter plan from $9/mo for full operational logic.