---
title: "Countdown Calculator"
method: GET
path: "/api/calc/countdown-calculator"
tags: ["DateTime"]
---

# Countdown Calculator

`GET /api/calc/countdown-calculator`

## Request

- Base URL: `https://calcbright.com`
- URL: `https://calcbright.com/api/calc/countdown-calculator`
- Auth: none declared

How many days until Christmas, New Year or your own date? See the days, weeks, months and hours left – or the days since a date that has already passed.

## Query parameters

- `preset` 'christmas' | 'newyear' | 'valentines' | 'july4' | 'halloween' | 'newyearseve' | 'custom': Count down to
- `target` string, date: Target date (YYYY-MM-DD)
- `label` string: Event name (optional)
- `from` string, date: Count from Leave empty to count from today. (YYYY-MM-DD)

## Response `200`

Calculation result

- CalcOutput
  - `ok` boolean
  - `tool` string
  - `name` string
  - `url` string: Open this link to see the full calculation
  - `inputs` object
  - `summary` string: Plain-text answer
  - `details` string
  - `result` object
  - `errors` object

## Other responses

- `400`: Invalid input (see errors)

---

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