Calculate

Find the next or previous business day

POST/v1/calculate/date/next/business_day

Skips the weekend (Saturday and Sunday unless you choose other ISO weekday numbers) and the holidays you send. Holidays are sent by the caller: no country calendar is built in. Optionally return the date itself when it is already a business day.

Updated October 27, 2026

Request body

Name	Type	Required	Description
weekend	array of integer	no	ISO weekday numbers that are not business days: 1 is Monday, 7 is Sunday. Default Saturday and Sunday
holidays	array of string	no	ISO dates that are not business days. Holidays are sent by the caller: no country calendar is built in
date	string	yes	An ISO date or ISO date and time
direction	one of: next, previous	no	next or previous (default `"next"`)
include_start	boolean	no	True returns the date itself when it is a business day (default `false`)

Example request

A request body that works, as JSON.

{
  "date": "2026-04-04",
  "holidays": [
    "2026-04-06"
  ]
}

Code samples

Replace YOUR_TOKEN with your access token.

curl

curl -X POST 'https://api.skillfulsardine.com/v1/calculate/date/next/business_day' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "date": "2026-04-04",
  "holidays": [
    "2026-04-06"
  ]
}'

PowerShell

$body = @'
{
  "date": "2026-04-04",
  "holidays": [
    "2026-04-06"
  ]
}
'@
$response = Invoke-RestMethod -Method Post -Uri 'https://api.skillfulsardine.com/v1/calculate/date/next/business_day' `
  -Headers @{ Authorization = 'Bearer YOUR_TOKEN' } `
  -ContentType 'application/json; charset=utf-8' `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))
$response | ConvertTo-Json -Depth 10

Python

import requests

payload = {
    "date": "2026-04-04",
    "holidays": [
        "2026-04-06",
    ],
}

response = requests.post(
    "https://api.skillfulsardine.com/v1/calculate/date/next/business_day",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json=payload,
    timeout=30,
)
print(response.json())

JavaScript

const response = await fetch("https://api.skillfulsardine.com/v1/calculate/date/next/business_day", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "date": "2026-04-04",
  "holidays": [
    "2026-04-06"
  ]
}),
});
const result = await response.json();
console.log(result);

Node

// Node 18 or later. Save as call.mjs and run: API_TOKEN=... node call.mjs
const token = process.env.API_TOKEN;

const response = await fetch("https://api.skillfulsardine.com/v1/calculate/date/next/business_day", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "date": "2026-04-04",
  "holidays": [
    "2026-04-06"
  ]
}),
});
const result = await response.json();
console.log(result);

Rust

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
fn main() -> Result<(), Box<dyn std::error::Error>> {
    let body: serde_json::Value = serde_json::from_str(r#"{
  "date": "2026-04-04",
  "holidays": [
    "2026-04-06"
  ]
}"#)?;
    let response = reqwest::blocking::Client::new()
        .post("https://api.skillfulsardine.com/v1/calculate/date/next/business_day")
        .bearer_auth("YOUR_TOKEN")
        .json(&body)
        .send()?;
    println!("{}", response.text()?);
    Ok(())
}

Swift

import Foundation

var request = URLRequest(url: URL(string: "https://api.skillfulsardine.com/v1/calculate/date/next/business_day")!)
request.httpMethod = "POST"
request.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = Data(#"""
{
  "date": "2026-04-04",
  "holidays": [
    "2026-04-06"
  ]
}
"""#.utf8)

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))

Response

The fields inside data of a successful response.

Name	Type	Required	Description
date	string	yes	The business day, as an ISO date
weekday	string	yes	Its weekday name in English
skipped_days	integer	yes	Weekend days and holidays passed over to reach it

Example response

A real answer from the operation, as JSON. The fields in the table above are inside data.

{
  "data": {
    "date": "2026-04-07",
    "weekday": "Tuesday",
    "skipped_days": 2
  },
  "errors": null,
  "meta": {
    "request_id": "434dbf0b-eba2-4c67-a99b-cccb19dc2d29",
    "timestamp": "2026-10-27T07:19:42.094239Z",
    "version": "2026-03-26"
  },
  "pagination": null
}

Responses

Status	When it happens
200	Successful Response
400	The body respects the operation schema, but the use case rejected it. Each problem is one ApiError entry
413	The request is larger than the request size limit of the API allows
422	The body does not respect the operation schema. Each problem is one ApiError entry with the code validation_error
500	Something failed inside the server and was not an input problem. The same envelope, errors may be empty