Panama Holiday API
Panama has 19 public holidays — the most in Latin America. November alone has 4 civic independence dates (Mes de la Patria), creating multiple short work weeks in a single month. Any system assuming a standard business calendar for Panama will be wrong most of November.
Free plan includes commercial use · no credit card required
Why Panama's calendar can't be hardcoded
With 19 official public holidays, Panama is an outlier in the region. November alone can disrupt two full work weeks. No generic LATAM holiday library covers this correctly.
Panama has more official public holidays than any other country in Latin America. For reference, Mexico has 7, Chile has 16. Systems that cap holiday data or use approximate lists will have gaps.
November has 4 civic independence holidays: Nov 3 (Separación de Colombia), Nov 4 (Día de la Bandera), Nov 10 (Primer Grito), Nov 28 (Independencia de España). Scheduling anything across November without this calendar is a guaranteed delivery failure.
The 4 days before Ash Wednesday are not all official national holidays, but most businesses — especially in Panama City — shut down for the full Carnaval. The API provides the official calendar; actual closures can extend further.
API response for Panama
November's 4 civic holidays — returned as separate entries — are the most common source of scheduling failures for systems serving Panama.
{
"success": true,
"data": [
{
"date": "2026-01-09",
"name": "Día de los Mártires",
"type": "national"
},
{
"date": "2026-11-03",
"name": "Separación de Colombia",
"type": "national"
},
{
"date": "2026-11-04",
"name": "Día de la Bandera",
"type": "national"
},
{
"date": "2026-11-10",
"name": "Primer Grito de Independencia",
"type": "national"
},
{
"date": "2026-11-28",
"name": "Independencia de España",
"type": "national"
}
],
"meta": { "country": "PA", "year": 2026, "total": 19 }
}{
"success": true,
"data": {
"date": "2026-11-04",
"is_business_day": false,
"holiday_name": "Día de la Bandera"
},
"meta": { "country": "PA" }
}Endpoints for Panama
Replace :country with PA.
Free plan includes holidays, is-business-day, and next-holiday.
/v1/PA/holidays/:year Free All 19 public holidays for Panama in a given year. Includes all 4 November civic dates.
"total": 19, "name": "Separación de Colombia" /v1/PA/is-business-day?date=YYYY-MM-DD Free Check if a date is a business day in Panama. Returns holiday name if applicable.
"is_business_day": false, "holiday_name": "Día de la Bandera" /v1/PA/business-days/add?date=YYYY-MM-DD&days=N Starter Add N business days to a date, skipping weekends and all 19 Panamanian holidays.
"result_date": "2026-11-13" /v1/PA/business-days/between?from=YYYY-MM-DD&to=YYYY-MM-DD Starter Count business days between two dates, excluding all Panamanian holidays.
"business_days": 14 /v1/PA/last-business-day?date=YYYY-MM-DD Starter Get the last business day of the month. Critical for November billing given the 4 civic dates.
"last_business_day": "2026-11-30" Scheduling logistics through Panama's November
November has 4 civic holidays spread across the month. This pattern calculates the actual number of business days available for operations in November.
const API = "https://api.feriados.io/v1";
const KEY = process.env.FERIADOS_API_KEY;
async function getPanamaBusinessDays(from, to) {
const res = await fetch(
`${API}/PA/business-days/between?from=${from}&to=${to}`,
{ headers: { Authorization: `Bearer ${KEY}` } }
);
const { data } = await res.json();
return data.business_days;
}
// How many business days in November 2026?
// Excludes: Nov 3, 4, 10, 28 (4 civic holidays) + weekends
const november = await getPanamaBusinessDays("2026-11-01", "2026-11-30");
// → 17 (not 21 as a naive calculator would return)Common use cases for Panama
The same API key works for all 11 LATAM countries — Panama is just the country code.
With 19 official holidays, Panama has more non-processing days than any country in LATAM. Any payment scheduler that doesn't model all 19 will fail repeatedly.
is-business-day Free November is the worst month for Panamanian logistics. 4 civic holidays means only ~17 actual business days. "5 business days" starting Nov 3 could land Nov 13.
business-days/add Starter Payroll calculations in Panama with 19 holidays require exact worked-day counts. November alone has 4 non-working days — a standard 22-day month assumption is structurally wrong.
business-days/between Starter Panama uses business-day deadlines in legal and commercial contracts. Missing Día de los Mártires (Jan 9) or any November civic date puts SLAs in breach.
business-days/between Starter High-risk months for Panama in 2026
These are the months where date calculation bugs are most likely to surface in production.
Día de los Mártires (Jan 9, Fri in 2026) — unique to Panama. Combined with New Year's (Jan 1), January starts with 2 non-working days in the first 2 weeks.
Viernes Santo (Apr 3) + Sábado Santo (Apr 4) — 4-day Easter weekend. One of the most observed shutdowns in Panama.
4 civic holidays: Nov 3, 4, 10, 28 — Mes de la Patria. The highest-risk month in Panama's calendar with only ~17 effective business days.
Navidad (Dec 25, Fri) + year-end. Combined with November's density, Q4 in Panama has the fewest effective business days of the year.
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 Panama with commercial use.
Starter plan from $9/mo for full operational logic.