Argentina Holiday API
Argentina has 16 confirmed public holidays — plus 2 to 4 additional bridge holidays decreed by the Executive Branch throughout the year, sometimes with less than two weeks' notice. No static list is ever complete.
Free plan includes commercial use · no credit card required
Why Argentina is the hardest LATAM country to hardcode
Argentina is the only country in Latin America where the total number of public holidays is unknown at the start of the year. Three separate mechanisms make static lists unreliable.
The Executive Branch can declare feriados puente (bridge holidays) at any point in the year to create long weekends. In 2024 there were 2; in 2023 there were also 2. Some were announced with 10 days notice.
Carnaval (Monday and Tuesday before Ash Wednesday) depends on Easter — which changes every year. You can't precompute these without implementing the Easter algorithm first.
Each province has its own non-working days. Buenos Aires City observes November 1st and November 25th. Provincial data is separate from the national calendar.
Recent decree-based puentes in Argentina
These are real examples of bridge holidays that were not published at the start of the year — and would have been missing from any static list built in January.
The Business plan includes a webhook that fires within 24 hours of any new decree. See plans →
API response for Argentina
The API includes a type field to distinguish between fixed national holidays and decree-based bridge holidays.
{
"success": true,
"data": [
{
"date": "2026-02-16",
"name": "Carnaval",
"type": "national"
},
{
"date": "2026-02-17",
"name": "Carnaval",
"type": "national"
},
{
"date": "2026-03-24",
"name": "Día Nacional de la Memoria por la Verdad y la Justicia",
"type": "national"
}
],
"meta": {
"country": "AR",
"year": 2026,
"total": 16,
"note": "Decree-based puentes will be added as announced"
}
}{
"success": true,
"data": {
"date": "2026-04-02",
"name": "Día del Veterano y los Caídos en Malvinas",
"days_until": 6
},
"meta": { "country": "AR" }
}Endpoints for Argentina
Replace :country with AR.
Free plan includes holidays, is-business-day, and next-holiday.
/v1/AR/holidays/:year Free All public holidays for Argentina, including any puentes already decreed. Updated within 24 hours of each official decree.
"total": 16, "note": "Decree-based puentes added as announced" /v1/AR/is-business-day?date=YYYY-MM-DD Free Check if a date is a business day in Argentina. Includes puentes that have been decreed — even if they were announced after your deploy.
"is_business_day": false, "holiday_name": "Feriado puente" /v1/AR/business-days/add?date=YYYY-MM-DD&days=N Starter Add N business days, skipping all Argentine holidays including decreed puentes. No redeploy needed when a new decree is issued.
"result_date": "2026-05-08" /v1/AR/business-days/between?from=YYYY-MM-DD&to=YYYY-MM-DD Starter Count business days between two dates. February is the most variable month — Carnaval moves with Easter.
"business_days": 18 /v1/AR/last-business-day?date=YYYY-MM-DD Starter Last business day of the month. Useful for payroll cutoffs and accounting closes.
"last_business_day": "2026-05-29" Staying current without redeploying
When Argentina decrees a new puente, apps with hardcoded lists need a hotfix. Apps using the API don't.
const API = "https://api.feriados.io/v1";
const KEY = process.env.FERIADOS_API_KEY;
// ❌ Wrong: a static list will miss decree-based puentes
const holidays2026 = [
"2026-01-01", "2026-02-16", "2026-02-17" // ...
// A new puente is decreed on March 1st → missing from this list
];
// ✅ Correct: the API is updated when decrees are published
async function isBusinessDay(date) {
const res = await fetch(
`${API}/AR/is-business-day?date=${date}`,
{ headers: { Authorization: `Bearer ${KEY}` } }
);
const { data } = await res.json();
return data.is_business_day;
}
// Works correctly even for puentes decreed after your last deploy
await isBusinessDay("2026-06-19"); // → false, if a puente is decreedCommon use cases for Argentina
The decree-based puentes are the core argument — any system that can't absorb a mid-year calendar change is a liability.
A payment scheduled for a newly-decreed puente will fail or be delayed. The API is updated within 24h of each decree — your code doesn't need to change.
is-business-day Free Delivery estimates break when a puente is decreed after your last deploy. Real-time API calls absorb the change automatically.
business-days/add Starter February in Argentina has 18 business days — not 20 — because of Carnaval. And that's before any puentes.
business-days/between Starter Cron jobs that run on business days need to know when Argentina adds a new puente. Business plan webhooks fire within 24h of each decree.
is-business-day Free 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 Argentina with commercial use.
Business plan includes decree webhooks within 24h.