---
title: "Date Calculator"
method: POST
path: "/api/v1/tools/date-calculator"
tags: ["tools"]
---

# Date Calculator

`POST /api/v1/tools/date-calculator`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/date-calculator`
- Auth: HTTP bearer

Add or subtract days, weeks, months or years from a date and get the date you land on, written out with its weekday. The arithmetic is calendar aware and runs in UTC, so leap years and month lengths are handled and the answer never shifts with a time zone.

## Request body

- object
  - `amount` integer
  - `unit` string
  - `operation` string
  - `startDate` string

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `startDate` string
    - `startWeekday` string
    - `operation` string
    - `amount` integer
    - `unit` string
    - `resultDate` string
    - `weekday` string
    - `formatted` string
    - `daysDifference` integer

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)