Work Anniversary Calculator API

POST https://api.findutils.com/api/tools/work-anniversary-calculator/execute

Calculate job tenure between a start date and a target date: years/months/days, totals in days, weeks, months, and hours, approximate working days (5 of 7) and working hours (8 per working day), the weekday the job started, the next work anniversary, and passed/upcoming milestones (1 month to 10 years).

Open the tool Try it

Request body

application/json

start_date

string required

First day at the job (YYYY-MM-DD).
target_date

string optional

Date to measure against (YYYY-MM-DD). Default: today (UTC).

Example arguments

Verified

{
  "start_date": "2023-09-01",
  "target_date": "2026-04-18"
}

curl -X POST https://api.findutils.com/api/tools/work-anniversary-calculator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "start_date": "2023-09-01",
    "target_date": "2026-04-18"
  }'

const response = await fetch('https://api.findutils.com/api/tools/work-anniversary-calculator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"start_date":"2023-09-01","target_date":"2026-04-18"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/work-anniversary-calculator/execute",
    json={"start_date":"2023-09-01","target_date":"2026-04-18"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/work-anniversary-calculator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"start_date":"2023-09-01","target_date":"2026-04-18"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call work_anniversary_calculator from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: work-anniversary-calculator
MCP name: work_anniversary_calculator
Category: Date & time
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Date & time tools

More to explore