Vince Live provides a few API endpoints that will help in developing workflows.

Holidays

Used to get holidays and other dates of interest for a specific country, state and year.

Util is based on date-holidays NPM package

Get holidays

Available input properties

Property Mandatory Default Type Comment
country Yes N/A query parameter Country code
state No N/A query parameter State or province
year No Current year query parameter Calendar year

Example request

GET /v1/utils/holidays?country=no

// response
{
    "count": 24,
    "items": [
        {
            "date": "2023-01-01 00:00:00",
            "start": "2022-12-31T23:00:00.000Z",
            "end": "2023-01-01T23:00:00.000Z",
            "name": "Første nyttårsdag",
            "type": "public",
            "rule": "01-01"
        },
        {
            "date": "2023-02-12 00:00:00",
            "start": "2023-02-11T23:00:00.000Z",
            "end": "2023-02-12T23:00:00.000Z",
            "name": "Morsdag",
            "type": "observance",
            "rule": "2nd sunday in February"
        },
				...
}