# Date Difference Calculator — REST API endpoint `date-diff`

Calculate the difference between two dates in various units.

- Category: datetime
- REST endpoint: POST https://api.findutils.com/api/tools/date-diff/execute (no API keys, 60 req/min per IP)
- MCP: not exposed on the MCP server. See https://findutils.com/mcp/ for the tools that are.
- Reference page: https://findutils.com/api/date-diff/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/date-diff/execute \
  -H "Content-Type: application/json" \
  -d '{
    "from": "2024-01-01",
    "to": "2024-12-31"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/date-diff
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `from` | string | yes | Start date (ISO 8601 or any parseable date string). |
| `to` | string | no | End date (ISO 8601 or any parseable date string). Defaults to now if omitted. |

Example arguments (verified):

```json
{
  "from": "2024-01-01",
  "to": "2024-12-31"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt