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

# Ramadan Countdown

`GET /api/calc/ramadan-countdown-calculator`

## Request

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

How many days until Ramadan, Eid al-Fitr and Eid al-Adha? Live countdown using the official Umm al-Qura calendar used in Saudi Arabia, UAE and the GCC.

## Query parameters

- `event` 'ramadan' | 'fitr' | 'arafah' | 'adha' | 'newyear' | 'mawlid': Count down to
- `from` string, date: From date 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)