Skip to main content
GET
/
holidays
List holidays
curl --request GET \
  --url https://sandbox.nmbr.co/services/payroll/holidays \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "New Year’s Day",
        "name_translations": {
          "en": "New Year’s Day",
          "fr": "Jour de l’An"
        },
        "name_translated": "New Year’s Day",
        "original_date": "2026-01-01",
        "observed_date": "2026-01-01",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEGK81SZFSPPTK2E6NJ"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Good Friday",
        "name_translations": {
          "en": "Good Friday",
          "fr": "Vendredi Saint"
        },
        "name_translated": "Good Friday",
        "original_date": "2026-04-03",
        "observed_date": "2026-04-03",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEGK81SZFSPPTK2E6NK"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Victoria Day",
        "name_translations": {
          "en": "Victoria Day",
          "fr": "Fête de la Reine"
        },
        "name_translated": "Victoria Day",
        "original_date": "2026-05-18",
        "observed_date": "2026-05-18",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEHE4F2KATNW7KFPKXM"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Canada Day",
        "name_translations": {
          "en": "Canada Day",
          "fr": "Fête du Canada"
        },
        "name_translated": "Canada Day",
        "original_date": "2026-07-01",
        "observed_date": "2026-07-01",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEHE4F2KATNW7KFPKXN"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Labour Day",
        "name_translations": {
          "en": "Labour Day",
          "fr": "Fête du Travail"
        },
        "name_translated": "Labour Day",
        "original_date": "2026-09-07",
        "observed_date": "2026-09-07",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEJGPAV5WXDB5V60TWE"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Truth and Reconciliation Day",
        "name_translations": {
          "en": "Truth and Reconciliation Day",
          "fr": "Journée Vérité et Réconciliation"
        },
        "name_translated": "Truth and Reconciliation Day",
        "original_date": "2026-09-30",
        "observed_date": "2026-09-30",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEJGPAV5WXDB5V60TWF"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Thanksgiving Day",
        "name_translations": {
          "en": "Thanksgiving Day",
          "fr": "Action de Grâce"
        },
        "name_translated": "Thanksgiving Day",
        "original_date": "2026-10-12",
        "observed_date": "2026-10-12",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEKG3Z5667MXBZ6J862"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Remembrance Day",
        "name_translations": {
          "en": "Remembrance Day",
          "fr": "Jour du Souvenir"
        },
        "name_translated": "Remembrance Day",
        "original_date": "2026-11-11",
        "observed_date": "2026-11-11",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEKG3Z5667MXBZ6J863"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Christmas Day",
        "name_translations": {
          "en": "Christmas Day",
          "fr": "Noël"
        },
        "name_translated": "Christmas Day",
        "original_date": "2026-12-25",
        "observed_date": "2026-12-25",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEMWDP03PKZSR0HZ91X"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_federal",
        "type": "bank",
        "name": "Boxing Day",
        "name_translations": {
          "en": "Boxing Day",
          "fr": "Lendemain de Noël"
        },
        "name_translated": "Boxing Day",
        "original_date": "2026-12-26",
        "observed_date": "2026-12-28",
        "created_at": "2023-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/holidays/01J96T4XEMWDP03PKZSR0HZ91Y"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_ab",
        "type": "statutory",
        "name": "New Year’s Day",
        "name_translations": {
          "en": "New Year’s Day",
          "fr": "Jour de l’An"
        },
        "name_translated": "New Year’s Day",
        "original_date": "2026-01-01",
        "observed_date": "2026-01-01",
        "created_at": "2026-01-26T20:16:32.000000Z",
        "updated_at": "2026-01-26T20:16:32.000000Z"
      },
      "links": {
        "self": "/holidays/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_bc",
        "type": "statutory",
        "name": "New Year’s Day",
        "name_translations": {
          "en": "New Year’s Day",
          "fr": "Jour de l’An"
        },
        "name_translated": "New Year’s Day",
        "original_date": "2026-01-01",
        "observed_date": "2026-01-01",
        "created_at": "2026-01-26T20:16:32.000000Z",
        "updated_at": "2026-01-26T20:16:32.000000Z"
      },
      "links": {
        "self": "/holidays/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_mb",
        "type": "statutory",
        "name": "New Year’s Day",
        "name_translations": {
          "en": "New Year’s Day",
          "fr": "Jour de l’An"
        },
        "name_translated": "New Year’s Day",
        "original_date": "2026-01-01",
        "observed_date": "2026-01-01",
        "created_at": "2026-01-26T20:16:32.000000Z",
        "updated_at": "2026-01-26T20:16:32.000000Z"
      },
      "links": {
        "self": "/holidays/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_nb",
        "type": "statutory",
        "name": "New Year’s Day",
        "name_translations": {
          "en": "New Year’s Day",
          "fr": "Jour de l’An"
        },
        "name_translated": "New Year’s Day",
        "original_date": "2026-01-01",
        "observed_date": "2026-01-01",
        "created_at": "2026-01-26T20:16:32.000000Z",
        "updated_at": "2026-01-26T20:16:32.000000Z"
      },
      "links": {
        "self": "/holidays/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "holiday",
      "data": {
        "jurisdiction": "ca_nl",
        "type": "statutory",
        "name": "New Year’s Day",
        "name_translations": {
          "en": "New Year’s Day",
          "fr": "Jour de l’An"
        },
        "name_translated": "New Year’s Day",
        "original_date": "2026-01-01",
        "observed_date": "2026-01-01",
        "created_at": "2026-01-26T20:16:32.000000Z",
        "updated_at": "2026-01-26T20:16:32.000000Z"
      },
      "links": {
        "self": "/holidays/<id>"
      }
    }
  ],
  "links": {
    "first": "/holidays?jurisdiction=ca&observed_date%5Bgte%5D=2026-01-01&observed_date%5Blte%5D=2026-12-31&page=1",
    "last": "/holidays?jurisdiction=ca&observed_date%5Bgte%5D=2026-01-01&observed_date%5Blte%5D=2026-12-31&page=9",
    "prev": null,
    "next": "/holidays?jurisdiction=ca&observed_date%5Bgte%5D=2026-01-01&observed_date%5Blte%5D=2026-12-31&page=2"
  },
  "meta": {
    "current_page": 1,
    "last_page": 9,
    "per_page": 15,
    "total": 135,
    "has_more": true
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

jurisdiction
string
type
enum<string>
Available options:
bank,
statutory
original_date
object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: original_date=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

  • gt (greater than)
  • gte (greater than or equal to)
  • lte (less than or equal to)
  • lt (less than) Example: original_date[gte]=2024-01-01&original_date[lt]=2024-12-31
observed_date
object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: observed_date=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

  • gt (greater than)
  • gte (greater than or equal to)
  • lte (less than or equal to)
  • lt (less than) Example: observed_date[gte]=2024-01-01&observed_date[lt]=2024-12-31

Response

200 - application/json

OK

object
string
read-only

The type of the object in Nmbr ("list").

data
object[]