---
title: "FREE — add n business days to a date (negative n walks backward)"
method: GET
path: "/v1/business-days/add"
tags: ["Free"]
---

# FREE — add n business days to a date (negative n walks backward)

`GET /v1/business-days/add`

## Request

- Base URL: `https://ausref.dev`
- URL: `https://ausref.dev/v1/business-days/add`
- Auth: none required

Unmetered and unpriced; every country on every brand. The start date is day 0 and is never counted. n = 0 returns the date itself if it is a business day, otherwise the next business day. Returns result_date with every non-business day skipped and why. Refusals are free JSON: 400 for a malformed country, date or n; 404 for an unknown country; 422 year_not_held when a date falls in a year whose holidays we do not hold (the body lists years_held and, where the calendar is moon-sighted or instru...

## Query parameters

- `country` string, required
- `date` string, date, required
- `n` integer, required

## Response `200`

Free. result_date plus the non-business days skipped, weekend rule and calendar provenance.

- object

## Other responses

- `400`: Free. Malformed country, date or n.
- `404`: Free. Unknown country.
- `422`: Free. year_not_held, holiday_date_pending or no_national_calendar — see the body's explanation and what_you_can_do.

---

[API](https://skmtc.dev/ausref/apis/ausref-australasian-government-reference-data.md) · [All operations](https://skmtc.dev/ausref/apis/ausref-australasian-government-reference-data/llms.txt) · [OpenAPI document](https://skmtc.dev/ausref/apis/ausref-australasian-government-reference-data/revisions/002874ef252c?raw)