Skip to content
Category

Work with holidays, working days, and business-day offsets.

The calendar family returns official fixed and movable holidays plus business-day calculations useful for payroll, invoicing, and delivery scheduling.

Routes

3 GET

Holiday model

Fixed + movable

Core use

Business-day math

Routes in this family

RoutePurposeKey query
/api/v1/calendar/holidaysReturn public holidays for a year.year
/api/v1/calendar/working-daysCount working days between two dates.from, to
/api/v1/calendar/add-working-daysMove a date forward or backward by working days.date, days

GET /api/v1/calendar/holidays

Use holidays to obtain the supported Angola public-holiday schedule for a given year.

ParameterRequiredDescription
yearNoOptional calendar year. Defaults to the current year.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/calendar/holidays?year=2026"
JSON200 response
{  "year": 2026,  "holidays": [    {      "date": "2026-02-16",      "name": "Carnival Holiday",      "localName": "Tolerancia de Ponto de Carnaval",      "category": "movable"    },    {      "date": "2026-02-17",      "name": "Carnival",      "localName": "Carnaval",      "category": "movable"    }  ]}
JSONError response
{  "error": {    "code": "INVALID_YEAR",    "message": "The \"year\" query parameter must be an integer between 2000 and 2100.",    "field": "year",    "value": 1800  }}

GET /api/v1/calendar/working-days

Use working-days to count business days between two dates while excluding weekends and supported Angola holidays.

ParameterRequiredDescription
fromYesStart date in `YYYY-MM-DD` format.
toYesEnd date in `YYYY-MM-DD` format.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/calendar/working-days?from=2026-03-20&to=2026-03-24"
JSON200 response
{  "from": "2026-03-20",  "to": "2026-03-24",  "workingDays": 2,  "excludedWeekendDays": 2,  "excludedHolidayDays": 1}
JSONError response
{  "error": {    "code": "INVALID_DATE_RANGE",    "message": "The \"from\" date must be earlier than or equal to the \"to\" date.",    "from": "2026-03-25",    "to": "2026-03-24"  }}

GET /api/v1/calendar/add-working-days

Use add-working-days to move a base date forward or backward according to the supported working-day calendar.

ParameterRequiredDescription
dateYesBase date in `YYYY-MM-DD` format.
daysYesSigned integer representing the working-day offset.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/calendar/add-working-days?date=2026-03-20&days=1"
JSON200 response
{  "inputDate": "2026-03-20",  "days": 1,  "resultDate": "2026-03-24",  "direction": "forward"}
JSONError response
{  "error": {    "code": "INVALID_INTEGER",    "message": "The \"days\" query parameter must be an integer.",    "field": "days",    "value": "1.5"  }}