List holidays
curl --request GET \
--url https://sandbox.nmbr.co/services/payroll/holidays \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.nmbr.co/services/payroll/holidays"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.nmbr.co/services/payroll/holidays', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/holidays",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.nmbr.co/services/payroll/holidays"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox.nmbr.co/services/payroll/holidays")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.nmbr.co/services/payroll/holidays")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}
}Holidays
List holidays
GET
/
holidays
List holidays
curl --request GET \
--url https://sandbox.nmbr.co/services/payroll/holidays \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.nmbr.co/services/payroll/holidays"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.nmbr.co/services/payroll/holidays', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/holidays",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.nmbr.co/services/payroll/holidays"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox.nmbr.co/services/payroll/holidays")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.nmbr.co/services/payroll/holidays")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Available options:
bank, statutory 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
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
The type of the object in Nmbr ("list").
Hide child attributes
Hide child attributes
The unique identifier of the object in Nmbr.
The type of the object in Nmbr ("holiday").
Hide child attributes
Hide child attributes
Available options:
bank, statutory The translation of the name property for the request locale. Computed using the values in name and name_translations and the value of the request's Accept-Language header.
The date and time the object was created in Nmbr.
The date and time the object was last updated in Nmbr.
⌘I