Bolivia Holiday API
Bolivia has 12 national public holidays plus departmental civic holidays for each of its 9 departments. Carnaval is 2 official non-working days, and Día de la Patria (Aug 6) shuts down the entire country. The API covers the national calendar — the complete baseline any system serving Bolivia needs.
Free plan includes commercial use · no credit card required
Why Bolivia's calendar can't be hardcoded
Bolivia's national holidays are the minimum floor. Depending on your users' locations within Bolivia, additional departmental holidays may apply — and Carnaval adds 2 days that most LATAM systems ignore.
Each of Bolivia's 9 departments has its own founding civic holiday (e.g., La Paz: Jul 16, Santa Cruz: Sep 24). The API provides the national calendar — the foundation every Bolivian operation needs regardless of location.
Bolivia's Carnaval Monday and Tuesday are official national non-working days. Most multi-country platforms don't model these as holidays — and Oruro's Carnaval is a UNESCO heritage event that shuts down the entire country.
Bolivia's independence day is the largest public holiday. All government offices, banks, and most private businesses close. Systems scheduling operations around August 6 must account for it.
API response for Bolivia
The national calendar returned by the API is the complete set of official non-working days for all of Bolivia.
{
"success": true,
"data": [
{
"date": "2026-02-16",
"name": "Carnaval",
"type": "national"
},
{
"date": "2026-02-17",
"name": "Carnaval",
"type": "national"
},
{
"date": "2026-08-06",
"name": "Día de la Patria",
"type": "national"
},
{
"date": "2026-11-02",
"name": "Día de los Difuntos",
"type": "national"
}
],
"meta": { "country": "BO", "year": 2026, "total": 12 }
}{
"success": true,
"data": {
"date": "2026-08-06",
"is_business_day": false,
"holiday_name": "Día de la Patria"
},
"meta": { "country": "BO" }
}Endpoints for Bolivia
Replace :country with BO.
Free plan includes holidays, is-business-day, and next-holiday.
/v1/BO/holidays/:year Free All national public holidays for Bolivia in a given year. Includes Carnaval and all civic holidays.
"total": 12, "name": "Día de la Patria" /v1/BO/is-business-day?date=YYYY-MM-DD Free Check if a date is a business day in Bolivia. Returns holiday name if applicable.
"is_business_day": false, "holiday_name": "Carnaval" /v1/BO/business-days/add?date=YYYY-MM-DD&days=N Starter Add N business days to a date, skipping weekends and Bolivian holidays including the Carnaval window.
"result_date": "2026-08-10" /v1/BO/business-days/between?from=YYYY-MM-DD&to=YYYY-MM-DD Starter Count business days between two dates, excluding Bolivian national holidays.
"business_days": 19 /v1/BO/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 payroll cutoffs.
"last_business_day": "2026-08-31" Checking next business day after Día de la Patria
August 6 is Bolivia's most important holiday. Any system scheduling operations or deliveries around this date needs to know the next valid business day.
const API = "https://api.feriados.io/v1";
const KEY = process.env.FERIADOS_API_KEY;
async function getBoliviaNextBusinessDay(date) {
const res = await fetch(
`${API}/BO/is-business-day?date=${date}`,
{ headers: { Authorization: `Bearer ${KEY}` } }
);
const { data } = await res.json();
if (data.is_business_day) return date;
const next = await fetch(
`${API}/BO/business-days/add?date=${date}&days=1`,
{ headers: { Authorization: `Bearer ${KEY}` } }
);
const { data: shifted } = await next.json();
return shifted.result_date;
}
// Aug 6 (Día de la Patria, Thu) → next business day
const nextDay = await getBoliviaNextBusinessDay("2026-08-06");
// → "2026-08-07"Common use cases for Bolivia
The same API key works for all 11 LATAM countries — Bolivia is just the country code.
Bolivian banks close on Día de la Patria and Carnaval. A payment scheduled on those dates will fail or queue — validate first.
is-business-day Free Carnaval shuts down warehousing and courier services for 2 days. "Next-day delivery" promises made on Friday before Carnaval fail.
business-days/add Starter Payroll periods that span Carnaval (2 days) or August need exact worked-day counts, not calendar-day estimates.
business-days/between Starter Bolivian legal deadlines run in business days. An SLA that ignores Día de la Patria will be in breach without your system knowing.
business-days/between Starter High-risk months for Bolivia 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. The Oruro Carnaval effectively extends closures in much of the country.
Viernes Santo (Apr 3) — Easter creates a 4-day weekend. Most businesses and government close Thursday through Sunday.
Día de la Patria (Aug 6, Thu in 2026) — the most important national holiday. Back-to-back with the weekend creates a 4-day gap.
Día de los Difuntos (Nov 2, Mon in 2026) — following All Saints' Day creates an extended closure for schools, government, and many businesses.
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 Bolivia with commercial use.
Starter plan from $9/mo for full operational logic.