US & Puerto Rico Holidays + Business Days API
Pricing
from $3.00 / 1,000 api requests
Official US federal, state (50 + DC) and Puerto Rico holidays with business-day math, Federal Reserve bank days, and Spanish names. Every date cites its legal source. Pay only for successful requests.
All notable changes to this project are documented here. The format follows Keep a Changelog , and the project uses Semantic Versioning .
GET /v1/pr/municipios: the 78 municipios (code, name, nameAscii, slug), from the US Census Bureau 2020 county FIPS codes.GET /v1/pr/municipios/{id}: one municipio by code, name or slug. Accents and case do not matter.GET /v1/pr/zip/{zip}: municipio(s) of a ZIP code, with the land-area share and the primary one marked, from the 2020 Census ZCTA to County relationship file.GET /v1/pr/ivu: IVU rates citing the Código de Rentas Internas de 2011 (Sec. 4020.01(b), 4210.01(b), 4210.01(c) and 6080.14(a)), with a "not tax advice" note.pr/municipios, pr/municipio, pr/zip, pr/ivu. One api-request event per success, as with every endpoint.scripts/build-pr-data.js rebuilds src/data/pr/ from the Census files.meta.dataset on Puerto Rico toolkit responses, with verificationStatus: "official".{}), no requests or an empty list now runs the default sample (Puerto Rico 2027 holidays and one business-day check) instead of failing with an empty dataset. The input schema has a real default and no required fields. Invalid input still fails, but saves one INVALID_INPUT item first, so the dataset is never empty.summary..actor/): Standby mode serves the same Express app on the port Apify provides (readiness probe answered with a fast 200); a normal run is batch mode over input.requests (up to 1,000 requests, one dataset item each, invalid items return the normal error shape).src/services/billing.js): one api-request event per successful request in both modes; never for errors, /v1/health, /docs or the readiness probe. No-op outside Apify. When the spending limit is reached, Standby returns 402 LIMIT_REACHED and batch mode stops and marks the remaining items..actor/README.md), input schema with a sample input, and Dockerfile on the official Apify Node 24 image (non-root).npm run start:actor and a "Running on Apify" section in the README.openday-api, author JB Studio, new taglines (EN/ES), OpenAPI title, docs page title, and service: "OpenDay API" in /v1/health. Endpoint paths and response shapes are unchanged.src/controllers/endpoints.js) used by both the HTTP API and batch mode.basic-ftp 6.2.1 is pinned through npm overrides (a dependency of the Apify SDK); npm audit reports no vulnerabilities.projected, with a note naming the official year: Alaska, Colorado, District of Columbia, Hawaii, Illinois, Missouri, North Carolina, Pennsylvania and Wyoming. Louisiana years after 2026 are projected (several days are set by yearly proclamation).projected (2027: Monday, December 27).projected.US-DC): all 50 states and DC are now served, each with state (default) and banking calendars, 2026-2100.projected for lists set each year by a governor or executive order (Georgia, Indiana, Kansas, New Mexico, Oklahoma), with a note; GET /v1/regions shows verificationDefault and verificationDefaultNote and a yearsNote for states and DC.halfDay field and category: "unit-specific"; both are listed but do not change business-day math.lastYear.projected; Washington's Birthday moves back to Friday when the day before Christmas is a Sunday (also Indiana).US-XX, ISO 3166-2 style) for the 10 largest states: US-CA, US-TX, US-FL, US-NY, US-PA, US-IL, US-OH, US-GA, US-NC, US-MI. Each has a state calendar (default; state government employees) and a banking calendar (Federal Reserve schedule). State data covers 2026-2100.src/data/states/US-XX.js): per-state weekend policy (previousFriday / nextMonday / notMoved) with per-holiday exceptions, year-specific official overrides, and verification status by year.paidDayOff, category (skeleton-crew, optional, floating) and hours (partial day). These holidays are listed but do not change business-day math.include=legal-only for legal holidays that are not employee days off.meta.verificationStatus (official / computed) and meta.verificationNote on holiday and business-day endpoints.GET /v1/regions: every supported region with calendars, years, sources and verification status by year.country and region are accepted interchangeably on every endpoint.GET /v1/is-business-day: holidays lists every holiday on the date, including ones that do not close offices; reason is holiday only when a listed holiday closes offices.sourceType: "secondary-copy", note "unofficial reproduction of 1 LPRA § 71".meta.references now has a note (or null).GET /v1/is-business-day: the single holiday field is removed. Use holidays (array of every holiday on the date; empty when none). No customers yet, so this is done before launch.sourceType on every holiday: official or secondary-copy. The 2025 Puerto Rico memo (OATRH ME 23-2024) is a secondary-copy, because no official copy is online.meta.sourceType and meta.references (every document behind the calendar) on holiday and business-day endpoints.src/data/sources.js.sourceType: "secondary-copy" and a note with a second report.type labels documented: legal for Puerto Rico legal holidays (on both PR calendars), government for days only Executive Branch employees get.region=PR / country=PR) with three calendars:
government (default): Executive Branch holidays (Ley 26-2017 Art. 2.05 as amended; annual OATRH memo): all legal holidays plus American Citizenship Day, Juneteenth and José Celso Barbosa Day.legal: legal holidays (Código Político Art. 387, 1 LPRA § 71; Ley 88-1969 for Día de la Raza), including Good Friday and General Election Day in election years.banking: Federal Reserve settlement schedule, with a note that branches may also close on local holidays.legal and government: Sunday to the following Monday (Art. 387); Saturday not moved.src/data/prOverrides.js: OATRH ME 23-2024 (2025), ME 12-2026 (full 2027 calendar, 18 days). ME 14-2025 (2026) is recorded as unverified; the affected date carries the note "Pending official confirmation".holidays array in GET /v1/is-business-day listing every holiday on the date.meta.calendarNote on holiday and business-day endpoints.{ year, calendar, holidayId, observedDate, source, sourceUrl, verified }.calendar parameter on all holiday and business-day endpoints:
federal (default): unchanged behavior.banking: Federal Reserve Board holiday schedule. A Saturday holiday is not moved (observedDate is null, with a note); a Sunday holiday is observed Monday.dateBasis parameter on GET /v1/holidays: actual (default) or observed (holidays whose observed date falls in the year).include=inauguration (federal calendar only): Inauguration Day per 5 U.S.C. 6103(c), January 20 of every fourth year after 1965, Sunday moved to Monday, scoped to Washington, DC area federal employees. Counted in business-day math only when included.src/data/closures.js, type closure), applied to holiday lists and business-day math once verified against an official order. The list is empty in this release.scope, sourceUrl and note. Business-day responses include calendar. meta includes calendar and sourceUrl on holiday and business-day endpoints.src/data/federalHolidays.js to src/data/regions/us.js; calculation moved to src/services/calendarEngine.js.observedDate can now be null (banking calendar Saturday holidays; Inauguration Day on a Saturday).isBusinessDay, addBusinessDays (negative values supported), businessDaysBetween, nextBusinessDay, previousBusinessDay.GET /v1/holidays, /v1/is-business-day, /v1/business-days/add, /v1/business-days/between, /v1/health.data / meta) and error (error.code / message / details) response formats, with input validation on every endpoint.ETag and Cache-Control headers on holiday lists, with 304 Not Modified support.openapi.yaml) and interactive docs at /docs.