Ecuador Holiday API
Ecuador uses a moveable holiday rule: when a holiday falls on a Tuesday or Thursday, the government can decree a puente to extend the weekend. November has two consecutive national holidays (Nov 2 + Nov 3) that create a 4-day window. A static calendar can't handle either of these.
Free plan includes commercial use · no credit card required
Why Ecuador's calendar can't be hardcoded
Ecuador's holiday system introduces runtime variability that static lists cannot represent. Puentes, consecutive holidays, and regional dates all require an up-to-date source.
When a holiday falls on Tuesday or Thursday, Ecuador can officially move the observed day to Monday or Friday, creating a long weekend. This is decreed by executive order — not predictable from the calendar date alone.
Día de Difuntos (Nov 2) and Independencia de Cuenca (Nov 3) fall on consecutive days. In years where these align with the weekend, the gap can reach 4 days. This is the single highest-risk window for Ecuadorian SLA and delivery systems.
Ecuador's most important civic holiday has no equivalent in other LATAM countries. Any system assuming May is a standard month without country-specific holidays will get this wrong.
API response for Ecuador
The November cluster — two consecutive holidays — is the most common source of missed deadlines for systems serving Ecuador.
{
"success": true,
"data": [
{
"date": "2026-05-24",
"name": "Batalla de Pichincha",
"type": "national"
},
{
"date": "2026-11-02",
"name": "Día de los Difuntos",
"type": "national"
},
{
"date": "2026-11-03",
"name": "Independencia de Cuenca",
"type": "national"
},
{
"date": "2026-12-25",
"name": "Navidad",
"type": "national"
}
],
"meta": { "country": "EC", "year": 2026, "total": 13 }
}{
"success": true,
"data": {
"date": "2026-11-03",
"is_business_day": false,
"holiday_name": "Independencia de Cuenca"
},
"meta": { "country": "EC" }
}Endpoints for Ecuador
Replace :country with EC.
Free plan includes holidays, is-business-day, and next-holiday.
/v1/EC/holidays/:year Free All public holidays for Ecuador in a given year, including any officially decreed puentes.
"total": 13, "name": "Batalla de Pichincha" /v1/EC/is-business-day?date=YYYY-MM-DD Free Check if a date is a business day in Ecuador. Returns holiday name for both fixed and decreed puente days.
"is_business_day": false, "holiday_name": "Día de los Difuntos" /v1/EC/business-days/add?date=YYYY-MM-DD&days=N Starter Add N business days to a date, skipping weekends and Ecuadorian holidays including the November cluster.
"result_date": "2026-11-06" /v1/EC/business-days/between?from=YYYY-MM-DD&to=YYYY-MM-DD Starter Count business days between two dates, excluding Ecuadorian holidays.
"business_days": 18 /v1/EC/last-business-day?date=YYYY-MM-DD Starter Get the last business day of the month. Used for billing cycles and accounting cutoffs.
"last_business_day": "2026-11-30" Calculating delivery windows through November in Ecuador
November's back-to-back holidays (Nov 2 + 3) mean any delivery promised in "3 business days" starting Oct 30 will arrive November 6 — not November 4 as a naive calculator returns.
const API = "https://api.feriados.io/v1";
const KEY = process.env.FERIADOS_API_KEY;
async function getEcuadorDeliveryDate(orderDate, businessDays) {
const res = await fetch(
`${API}/EC/business-days/add?date=${orderDate}&days=${businessDays}`,
{ headers: { Authorization: `Bearer ${KEY}` } }
);
const { data } = await res.json();
return data.result_date;
}
// 3 business days from Oct 30 → skips Nov 2 + Nov 3 cluster
const delivery = await getEcuadorDeliveryDate("2026-10-30", 3);
// → "2026-11-06" (not Nov 4 as a naive calculator would say)Common use cases for Ecuador
The same API key works for all 11 LATAM countries — Ecuador is just the country code.
Ecuadorian banks don't process on Pichincha or the November cluster. A payment scheduled on Nov 2 or 3 will be held or rejected.
is-business-day Free The November dual-holiday is the most missed window in Ecuadorian logistics. "3 business days" from Oct 30 becomes 7 calendar days.
business-days/add Starter Payroll periods that include Pichincha (May 24) or the November cluster require exact worked-day counts for Ecuadorian law compliance.
business-days/between Starter Ecuadorian legal deadlines run in business days. Moveable puentes change the calendar at runtime — static SLA logic will breach contract.
business-days/between Starter High-risk months for Ecuador in 2026
These are the months where date calculation bugs are most likely to surface in production.
Carnaval: Feb 16 (Mon) + Feb 17 (Tue) — 2 national non-working days. Moveable holiday rules may extend the window further.
Viernes Santo (Apr 3) — 4-day Easter weekend. Any puente decree on Thu Apr 2 extends the window to 5 days.
Batalla de Pichincha (May 24, Sun in 2026). Observed on Fri May 22 per moveable holiday rule — affects payroll and SLA calculations.
Día de Difuntos (Nov 2) + Independencia de Cuenca (Nov 3) — two consecutive holidays. The highest-risk window in Ecuador's calendar.
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 Ecuador with commercial use.
Starter plan from $9/mo for full operational logic.