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.
Endpoint
endpoint
Required
The API endpoint that was called: holidays, is-business-day, business-days/add, business-days/between, regions, pr/municipios, pr/municipio, pr/zip or pr/ivu.
Parameters
params
Required
The parameters sent with the request, the same as the HTTP query parameters.
Success
ok
Required
true when the request succeeded and "data" is filled; false when "error" explains what to fix.
Summary
summary
Required
One-line, human-readable summary of the result or error.
Data
data
Optional
The result, exactly as the HTTP API returns it in "data" (a list of holidays, a business-day answer, a date or a count). Present only when ok is true.
Error
error
Optional
Present when ok is false: { code, message, details }, the same error shape as the HTTP API (for example VALIDATION_ERROR or LIMIT_REACHED).
Source metadata
meta
Optional
Calendar used, legal source and link, source type, verification status (official, computed or projected) and the note "Confirm official proclamations." null for errors.
