← API network TIME / CALENDAR / CONVERSION / LOCALIZATION

Direct Platform 0.0.2 / General Availability api.dakidarts.comDirect gateway

Ethiopian Calendar API

Ethiopian ↔ Gregorian date conversion, month calendars, leap-year checks and multilingual date context, holiday data, year/range conversion and Ethiopian sunrise-clock utilities.

Preview examples View on RapidAPI OpenAPI 3.1 ↗ GitHub repository ↗ Release feed ↗

Direct PlatformET

api.dakidarts.com0.0.2General Availability25ms p9537 documented endpoints

DIRECT NATIVE API

Call Ethiopian Calendar API through the Dakidarts gateway.

0 of 37 endpoints have an upstream URL configured. Other routes return 503 before billing; only send live requests to configured routes. The gateway injects upstream credentials for you.

Live checkout opens after an API route has an upstream URL. Preview examples are available below.

Base URLhttps://api.dakidarts.com/ethiopian-calendar

AuthenticationX-API-Key: dk_live_...

Default reference pathGET /to-gregorian

Commercial modelPay-as-you-go / $0.0050 per call

01 / ACCESS

One key, one gateway

Use a Dakidarts API key with read or write scopes and control which APIs that key can reach.

02 / BILLING

Metered by the call

Wallet credits, plan quotas and organization invoices are settled per request with transparent response headers.

03 / RELIABILITY

Observable by default

Latency, upstream status and execution mode are logged so integration issues are visible before they spread.

RAPIDAPI SPOTLIGHTRapidAPI Marketplace

Also available through RapidAPI.

Keep the direct Dakidarts gateway as your primary route, or use the RapidAPI listing when marketplace billing and key management fit your stack better.

View on RapidAPI Plans, keys and usage stay inside RapidAPI.

CAPABILITIES

Built to disappear into the product.

The best API is the one your team can integrate, observe and then stop thinking about.

Full Ethiopian and Gregorian month/year views

Designed as a composable building block for product teams, internal tooling and automation.

Batch conversion and date-difference workflows

Designed as a composable building block for product teams, internal tooling and automation.

Month and weekday names in English, Ge’ez/Amharic, Oromo and Tigrinya

Designed as a composable building block for product teams, internal tooling and automation.

PLATFORM FACTS

The shape of the surface.

Selected facts about coverage, delivery and production readiness.

0113-month Ethiopian calendar with leap-aware Pagumen

02Date, month, year and range conversion utilities

03Holiday, countdown, time and multilingual name endpoints

FAQ

Answers before you integrate.

Access, billing and integration details for Ethiopian Calendar API.

What conversions are supported? +

Ethiopian and Gregorian date conversion plus calendar utilities.

Is localized output available? +

Yes. Locale-aware calendar labels are supported where the endpoint provides them.

Can I use it for scheduling? +

Yes. It is designed for Ethiopian-calendar dates in apps, content and scheduling flows.

How do I get access? +

Subscribe on the Dakidarts dashboard, then call the gateway with an API key.

Does it handle time zones? +

Calendar conversion is separate from time-zone conversion; check the endpoint details for the exact behavior.

SUBSCRIPTION PLANS

Choose a quota that matches the workload.

Plans are shown for reference. Live checkout opens after an API route has an upstream URL.

WALLET-ACCESS

Pay-as-you-go access

$0.00 / month

Wallet credits per call
$0.0050 / call overage
120 req/min

INTEGRATION PATH

From first request to production.

Start with a Dakidarts key, call the gateway, then monitor usage from the dashboard.

Create a Dakidarts key

Choose the API scope, then copy the key into your server environment.

Call the gateway

Send requests to https://api.dakidarts.com/ethiopian-calendar with your key and JSON body.

Watch usage

Track calls, latency and spend from the API dashboard and wallet.

ENDPOINT REFERENCE

Endpoint reference & metered costs.

These routes include contracts imported from the product implementation. 0 of 37 endpoints have an upstream URL configured. Other routes return 503 before billing; saved examples are previews only. Configure an upstream URL in API Studio to enable those routes.

GROUP / 01

Operations

Operations endpoints sourced from the Ethiopian Calendar API implementation.

3 endpoints

GET /status Status SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Check API status, version, uptime, and list all available endpoints.

1. `/status` — Service Status

Check API status, version, uptime, and list all available endpoints.

Method: GET

Parameters: None

GET https://ethiopian-calendar-api.p.rapidapi.com/status

{
  "status": "success",
  "status_text": "API is online",
  "version": "0.0.2",
  "uptime_seconds": 86400,
  "documentation": "https://github.com/dakidarts/ethiopian-calendar-api",
  "endpoints": ["/to-gregorian", "/to-ethiopian", "/current-date", "..."]
}

Source contract imported from ethiopian calendar/app.py. Handler: status. Reference: RAPID_README.md.

QUICK CURL

curl -X GET https://api.dakidarts.com/ethiopian-calendar/status -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /status Status SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Check API status, version, uptime, and list all available endpoints.

1. `/status` — Service Status

Check API status, version, uptime, and list all available endpoints.

Method: GET

Parameters: None

GET https://ethiopian-calendar-api.p.rapidapi.com/status

{
  "status": "success",
  "status_text": "API is online",
  "version": "0.0.2",
  "uptime_seconds": 86400,
  "documentation": "https://github.com/dakidarts/ethiopian-calendar-api",
  "endpoints": ["/to-gregorian", "/to-ethiopian", "/current-date", "..."]
}

Source contract imported from ethiopian calendar/app.py. Handler: status. Reference: RAPID_README.md.

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/status -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

GET /health Health SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Health check with uptime, memory (max RSS kB), translation-cache size and a UTC timestamp. Returns HTTP 200 with `"status_text": "healthy"` when the process is alive. Suitable for load balancer / uptime checks.

`GET /health`

Health check with uptime, memory (max RSS kB), translation-cache size and a UTC timestamp. Returns HTTP 200 with "status_text": "healthy" when the process is alive. Suitable for load balancer / uptime checks.

Source contract imported from ethiopian calendar/app.py. Handler: health. Reference: docs/api-reference.md.

QUICK CURL

curl -X GET https://api.dakidarts.com/ethiopian-calendar/health -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

GROUP / 02

About

About endpoints sourced from the Ethiopian Calendar API implementation.

1 endpoint

GET /about About SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Human-readable description, version, API author and the list of user-facing endpoints.

`GET /about`

Human-readable description, version, API author and the list of user-facing endpoints.

Source contract imported from ethiopian calendar/app.py. Handler: about. Reference: docs/api-reference.md.

QUICK CURL

curl -X GET https://api.dakidarts.com/ethiopian-calendar/about -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

GROUP / 03

To Gregorian

To Gregorian endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /to-gregorian To Gregorian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Convert an Ethiopian date to its Gregorian (Western) equivalent. The Ethiopian calendar has 13 months — month 13 (Pagumen) has 5 days or 6 in leap years.

2. `/to-gregorian` — Ethiopian → Gregorian

Convert an Ethiopian date to its Gregorian (Western) equivalent. The Ethiopian calendar has 13 months — month 13 (Pagumen) has 5 days or 6 in leap years.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Ethiopian year	`2016`
`month`	int	Yes	Ethiopian month (1–13)	`1`
`day`	int	Yes	Ethiopian day (1–30; 1–6 for Pagumen)	`1`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/to-gregorian?year=2016&month=1&day=1

{
  "status": "success",
  "input": {"year": 2016, "month": 1, "day": 1},
  "gregorian_date": "2023-09-12",
  "gregorian": {"year": 2023, "month": 9, "day": 12},
  "day_of_week": "Tuesday",
  "weekday": 1,
  "month_name": "Meskerem",
  "is_ec_leap_year": false
}

Source contract imported from ethiopian calendar/app.py. Handler: to_gregorian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	Yes	Ethiopian year
`month`	query	integer	Yes	Ethiopian month (1–13)
`day`	query	integer	Yes	Ethiopian day (1–30; 1–6 for Pagumen)
`lang`	query	string	No	Language code (default: `en`)

SAMPLE RESPONSE

{
  "input": {
    "day": 1,
    "year": 2016,
    "month": 1
  },
  "status": "success",
  "weekday": 1,
  "gregorian": {
    "day": 12,
    "year": 2023,
    "month": 9
  },
  "month_name": "Meskerem",
  "day_of_week": "Tuesday",
  "gregorian_date": "2023-09-12",
  "is_ec_leap_year": false
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/to-gregorian?year=2016&month=1&day=1&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /to-gregorian To Gregorian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Convert an Ethiopian date to its Gregorian (Western) equivalent. The Ethiopian calendar has 13 months — month 13 (Pagumen) has 5 days or 6 in leap years.

2. `/to-gregorian` — Ethiopian → Gregorian

Convert an Ethiopian date to its Gregorian (Western) equivalent. The Ethiopian calendar has 13 months — month 13 (Pagumen) has 5 days or 6 in leap years.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Ethiopian year	`2016`
`month`	int	Yes	Ethiopian month (1–13)	`1`
`day`	int	Yes	Ethiopian day (1–30; 1–6 for Pagumen)	`1`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/to-gregorian?year=2016&month=1&day=1

{
  "status": "success",
  "input": {"year": 2016, "month": 1, "day": 1},
  "gregorian_date": "2023-09-12",
  "gregorian": {"year": 2023, "month": 9, "day": 12},
  "day_of_week": "Tuesday",
  "weekday": 1,
  "month_name": "Meskerem",
  "is_ec_leap_year": false
}

Source contract imported from ethiopian calendar/app.py. Handler: to_gregorian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	body	integer	Yes	Ethiopian year
`month`	body	integer	Yes	Ethiopian month (1–13)
`day`	body	integer	Yes	Ethiopian day (1–30; 1–6 for Pagumen)
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/to-gregorian -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"year": 2016, "month": 1, "day": 1, "lang": "am"}'

GROUP / 04

To Ethiopian

To Ethiopian endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /to-ethiopian To Ethiopian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Convert a Gregorian (Western) date to its Ethiopian calendar equivalent. Returns the Ethiopian year, month (1–13), day, and translated month name.

3. `/to-ethiopian` — Gregorian → Ethiopian

Convert a Gregorian (Western) date to its Ethiopian calendar equivalent. Returns the Ethiopian year, month (1–13), day, and translated month name.

Methods: GET, POST

Param	Type	Required	Description	Example
`date`	string	Yes	Gregorian date (YYYY-MM-DD)	`2024-09-11`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/to-ethiopian?date=2024-09-11

{
  "status": "success",
  "input": "2024-09-11",
  "ethiopian_date": {
    "year": 2017,
    "month": 1,
    "day": 1,
    "month_name": "Meskerem"
  },
  "day_of_week": "Wednesday",
  "weekday": 2,
  "is_ec_leap_year": false,
  "days_in_ethiopian_month": 30
}

Source contract imported from ethiopian calendar/app.py. Handler: to_ethiopian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date`	query	string	Yes	Gregorian date (YYYY-MM-DD)
`lang`	query	string	No	Language code (default: `en`)

SAMPLE RESPONSE

{
  "input": "2024-09-11",
  "status": "success",
  "weekday": 2,
  "day_of_week": "Wednesday",
  "ethiopian_date": {
    "day": 1,
    "year": 2017,
    "month": 1,
    "month_name": "Meskerem"
  },
  "is_ec_leap_year": false,
  "days_in_ethiopian_month": 30
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/to-ethiopian?date=2024-09-11&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /to-ethiopian To Ethiopian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Convert a Gregorian (Western) date to its Ethiopian calendar equivalent. Returns the Ethiopian year, month (1–13), day, and translated month name.

3. `/to-ethiopian` — Gregorian → Ethiopian

Convert a Gregorian (Western) date to its Ethiopian calendar equivalent. Returns the Ethiopian year, month (1–13), day, and translated month name.

Methods: GET, POST

Param	Type	Required	Description	Example
`date`	string	Yes	Gregorian date (YYYY-MM-DD)	`2024-09-11`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/to-ethiopian?date=2024-09-11

{
  "status": "success",
  "input": "2024-09-11",
  "ethiopian_date": {
    "year": 2017,
    "month": 1,
    "day": 1,
    "month_name": "Meskerem"
  },
  "day_of_week": "Wednesday",
  "weekday": 2,
  "is_ec_leap_year": false,
  "days_in_ethiopian_month": 30
}

Source contract imported from ethiopian calendar/app.py. Handler: to_ethiopian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date`	body	string	Yes	Gregorian date (YYYY-MM-DD)
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/to-ethiopian -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"date": "2024-09-11", "lang": "am"}'

GROUP / 05

Current Date

Current Date endpoints sourced from the Ethiopian Calendar API implementation.

1 endpoint

GET /current-date Current Date SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Get today's date in both Ethiopian and Gregorian calendars at the same time, including weekday and leap-year status.

6. `/current-date` — Today in Both Calendars

Get today's date in both Ethiopian and Gregorian calendars at the same time, including weekday and leap-year status.

Method: GET

Param	Type	Required	Description	Example
`tz`	string	No	IANA timezone (default: UTC)	`Africa/Addis_Ababa`
`lang`	string	No	Language code (default: `en`)	`am`
`now`	string	No	Override "today" (YYYY-MM-DD)	`2024-01-01`

GET https://ethiopian-calendar-api.p.rapidapi.com/current-date?tz=Africa/Addis_Ababa

{
  "status": "success",
  "gregorian_today": "2024-01-01",
  "gregorian": {"year": 2024, "month": 1, "day": 1},
  "ethiopian_today": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"},
  "day_of_week": "Monday",
  "weekday": 0,
  "is_ec_leap_year": false,
  "time_zone": "Africa/Addis_Ababa"
}

Source contract imported from ethiopian calendar/app.py. Handler: current_date. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`tz`	query	string	No	IANA timezone (default: UTC)
`lang`	query	string	No	Language code (default: `en`)
`now`	query	string	No	Override "today" (YYYY-MM-DD)

SAMPLE RESPONSE

{
  "status": "success",
  "weekday": 0,
  "gregorian": {
    "day": 1,
    "year": 2024,
    "month": 1
  },
  "time_zone": "Africa/Addis_Ababa",
  "day_of_week": "Monday",
  "ethiopian_today": {
    "day": 22,
    "year": 2016,
    "month": 4,
    "month_name": "Tahsas"
  },
  "gregorian_today": "2024-01-01",
  "is_ec_leap_year": false
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/current-date?tz=Africa%2FAddis_Ababa&lang=am&now=2024-01-01' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

GROUP / 06

Is Leap Year

Is Leap Year endpoints sourced from the Ethiopian Calendar API implementation.

1 endpoint

GET /is-leap-year Is Leap Year SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Check whether an Ethiopian year is a leap year. Ethiopian leap years end in 3 (e.g. 2011, 2015, 2019, 2023) and have a 6-day Pagumen.

7. `/is-leap-year` — Leap Year Check

Check whether an Ethiopian year is a leap year. Ethiopian leap years end in 3 (e.g. 2011, 2015, 2019, 2023) and have a 6-day Pagumen.

Method: GET

Param	Type	Required	Description	Example
`year`	int	Yes	Ethiopian year to check	`2015`

GET https://ethiopian-calendar-api.p.rapidapi.com/is-leap-year?year=2015

{
  "status": "success",
  "year": 2015,
  "is_leap": true,
  "next_leap_year": 2019,
  "previous_leap_year": 2011,
  "explanation": "Ethiopian leap years occur every 4 years and have a 6-day 13th month (Pagumen). 2011, 2015, 2019, 2023 are leap years."
}

Source contract imported from ethiopian calendar/app.py. Handler: is_leap_year. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	Yes	Ethiopian year to check

SAMPLE RESPONSE

{
  "year": 2015,
  "status": "success",
  "is_leap": true,
  "explanation": "Ethiopian leap years occur every 4 years and have a 6-day 13th month (Pagumen). 2011, 2015, 2019, 2023 are leap years.",
  "next_leap_year": 2019,
  "previous_leap_year": 2011
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/is-leap-year?year=2015' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

GROUP / 07

Calendar Info

Calendar Info endpoints sourced from the Ethiopian Calendar API implementation.

1 endpoint

GET /calendar-info Calendar Info SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

General information about the Ethiopian calendar: current EC year, months, days per year, leap status, and the Gregorian date of Enkutatash (New Year).

8. `/calendar-info` — Calendar Overview

General information about the Ethiopian calendar: current EC year, months, days per year, leap status, and the Gregorian date of Enkutatash (New Year).

Method: GET

Param	Type	Required	Description	Example
`tz`	string	No	IANA timezone (default: UTC)	`Africa/Addis_Ababa`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/calendar-info

{
  "status": "success",
  "year": 2017,
  "months": [
    {"number": 1, "name": "Meskerem", "days": 30},
    {"number": 2, "name": "Tikimt", "days": 30},
    "...",
    {"number": 13, "name": "Pagumen", "days": 5}
  ],
  "is_leap": false,
  "days_in_year": 365,
  "new_year": {
    "ethiopian": {"year": 2017, "month": 1, "day": 1},
    "gregorian_date": "2024-09-11"
  },
  "epoch": "The Ethiopian calendar runs 7 years behind the Gregorian calendar from September to December and 8 years behind from January to August.",
  "description": "The Ethiopian calendar has 13 months, with the 13th month (Pagumen) having 5 or 6 days."
}

Source contract imported from ethiopian calendar/app.py. Handler: calendar_info. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`tz`	query	string	No	IANA timezone (default: UTC)
`lang`	query	string	No	Language code (default: `en`)

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/calendar-info?tz=Africa%2FAddis_Ababa&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

GROUP / 08

Full Month

Full Month endpoints sourced from the Ethiopian Calendar API implementation.

4 endpoints

GET /full-month Full Month SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Ethiopian calendar month: lists every day with its corresponding Gregorian date and weekday. Pagumen (month 13) has 5 or 6 days depending on leap year.

9. `/full-month` — Ethiopian Month View

Full Ethiopian calendar month: lists every day with its corresponding Gregorian date and weekday. Pagumen (month 13) has 5 or 6 days depending on leap year.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Ethiopian year	`2016`
`month`	int	Yes	Ethiopian month (1–13, where 13 = Pagumen)	`13`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/full-month?year=2016&month=13

{
  "status": "success",
  "ethiopian_year": 2016,
  "ethiopian_month": 13,
  "month_name": "Pagumen",
  "days_in_month": 5,
  "is_leap_year": false,
  "first_day_of_week": "Friday",
  "last_gregorian_date": "2023-09-10",
  "days": [
    {"ethiopian_day": 1, "gregorian_date": "2023-09-06", "day_of_week": "Wednesday"},
    {"ethiopian_day": 2, "gregorian_date": "2023-09-07", "day_of_week": "Thursday"},
    {"ethiopian_day": 3, "gregorian_date": "2023-09-08", "day_of_week": "Friday"},
    {"ethiopian_day": 4, "gregorian_date": "2023-09-09", "day_of_week": "Saturday"},
    {"ethiopian_day": 5, "gregorian_date": "2023-09-10", "day_of_week": "Sunday"}
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: full_month. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	Yes	Ethiopian year
`month`	query	integer	Yes	Ethiopian month (1–13, where 13 = Pagumen)
`lang`	query	string	No	Language code (default: `en`)

SAMPLE RESPONSE

{
  "days": [
    {
      "day_of_week": "Wednesday",
      "ethiopian_day": 1,
      "gregorian_date": "2023-09-06"
    },
    {
      "day_of_week": "Thursday",
      "ethiopian_day": 2,
      "gregorian_date": "2023-09-07"
    },
    {
      "day_of_week": "Friday",
      "ethiopian_day": 3,
      "gregorian_date": "2023-09-08"
    },
    {
      "day_of_week": "Saturday",
      "ethiopian_day": 4,
      "gregorian_date": "2023-09-09"
    },
    {
      "day_of_week": "Sunday",
      "ethiopian_day": 5,
      "gregorian_date": "2023-09-10"
    }
  ],
  "status": "success",
  "month_name": "Pagumen",
  "is_leap_year": false,
  "days_in_month": 5,
  "ethiopian_year": 2016,
  "ethiopian_month": 13,
  "first_day_of_week": "Friday",
  "last_gregorian_date": "2023-09-10"
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/full-month?year=2016&month=13&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /full-month Full Month SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Ethiopian calendar month: lists every day with its corresponding Gregorian date and weekday. Pagumen (month 13) has 5 or 6 days depending on leap year.

9. `/full-month` — Ethiopian Month View

Full Ethiopian calendar month: lists every day with its corresponding Gregorian date and weekday. Pagumen (month 13) has 5 or 6 days depending on leap year.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Ethiopian year	`2016`
`month`	int	Yes	Ethiopian month (1–13, where 13 = Pagumen)	`13`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/full-month?year=2016&month=13

{
  "status": "success",
  "ethiopian_year": 2016,
  "ethiopian_month": 13,
  "month_name": "Pagumen",
  "days_in_month": 5,
  "is_leap_year": false,
  "first_day_of_week": "Friday",
  "last_gregorian_date": "2023-09-10",
  "days": [
    {"ethiopian_day": 1, "gregorian_date": "2023-09-06", "day_of_week": "Wednesday"},
    {"ethiopian_day": 2, "gregorian_date": "2023-09-07", "day_of_week": "Thursday"},
    {"ethiopian_day": 3, "gregorian_date": "2023-09-08", "day_of_week": "Friday"},
    {"ethiopian_day": 4, "gregorian_date": "2023-09-09", "day_of_week": "Saturday"},
    {"ethiopian_day": 5, "gregorian_date": "2023-09-10", "day_of_week": "Sunday"}
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: full_month. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	body	integer	Yes	Ethiopian year
`month`	body	integer	Yes	Ethiopian month (1–13, where 13 = Pagumen)
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/full-month -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"year": 2016, "month": 13, "lang": "am"}'

GET /full-month/gregorian Full Month Gregorian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Gregorian calendar month: lists every day with its corresponding Ethiopian date and weekday.

10. `/full-month/gregorian` — Gregorian Month View

Full Gregorian calendar month: lists every day with its corresponding Ethiopian date and weekday.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Gregorian year	`2024`
`month`	int	Yes	Gregorian month (1–12)	`2`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/full-month/gregorian?year=2024&month=2

{
  "status": "success",
  "gregorian_year": 2024,
  "gregorian_month": 2,
  "month_name": "February",
  "days_in_month": 29,
  "is_gc_leap_year": true,
  "first_day_of_week": "Thursday",
  "days": [
    {
      "gregorian_day": 1,
      "gregorian_date": "2024-02-01",
      "day_of_week": "Thursday",
      "ethiopian_date": {"year": 2016, "month": 5, "day": 22, "month_name": "Tir"}
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: full_month_gregorian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	Yes	Gregorian year
`month`	query	integer	Yes	Gregorian month (1–12)
`lang`	query	string	No	Language code (default: `en`)

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/full-month/gregorian?year=2024&month=2&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /full-month/gregorian Full Month Gregorian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Gregorian calendar month: lists every day with its corresponding Ethiopian date and weekday.

10. `/full-month/gregorian` — Gregorian Month View

Full Gregorian calendar month: lists every day with its corresponding Ethiopian date and weekday.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Gregorian year	`2024`
`month`	int	Yes	Gregorian month (1–12)	`2`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/full-month/gregorian?year=2024&month=2

{
  "status": "success",
  "gregorian_year": 2024,
  "gregorian_month": 2,
  "month_name": "February",
  "days_in_month": 29,
  "is_gc_leap_year": true,
  "first_day_of_week": "Thursday",
  "days": [
    {
      "gregorian_day": 1,
      "gregorian_date": "2024-02-01",
      "day_of_week": "Thursday",
      "ethiopian_date": {"year": 2016, "month": 5, "day": 22, "month_name": "Tir"}
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: full_month_gregorian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	body	integer	Yes	Gregorian year
`month`	body	integer	Yes	Gregorian month (1–12)
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/full-month/gregorian -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"year": 2024, "month": 2, "lang": "am"}'

GROUP / 09

Convert

Convert endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /convert Convert SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Single-date converter that accepts either a Gregorian date or Ethiopian year/month/day and returns both calendars.

4. `/convert` — Bidirectional Converter

Single-date converter that accepts either a Gregorian date or Ethiopian year/month/day and returns both calendars.

Methods: GET, POST

Param	Type	Required	Description	Example
`date`	string	Yes*	Gregorian date (YYYY-MM-DD)	`2024-05-05`
`year`	int	Yes*	Ethiopian year	`2016`
`month`	int	Yes*	Ethiopian month (1–13)	`1`
`day`	int	Yes*	Ethiopian day (1–30)	`1`
`lang`	string	No	Language code (default: `en`)	`am`

*Either date OR year+month+day must be provided, not both.

GET https://ethiopian-calendar-api.p.rapidapi.com/convert?date=2024-05-05

{
  "status": "success",
  "ethiopian_date": {"year": 2016, "month": 8, "day": 27, "month_name": "Miyazia"},
  "gregorian_date": "2024-05-05",
  "gregorian": {"year": 2024, "month": 5, "day": 5},
  "day_of_week": "Sunday",
  "weekday": 6,
  "is_ec_leap_year": false,
  "days_in_ethiopian_month": 30
}

Source contract imported from ethiopian calendar/app.py. Handler: convert. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date`	query	string	No	Gregorian date (YYYY-MM-DD)
`year`	query	integer	No	Ethiopian year
`month`	query	integer	No	Ethiopian month (1–13)
`day`	query	integer	No	Ethiopian day (1–30)
`lang`	query	string	No	Language code (default: `en`)
`to`	query	string	No	Target calendar for conversion.
`calendar`	query	string	No	Calendar system selector (`ethiopian` or `gregorian`).
`from`	query	string	No	Starting calendar/date for conversion.
`time`	query	string	No	Time value to convert or use with the calendar date.

SAMPLE RESPONSE

{
  "status": "success",
  "weekday": 6,
  "gregorian": {
    "day": 5,
    "year": 2024,
    "month": 5
  },
  "day_of_week": "Sunday",
  "ethiopian_date": {
    "day": 27,
    "year": 2016,
    "month": 8,
    "month_name": "Miyazia"
  },
  "gregorian_date": "2024-05-05",
  "is_ec_leap_year": false,
  "days_in_ethiopian_month": 30
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/convert?date=2024-05-05&year=2016&month=1&day=1&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /convert Convert SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Single-date converter that accepts either a Gregorian date or Ethiopian year/month/day and returns both calendars.

4. `/convert` — Bidirectional Converter

Single-date converter that accepts either a Gregorian date or Ethiopian year/month/day and returns both calendars.

Methods: GET, POST

Param	Type	Required	Description	Example
`date`	string	Yes*	Gregorian date (YYYY-MM-DD)	`2024-05-05`
`year`	int	Yes*	Ethiopian year	`2016`
`month`	int	Yes*	Ethiopian month (1–13)	`1`
`day`	int	Yes*	Ethiopian day (1–30)	`1`
`lang`	string	No	Language code (default: `en`)	`am`

*Either date OR year+month+day must be provided, not both.

GET https://ethiopian-calendar-api.p.rapidapi.com/convert?date=2024-05-05

{
  "status": "success",
  "ethiopian_date": {"year": 2016, "month": 8, "day": 27, "month_name": "Miyazia"},
  "gregorian_date": "2024-05-05",
  "gregorian": {"year": 2024, "month": 5, "day": 5},
  "day_of_week": "Sunday",
  "weekday": 6,
  "is_ec_leap_year": false,
  "days_in_ethiopian_month": 30
}

Source contract imported from ethiopian calendar/app.py. Handler: convert. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date`	body	string	No	Gregorian date (YYYY-MM-DD)
`year`	body	integer	No	Ethiopian year
`month`	body	integer	No	Ethiopian month (1–13)
`day`	body	integer	No	Ethiopian day (1–30)
`lang`	body	string	No	Language code (default: `en`)
`to`	body	string	No	Target calendar for conversion.
`calendar`	body	string	No	Calendar system selector (`ethiopian` or `gregorian`).
`from`	body	string	No	Starting calendar/date for conversion.
`time`	body	string	No	Time value to convert or use with the calendar date.

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/convert -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"date": "2024-05-05", "year": 2016, "month": 1, "day": 1, "lang": "am", "to": "example", "calendar": "example", "from": "example", "time": "example"}'

GROUP / 10

Convert Year

Convert Year endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /convert-year Convert Year SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Year-level calendar conversion. For Ethiopian→Gregorian: returns the Gregorian year span. For Gregorian→Ethiopian: returns the Ethiopian years that overlap that Gregorian year.

5. `/convert-year` — Year-Level Conversion

Year-level calendar conversion. For Ethiopian→Gregorian: returns the Gregorian year span. For Gregorian→Ethiopian: returns the Ethiopian years that overlap that Gregorian year.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Year to convert	`2016`
`calendar`	string	No	`"ethiopian"` (default) or `"gregorian"`	`gregorian`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/convert-year?year=2024&calendar=gregorian

{
  "status": "success",
  "input": {"year": 2024, "calendar": "gregorian"},
  "gregorian_year": 2024,
  "ethiopian_years_covered": [2016, 2017],
  "is_gc_leap_year": true
}

Source contract imported from ethiopian calendar/app.py. Handler: convert_year. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	Yes	Year to convert
`calendar`	query	string	No	`"ethiopian"` (default) or `"gregorian"`
`lang`	query	string	No	Language code (default: `en`)

SAMPLE RESPONSE

{
  "input": {
    "year": 2024,
    "calendar": "gregorian"
  },
  "status": "success",
  "gregorian_year": 2024,
  "is_gc_leap_year": true,
  "ethiopian_years_covered": [
    2016,
    2017
  ]
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/convert-year?year=2016&calendar=gregorian&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /convert-year Convert Year SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Year-level calendar conversion. For Ethiopian→Gregorian: returns the Gregorian year span. For Gregorian→Ethiopian: returns the Ethiopian years that overlap that Gregorian year.

5. `/convert-year` — Year-Level Conversion

Year-level calendar conversion. For Ethiopian→Gregorian: returns the Gregorian year span. For Gregorian→Ethiopian: returns the Ethiopian years that overlap that Gregorian year.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Year to convert	`2016`
`calendar`	string	No	`"ethiopian"` (default) or `"gregorian"`	`gregorian`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/convert-year?year=2024&calendar=gregorian

{
  "status": "success",
  "input": {"year": 2024, "calendar": "gregorian"},
  "gregorian_year": 2024,
  "ethiopian_years_covered": [2016, 2017],
  "is_gc_leap_year": true
}

Source contract imported from ethiopian calendar/app.py. Handler: convert_year. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	body	integer	Yes	Year to convert
`calendar`	body	string	No	`"ethiopian"` (default) or `"gregorian"`
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/convert-year -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"year": 2016, "calendar": "gregorian", "lang": "am"}'

GROUP / 11

Date Range

Date Range endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /date-range Date Range SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Convert a range of Gregorian dates to Ethiopian dates, one entry per day. Maximum 366 days per request.

13. `/date-range` — Date Range Converter

Convert a range of Gregorian dates to Ethiopian dates, one entry per day. Maximum 366 days per request.

Methods: GET, POST

Param	Type	Required	Description	Example
`from`	string	Yes	Start date (YYYY-MM-DD)	`2024-01-01`
`to`	string	Yes	End date (YYYY-MM-DD, >= from)	`2024-01-05`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/date-range?from=2024-01-01&to=2024-01-05

{
  "status": "success",
  "from": "2024-01-01",
  "to": "2024-01-05",
  "total_days": 5,
  "days": [
    {
      "gregorian_date": "2024-01-01",
      "ethiopian_date": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"},
      "day_of_week": "Monday"
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: date_range. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`from`	query	string	Yes	Start date (YYYY-MM-DD)
`to`	query	string	Yes	End date (YYYY-MM-DD, >= from)
`lang`	query	string	No	Language code (default: `en`)

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/date-range?from=2024-01-01&to=2024-01-05&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /date-range Date Range SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Convert a range of Gregorian dates to Ethiopian dates, one entry per day. Maximum 366 days per request.

13. `/date-range` — Date Range Converter

Convert a range of Gregorian dates to Ethiopian dates, one entry per day. Maximum 366 days per request.

Methods: GET, POST

Param	Type	Required	Description	Example
`from`	string	Yes	Start date (YYYY-MM-DD)	`2024-01-01`
`to`	string	Yes	End date (YYYY-MM-DD, >= from)	`2024-01-05`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/date-range?from=2024-01-01&to=2024-01-05

{
  "status": "success",
  "from": "2024-01-01",
  "to": "2024-01-05",
  "total_days": 5,
  "days": [
    {
      "gregorian_date": "2024-01-01",
      "ethiopian_date": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"},
      "day_of_week": "Monday"
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: date_range. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`from`	body	string	Yes	Start date (YYYY-MM-DD)
`to`	body	string	Yes	End date (YYYY-MM-DD, >= from)
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/date-range -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"from": "2024-01-01", "to": "2024-01-05", "lang": "am"}'

GROUP / 12

Year

Year endpoints sourced from the Ethiopian Calendar API implementation.

4 endpoints

GET /year Year View SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Ethiopian year overview: all 13 months with their Gregorian start and end dates. Optionally include day-level entries and holidays.

11. `/year` — Full Ethiopian Year

Full Ethiopian year overview: all 13 months with their Gregorian start and end dates. Optionally include day-level entries and holidays.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Ethiopian year	`2016`
`lang`	string	No	Language code (default: `en`)	`am`
`include_days`	string	No	`true`/`1`/`yes` to include day-level entries	`true`
`include_holidays`	string	No	`true`/`1`/`yes` to include holidays list	`true`

GET https://ethiopian-calendar-api.p.rapidapi.com/year?year=2016&include_holidays=true

{
  "status": "success",
  "ethiopian_year": 2016,
  "is_leap_year": false,
  "days_in_year": 365,
  "new_year_gregorian": "2023-09-12",
  "end_gregorian": "2024-09-10",
  "months": [
    {"month": 1, "name": "Meskerem", "days": 30, "first_gregorian_date": "2023-09-12", "last_gregorian_date": "2023-10-11"},
    "...",
    {"month": 13, "name": "Pagumen", "days": 5, "first_gregorian_date": "2023-09-06", "last_gregorian_date": "2023-09-10"}
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: year_view. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	Yes	Ethiopian year
`lang`	query	string	No	Language code (default: `en`)
`include_days`	query	string	No	`true`/`1`/`yes` to include day-level entries
`include_holidays`	query	string	No	`true`/`1`/`yes` to include holidays list

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/year?year=2016&lang=am&include_days=True&include_holidays=True' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /year Year View SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Ethiopian year overview: all 13 months with their Gregorian start and end dates. Optionally include day-level entries and holidays.

11. `/year` — Full Ethiopian Year

Full Ethiopian year overview: all 13 months with their Gregorian start and end dates. Optionally include day-level entries and holidays.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Ethiopian year	`2016`
`lang`	string	No	Language code (default: `en`)	`am`
`include_days`	string	No	`true`/`1`/`yes` to include day-level entries	`true`
`include_holidays`	string	No	`true`/`1`/`yes` to include holidays list	`true`

GET https://ethiopian-calendar-api.p.rapidapi.com/year?year=2016&include_holidays=true

{
  "status": "success",
  "ethiopian_year": 2016,
  "is_leap_year": false,
  "days_in_year": 365,
  "new_year_gregorian": "2023-09-12",
  "end_gregorian": "2024-09-10",
  "months": [
    {"month": 1, "name": "Meskerem", "days": 30, "first_gregorian_date": "2023-09-12", "last_gregorian_date": "2023-10-11"},
    "...",
    {"month": 13, "name": "Pagumen", "days": 5, "first_gregorian_date": "2023-09-06", "last_gregorian_date": "2023-09-10"}
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: year_view. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	body	integer	Yes	Ethiopian year
`lang`	body	string	No	Language code (default: `en`)
`include_days`	body	string	No	`true`/`1`/`yes` to include day-level entries
`include_holidays`	body	string	No	`true`/`1`/`yes` to include holidays list

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/year -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"year": 2016, "lang": "am", "include_days": true, "include_holidays": true}'

GET /year/gregorian Year View Gregorian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Gregorian year overview: all 12 months with their Ethiopian start/end dates and leap-year status.

12. `/year/gregorian` — Full Gregorian Year

Full Gregorian year overview: all 12 months with their Ethiopian start/end dates and leap-year status.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Gregorian year	`2024`
`lang`	string	No	Language code (default: `en`)	`am`
`include_days`	string	No	`true`/`1`/`yes` to include day-level entries	`true`

GET https://ethiopian-calendar-api.p.rapidapi.com/year/gregorian?year=2024

{
  "status": "success",
  "gregorian_year": 2024,
  "is_gc_leap_year": true,
  "days_in_year": 366,
  "months": [
    {
      "month": 1,
      "name": "January",
      "days": 31,
      "first_ethiopian_date": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"},
      "last_ethiopian_date": {"year": 2016, "month": 5, "day": 22, "month_name": "Tir"}
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: year_view_gregorian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	Yes	Gregorian year
`lang`	query	string	No	Language code (default: `en`)
`include_days`	query	string	No	`true`/`1`/`yes` to include day-level entries

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/year/gregorian?year=2024&lang=am&include_days=True' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /year/gregorian Year View Gregorian SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Full Gregorian year overview: all 12 months with their Ethiopian start/end dates and leap-year status.

12. `/year/gregorian` — Full Gregorian Year

Full Gregorian year overview: all 12 months with their Ethiopian start/end dates and leap-year status.

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	Yes	Gregorian year	`2024`
`lang`	string	No	Language code (default: `en`)	`am`
`include_days`	string	No	`true`/`1`/`yes` to include day-level entries	`true`

GET https://ethiopian-calendar-api.p.rapidapi.com/year/gregorian?year=2024

{
  "status": "success",
  "gregorian_year": 2024,
  "is_gc_leap_year": true,
  "days_in_year": 366,
  "months": [
    {
      "month": 1,
      "name": "January",
      "days": 31,
      "first_ethiopian_date": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"},
      "last_ethiopian_date": {"year": 2016, "month": 5, "day": 22, "month_name": "Tir"}
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: year_view_gregorian. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	body	integer	Yes	Gregorian year
`lang`	body	string	No	Language code (default: `en`)
`include_days`	body	string	No	`true`/`1`/`yes` to include day-level entries

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/year/gregorian -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"year": 2024, "lang": "am", "include_days": true}'

GROUP / 13

Holidays

Holidays endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /holidays Holidays SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

List all public, religious and national holidays for an Ethiopian year (or Gregorian year). Includes fixed Ethiopian feasts, movable Orthodox holidays, fixed Gregorian national days, and approximate Islamic holidays.

14. `/holidays` — Holiday Calendar

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	No	Ethiopian year (default: current EC year)	`2016`
`calendar`	string	No	`"ethiopian"` (default) or `"gregorian"`	`gregorian`
`lang`	string	No	Language code (default: `en`)	`am`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`

GET https://ethiopian-calendar-api.p.rapidapi.com/holidays?year=2016

{
  "status": "success",
  "year": 2016,
  "calendar": "ethiopian",
  "holidays": [
    {
      "name": "Enkutatash (Ethiopian New Year)",
      "type": "national",
      "is_public_holiday": true,
      "fixed": true,
      "approximate": false,
      "ethiopian_date": {"year": 2016, "month": 1, "day": 1, "month_name": "Meskerem"},
      "gregorian_date": "2023-09-12",
      "day_of_week": "Tuesday",
      "description": "First day of the Ethiopian year, celebrated with family gatherings and bouquets of yellow adey abeba flowers."
    },
    {
      "name": "Fasika (Ethiopian Easter)",
      "type": "religious",
      "is_public_holiday": false,
      "fixed": false,
      "approximate": false,
      "ethiopian_date": {"year": 2016, "month": 8, "day": 27, "month_name": "Miyazia"},
      "gregorian_date": "2024-05-05",
      "day_of_week": "Sunday",
      "description": "Commemorates the resurrection of Jesus Christ."
    },
    "..."
  ]
}

Holiday types included:

Category	Holidays
Fixed Ethiopian	Enkutatash (Mesk 1), Meskel (Mesk 17), Genna (Tahsas 29), Timkat (Tir 11), Adwa (Yekatit 23)
Movable Orthodox	Siklet (Good Friday), Fasika (Easter), Rikbe Kahinat (Ascension)
Fixed Gregorian	Labor Day (May 1), Patriots' Victory Day (May 5), Derg Downfall Day (May 28)
Islamic (approx.)	Eid al-Fitr, Eid al-Adha, Mawlid

Source contract imported from ethiopian calendar/app.py. Handler: holidays. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	query	integer	No	Ethiopian year (default: current EC year)
`calendar`	query	string	No	`"ethiopian"` (default) or `"gregorian"`
`lang`	query	string	No	Language code (default: `en`)
`tz`	query	string	No	IANA timezone

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/holidays?year=2016&calendar=gregorian&lang=am&tz=Africa%2FAddis_Ababa' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /holidays Holidays SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

14. `/holidays` — Holiday Calendar

Methods: GET, POST

Param	Type	Required	Description	Example
`year`	int	No	Ethiopian year (default: current EC year)	`2016`
`calendar`	string	No	`"ethiopian"` (default) or `"gregorian"`	`gregorian`
`lang`	string	No	Language code (default: `en`)	`am`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`

GET https://ethiopian-calendar-api.p.rapidapi.com/holidays?year=2016

{
  "status": "success",
  "year": 2016,
  "calendar": "ethiopian",
  "holidays": [
    {
      "name": "Enkutatash (Ethiopian New Year)",
      "type": "national",
      "is_public_holiday": true,
      "fixed": true,
      "approximate": false,
      "ethiopian_date": {"year": 2016, "month": 1, "day": 1, "month_name": "Meskerem"},
      "gregorian_date": "2023-09-12",
      "day_of_week": "Tuesday",
      "description": "First day of the Ethiopian year, celebrated with family gatherings and bouquets of yellow adey abeba flowers."
    },
    {
      "name": "Fasika (Ethiopian Easter)",
      "type": "religious",
      "is_public_holiday": false,
      "fixed": false,
      "approximate": false,
      "ethiopian_date": {"year": 2016, "month": 8, "day": 27, "month_name": "Miyazia"},
      "gregorian_date": "2024-05-05",
      "day_of_week": "Sunday",
      "description": "Commemorates the resurrection of Jesus Christ."
    },
    "..."
  ]
}

Holiday types included:

Category	Holidays
Fixed Ethiopian	Enkutatash (Mesk 1), Meskel (Mesk 17), Genna (Tahsas 29), Timkat (Tir 11), Adwa (Yekatit 23)
Movable Orthodox	Siklet (Good Friday), Fasika (Easter), Rikbe Kahinat (Ascension)
Fixed Gregorian	Labor Day (May 1), Patriots' Victory Day (May 5), Derg Downfall Day (May 28)
Islamic (approx.)	Eid al-Fitr, Eid al-Adha, Mawlid

Source contract imported from ethiopian calendar/app.py. Handler: holidays. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`year`	body	integer	No	Ethiopian year (default: current EC year)
`calendar`	body	string	No	`"ethiopian"` (default) or `"gregorian"`
`lang`	body	string	No	Language code (default: `en`)
`tz`	body	string	No	IANA timezone

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/holidays -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"year": 2016, "calendar": "gregorian", "lang": "am", "tz": "Africa/Addis_Ababa"}'

GROUP / 14

Next Holiday

Next Holiday endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /next-holiday Next Holiday SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Get the next upcoming holiday from today (or a given date). Returns the Ethiopian and Gregorian dates, days until the holiday, and its description.

15. `/next-holiday` — Next Upcoming Holiday

Get the next upcoming holiday from today (or a given date). Returns the Ethiopian and Gregorian dates, days until the holiday, and its description.

Methods: GET, POST

Param	Type	Required	Description	Example
`now`	string	No	Override "today" (YYYY-MM-DD)	`2024-01-08`
`limit`	int	No	Number of holidays to return (1–10, default: 1)	`3`
`lang`	string	No	Language code (default: `en`)	`am`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`

GET https://ethiopian-calendar-api.p.rapidapi.com/next-holiday?now=2024-01-08&limit=3

{
  "status": "success",
  "reference_date": "2024-01-08",
  "limit": 3,
  "holidays": [
    {
      "name": "Timkat (Ethiopian Epiphany)",
      "type": "religious",
      "is_public_holiday": false,
      "fixed": true,
      "approximate": false,
      "ethiopian_date": {"year": 2016, "month": 5, "day": 11, "month_name": "Tir"},
      "gregorian_date": "2024-01-20",
      "day_of_week": "Saturday",
      "days_until": 12,
      "description": "Commemorates the baptism of Jesus; celebrated with colorful processions of tabots."
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: next_holiday. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`now`	query	string	No	Override "today" (YYYY-MM-DD)
`limit`	query	integer	No	Number of holidays to return (1–10, default: 1)
`lang`	query	string	No	Language code (default: `en`)
`tz`	query	string	No	IANA timezone

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/next-holiday?now=2024-01-08&limit=3&lang=am&tz=Africa%2FAddis_Ababa' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /next-holiday Next Holiday SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Get the next upcoming holiday from today (or a given date). Returns the Ethiopian and Gregorian dates, days until the holiday, and its description.

15. `/next-holiday` — Next Upcoming Holiday

Get the next upcoming holiday from today (or a given date). Returns the Ethiopian and Gregorian dates, days until the holiday, and its description.

Methods: GET, POST

Param	Type	Required	Description	Example
`now`	string	No	Override "today" (YYYY-MM-DD)	`2024-01-08`
`limit`	int	No	Number of holidays to return (1–10, default: 1)	`3`
`lang`	string	No	Language code (default: `en`)	`am`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`

GET https://ethiopian-calendar-api.p.rapidapi.com/next-holiday?now=2024-01-08&limit=3

{
  "status": "success",
  "reference_date": "2024-01-08",
  "limit": 3,
  "holidays": [
    {
      "name": "Timkat (Ethiopian Epiphany)",
      "type": "religious",
      "is_public_holiday": false,
      "fixed": true,
      "approximate": false,
      "ethiopian_date": {"year": 2016, "month": 5, "day": 11, "month_name": "Tir"},
      "gregorian_date": "2024-01-20",
      "day_of_week": "Saturday",
      "days_until": 12,
      "description": "Commemorates the baptism of Jesus; celebrated with colorful processions of tabots."
    },
    "..."
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: next_holiday. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`now`	body	string	No	Override "today" (YYYY-MM-DD)
`limit`	body	integer	No	Number of holidays to return (1–10, default: 1)
`lang`	body	string	No	Language code (default: `en`)
`tz`	body	string	No	IANA timezone

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/next-holiday -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"now": "2024-01-08", "limit": 3, "lang": "am", "tz": "Africa/Addis_Ababa"}'

GROUP / 15

Countdown

Countdown endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /countdown Countdown SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Countdown from today (or a given start date) to a target date. The target can be given as a Gregorian or Ethiopian date. Returns days, hours, minutes, seconds and whether the target is in the future.

16. `/countdown` — Countdown to a Date

Countdown from today (or a given start date) to a target date. The target can be given as a Gregorian or Ethiopian date. Returns days, hours, minutes, seconds and whether the target is in the future.

Methods: GET, POST

Param	Type	Required	Description	Example
`date`	string	Yes*	Target Gregorian date (YYYY-MM-DD)	`2024-09-12`
`year`	int	Yes*	Target Ethiopian year	`2017`
`month`	int	Yes*	Target Ethiopian month (1–13)	`1`
`day`	int	Yes*	Target Ethiopian day (1–30)	`1`
`from`	string	No	Start date (YYYY-MM-DD, default: today)	`2024-01-01`
`lang`	string	No	Language code (default: `en`)	`am`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`

*Either date (Gregorian) OR year+month+day (Ethiopian) must be provided.

GET https://ethiopian-calendar-api.p.rapidapi.com/countdown?date=2024-09-12&from=2024-01-01

{
  "status": "success",
  "target": {
    "ethiopian_date": {"year": 2017, "month": 1, "day": 1, "month_name": "Meskerem"},
    "gregorian_date": "2024-09-11"
  },
  "from": "2024-01-01",
  "is_future": true,
  "days": 254,
  "hours": 0,
  "minutes": 0,
  "seconds": 0,
  "total_days": 254
}

POST example (Ethiopian target):

POST https://ethiopian-calendar-api.p.rapidapi.com/countdown
Content-Type: application/json

{
  "year": 2017,
  "month": 1,
  "day": 1,
  "from": "2024-01-01"
}

Source contract imported from ethiopian calendar/app.py. Handler: countdown. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date`	query	string	No	Target Gregorian date (YYYY-MM-DD)
`year`	query	integer	No	Target Ethiopian year
`month`	query	integer	No	Target Ethiopian month (1–13)
`day`	query	integer	No	Target Ethiopian day (1–30)
`from`	query	string	No	Start date (YYYY-MM-DD, default: today)
`lang`	query	string	No	Language code (default: `en`)
`tz`	query	string	No	IANA timezone
`event`	query	string	No	Optional event label included with the countdown result.
`event_date`	query	string	No	Target date for the event countdown (YYYY-MM-DD).

SAMPLE RESPONSE

{
  "days": 254,
  "from": "2024-01-01",
  "hours": 0,
  "status": "success",
  "target": {
    "ethiopian_date": {
      "day": 1,
      "year": 2017,
      "month": 1,
      "month_name": "Meskerem"
    },
    "gregorian_date": "2024-09-11"
  },
  "minutes": 0,
  "seconds": 0,
  "is_future": true,
  "total_days": 254
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/countdown?date=2024-09-12&year=2017&month=1&day=1&from=2024-01-01&lang=am&tz=Africa%2FAddis_Ababa' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /countdown Countdown SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Countdown from today (or a given start date) to a target date. The target can be given as a Gregorian or Ethiopian date. Returns days, hours, minutes, seconds and whether the target is in the future.

16. `/countdown` — Countdown to a Date

Countdown from today (or a given start date) to a target date. The target can be given as a Gregorian or Ethiopian date. Returns days, hours, minutes, seconds and whether the target is in the future.

Methods: GET, POST

Param	Type	Required	Description	Example
`date`	string	Yes*	Target Gregorian date (YYYY-MM-DD)	`2024-09-12`
`year`	int	Yes*	Target Ethiopian year	`2017`
`month`	int	Yes*	Target Ethiopian month (1–13)	`1`
`day`	int	Yes*	Target Ethiopian day (1–30)	`1`
`from`	string	No	Start date (YYYY-MM-DD, default: today)	`2024-01-01`
`lang`	string	No	Language code (default: `en`)	`am`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`

*Either date (Gregorian) OR year+month+day (Ethiopian) must be provided.

GET https://ethiopian-calendar-api.p.rapidapi.com/countdown?date=2024-09-12&from=2024-01-01

{
  "status": "success",
  "target": {
    "ethiopian_date": {"year": 2017, "month": 1, "day": 1, "month_name": "Meskerem"},
    "gregorian_date": "2024-09-11"
  },
  "from": "2024-01-01",
  "is_future": true,
  "days": 254,
  "hours": 0,
  "minutes": 0,
  "seconds": 0,
  "total_days": 254
}

POST example (Ethiopian target):

POST https://ethiopian-calendar-api.p.rapidapi.com/countdown
Content-Type: application/json

{
  "year": 2017,
  "month": 1,
  "day": 1,
  "from": "2024-01-01"
}

Source contract imported from ethiopian calendar/app.py. Handler: countdown. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date`	body	string	No	Target Gregorian date (YYYY-MM-DD)
`year`	body	integer	No	Target Ethiopian year
`month`	body	integer	No	Target Ethiopian month (1–13)
`day`	body	integer	No	Target Ethiopian day (1–30)
`from`	body	string	No	Start date (YYYY-MM-DD, default: today)
`lang`	body	string	No	Language code (default: `en`)
`tz`	body	string	No	IANA timezone
`event`	body	string	No	Optional event label included with the countdown result.
`event_date`	body	string	No	Target date for the event countdown (YYYY-MM-DD).

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/countdown -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"date": "2024-09-12", "year": 2017, "month": 1, "day": 1, "from": "2024-01-01", "lang": "am", "tz": "Africa/Addis_Ababa", "event": "example", "event_date": "example"}'

GROUP / 16

Difference

Difference endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /difference Difference SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Calculate the number of days between two dates. Supports Gregorian-to-Gregorian (GET query params) or Ethiopian-to-Ethiopian (POST JSON body with objects). Maximum span: 10 years.

17. `/difference` — Days Between Two Dates

Calculate the number of days between two dates. Supports Gregorian-to-Gregorian (GET query params) or Ethiopian-to-Ethiopian (POST JSON body with objects). Maximum span: 10 years.

Methods: GET, POST

Param	Type	Required	Description	Example
`date1`	string	Yes*	First Gregorian date (YYYY-MM-DD)	`2024-01-01`
`date2`	string	Yes*	Second Gregorian date (YYYY-MM-DD)	`2024-12-31`
`from_ethiopian`	object	Yes*	First Ethiopian date `{year, month, day}`	`{"year":2016,"month":1,"day":1}`
`to_ethiopian`	object	Yes*	Second Ethiopian date `{year, month, day}`	`{"year":2017,"month":1,"day":1}`
`lang`	string	No	Language code (default: `en`)	`am`

*Either date1/date2 (Gregorian) OR from_ethiopian/to_ethiopian (Ethiopian objects, POST body only) must be provided.

GET request (Gregorian dates):

GET https://ethiopian-calendar-api.p.rapidapi.com/difference?date1=2024-01-01&date2=2024-12-31

{
  "status": "success",
  "date1": {
    "gregorian_date": "2024-01-01",
    "ethiopian_date": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"}
  },
  "date2": {
    "gregorian_date": "2024-12-31",
    "ethiopian_date": {"year": 2017, "month": 4, "day": 21, "month_name": "Tahsas"}
  },
  "days_between": 365,
  "direction": "date1_before_date2"
}

POST request (Ethiopian dates):

POST https://ethiopian-calendar-api.p.rapidapi.com/difference
Content-Type: application/json

{
  "from_ethiopian": {"year": 2016, "month": 1, "day": 1},
  "to_ethiopian": {"year": 2017, "month": 1, "day": 1}
}

{
  "status": "success",
  "date1": {
    "gregorian_date": "2023-09-12",
    "ethiopian_date": {"year": 2016, "month": 1, "day": 1, "month_name": "Meskerem"}
  },
  "date2": {
    "gregorian_date": "2024-09-11",
    "ethiopian_date": {"year": 2017, "month": 1, "day": 1, "month_name": "Meskerem"}
  },
  "days_between": 365,
  "direction": "date1_before_date2"
}

Source contract imported from ethiopian calendar/app.py. Handler: difference. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date1`	query	string	No	First Gregorian date (YYYY-MM-DD)
`date2`	query	string	No	Second Gregorian date (YYYY-MM-DD)
`from_ethiopian`	query	object	No	First Ethiopian date `{year, month, day}`
`to_ethiopian`	query	object	No	Second Ethiopian date `{year, month, day}`
`lang`	query	string	No	Language code (default: `en`)

SAMPLE RESPONSE

{
  "date1": {
    "ethiopian_date": {
      "day": 22,
      "year": 2016,
      "month": 4,
      "month_name": "Tahsas"
    },
    "gregorian_date": "2024-01-01"
  },
  "date2": {
    "ethiopian_date": {
      "day": 21,
      "year": 2017,
      "month": 4,
      "month_name": "Tahsas"
    },
    "gregorian_date": "2024-12-31"
  },
  "status": "success",
  "direction": "date1_before_date2",
  "days_between": 365
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/difference?date1=2024-01-01&date2=2024-12-31&from_ethiopian=day&from_ethiopian=year&from_ethiopian=month&to_ethiopian=day&to_ethiopian=year&to_ethiopian=month&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /difference Difference SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Calculate the number of days between two dates. Supports Gregorian-to-Gregorian (GET query params) or Ethiopian-to-Ethiopian (POST JSON body with objects). Maximum span: 10 years.

17. `/difference` — Days Between Two Dates

Calculate the number of days between two dates. Supports Gregorian-to-Gregorian (GET query params) or Ethiopian-to-Ethiopian (POST JSON body with objects). Maximum span: 10 years.

Methods: GET, POST

Param	Type	Required	Description	Example
`date1`	string	Yes*	First Gregorian date (YYYY-MM-DD)	`2024-01-01`
`date2`	string	Yes*	Second Gregorian date (YYYY-MM-DD)	`2024-12-31`
`from_ethiopian`	object	Yes*	First Ethiopian date `{year, month, day}`	`{"year":2016,"month":1,"day":1}`
`to_ethiopian`	object	Yes*	Second Ethiopian date `{year, month, day}`	`{"year":2017,"month":1,"day":1}`
`lang`	string	No	Language code (default: `en`)	`am`

*Either date1/date2 (Gregorian) OR from_ethiopian/to_ethiopian (Ethiopian objects, POST body only) must be provided.

GET request (Gregorian dates):

GET https://ethiopian-calendar-api.p.rapidapi.com/difference?date1=2024-01-01&date2=2024-12-31

{
  "status": "success",
  "date1": {
    "gregorian_date": "2024-01-01",
    "ethiopian_date": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"}
  },
  "date2": {
    "gregorian_date": "2024-12-31",
    "ethiopian_date": {"year": 2017, "month": 4, "day": 21, "month_name": "Tahsas"}
  },
  "days_between": 365,
  "direction": "date1_before_date2"
}

POST request (Ethiopian dates):

POST https://ethiopian-calendar-api.p.rapidapi.com/difference
Content-Type: application/json

{
  "from_ethiopian": {"year": 2016, "month": 1, "day": 1},
  "to_ethiopian": {"year": 2017, "month": 1, "day": 1}
}

{
  "status": "success",
  "date1": {
    "gregorian_date": "2023-09-12",
    "ethiopian_date": {"year": 2016, "month": 1, "day": 1, "month_name": "Meskerem"}
  },
  "date2": {
    "gregorian_date": "2024-09-11",
    "ethiopian_date": {"year": 2017, "month": 1, "day": 1, "month_name": "Meskerem"}
  },
  "days_between": 365,
  "direction": "date1_before_date2"
}

Source contract imported from ethiopian calendar/app.py. Handler: difference. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`date1`	body	string	No	First Gregorian date (YYYY-MM-DD)
`date2`	body	string	No	Second Gregorian date (YYYY-MM-DD)
`from_ethiopian`	body	object	No	First Ethiopian date `{year, month, day}`
`to_ethiopian`	body	object	No	Second Ethiopian date `{year, month, day}`
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/difference -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"date1": "2024-01-01", "date2": "2024-12-31", "from_ethiopian": {"day": 1, "year": 2016, "month": 1}, "to_ethiopian": {"day": 1, "year": 2017, "month": 1}, "lang": "am"}'

GROUP / 17

Time

Time endpoints sourced from the Ethiopian Calendar API implementation.

2 endpoints

GET /time Ethiopian Time SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Convert standard 24-hour clock time to the Ethiopian 12-hour sunrise clock. The Ethiopian day starts at sunrise (6:00 AM = 12:00 Ethiopian). Includes "short minutes" (kets), where 1 kets = 30 standard minutes.

18. `/time` — Ethiopian Time

Methods: GET, POST

Param	Type	Required	Description	Example
`time`	string	No	24-hour time (HH:MM, default: current time)	`09:30`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/time?time=09:30

{
  "status": "success",
  "standard_time": "09:30",
  "ethiopian_time": {
    "hour": 3,
    "minute": 30,
    "short_minutes": 1,
    "minute_remainder": 0,
    "period": "morning",
    "display": "3:30 morning"
  },
  "explanation": "The Ethiopian day starts at sunrise (6:00 AM standard time = 12:00 Ethiopian). Standard 6 AM is 12 o'clock; standard noon is 6 o'clock. A 'short minute' (kets) equals 30 standard minutes."
}

POST request (current time in Addis Ababa):

POST https://ethiopian-calendar-api.p.rapidapi.com/time
Content-Type: application/json

{
  "timezone": "Africa/Addis_Ababa"
}

{
  "status": "success",
  "standard_time": "14:30",
  "ethiopian_time": {
    "hour": 8,
    "minute": 30,
    "short_minutes": 1,
    "minute_remainder": 0,
    "period": "afternoon",
    "display": "8:30 afternoon"
  },
  "date": {
    "gregorian_date": "2026-08-26",
    "ethiopian_date": {"year": 2018, "month": 12, "day": 3, "month_name": "Nehase"},
    "time_zone": "Africa/Addis_Ababa"
  },
  "explanation": "The Ethiopian day starts at sunrise (6:00 AM standard time = 12:00 Ethiopian)."
}

Source contract imported from ethiopian calendar/app.py. Handler: ethiopian_time. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`time`	query	string	No	24-hour time (HH:MM, default: current time)
`tz`	query	string	No	IANA timezone
`lang`	query	string	No	Language code (default: `en`)

SAMPLE RESPONSE

{
  "status": "success",
  "explanation": "The Ethiopian day starts at sunrise (6:00 AM standard time = 12:00 Ethiopian). Standard 6 AM is 12 o'clock; standard noon is 6 o'clock. A 'short minute' (kets) equals 30 standard minutes.",
  "standard_time": "09:30",
  "ethiopian_time": {
    "hour": 3,
    "minute": 30,
    "period": "morning",
    "display": "3:30 morning",
    "short_minutes": 1,
    "minute_remainder": 0
  }
}

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/time?time=09%3A30&tz=Africa%2FAddis_Ababa&lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

POST /time Ethiopian Time SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

18. `/time` — Ethiopian Time

Methods: GET, POST

Param	Type	Required	Description	Example
`time`	string	No	24-hour time (HH:MM, default: current time)	`09:30`
`tz`	string	No	IANA timezone	`Africa/Addis_Ababa`
`lang`	string	No	Language code (default: `en`)	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/time?time=09:30

{
  "status": "success",
  "standard_time": "09:30",
  "ethiopian_time": {
    "hour": 3,
    "minute": 30,
    "short_minutes": 1,
    "minute_remainder": 0,
    "period": "morning",
    "display": "3:30 morning"
  },
  "explanation": "The Ethiopian day starts at sunrise (6:00 AM standard time = 12:00 Ethiopian). Standard 6 AM is 12 o'clock; standard noon is 6 o'clock. A 'short minute' (kets) equals 30 standard minutes."
}

POST request (current time in Addis Ababa):

POST https://ethiopian-calendar-api.p.rapidapi.com/time
Content-Type: application/json

{
  "timezone": "Africa/Addis_Ababa"
}

{
  "status": "success",
  "standard_time": "14:30",
  "ethiopian_time": {
    "hour": 8,
    "minute": 30,
    "short_minutes": 1,
    "minute_remainder": 0,
    "period": "afternoon",
    "display": "8:30 afternoon"
  },
  "date": {
    "gregorian_date": "2026-08-26",
    "ethiopian_date": {"year": 2018, "month": 12, "day": 3, "month_name": "Nehase"},
    "time_zone": "Africa/Addis_Ababa"
  },
  "explanation": "The Ethiopian day starts at sunrise (6:00 AM standard time = 12:00 Ethiopian)."
}

Source contract imported from ethiopian calendar/app.py. Handler: ethiopian_time. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`time`	body	string	No	24-hour time (HH:MM, default: current time)
`tz`	body	string	No	IANA timezone
`lang`	body	string	No	Language code (default: `en`)

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/time -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"time": "09:30", "tz": "Africa/Addis_Ababa", "lang": "am"}'

GROUP / 18

Month Names

Month Names endpoints sourced from the Ethiopian Calendar API implementation.

1 endpoint

GET /month-names Month Names SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Ethiopian month and weekday names in English, Ge'ez/Amharic, romanized Oromo, and romanized Tigrinya.

19. `/month-names` — Month & Day Names

Ethiopian month and weekday names in English, Ge'ez/Amharic, romanized Oromo, and romanized Tigrinya.

Method: GET

Param	Type	Required	Description	Example
`lang`	string	No	Filter: `all` (default), `en`, `am`, `om`, or `ti`	`am`

GET https://ethiopian-calendar-api.p.rapidapi.com/month-names?lang=am

{
  "status": "success",
  "months": [
    {"number": 1, "en": "Meskerem", "am": "መስከረም", "om": "Sadaasa", "ti": "Meskereem", "days": 30},
    {"number": 2, "en": "Tikimt", "am": "ጥቅምት", "om": "Onkololeessa", "ti": "Tkeme", "days": 30},
    "...",
    {"number": 13, "en": "Pagumen", "am": "ጳጉሜ", "om": "Qarramaa", "ti": "Pagumeen", "days": "5 or 6"}
  ],
  "days": [
    {"number": 1, "en": "Monday", "am": "ሰኞ"},
    {"number": 2, "en": "Tuesday", "am": "ማክሰኞ"},
    "...",
    {"number": 7, "en": "Sunday", "am": "እሑድ"}
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: month_names. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`lang`	query	string	No	Filter: `all` (default), `en`, `am`, `om`, or `ti`

QUICK CURL

curl -X GET 'https://api.dakidarts.com/ethiopian-calendar/month-names?lang=am' -H 'X-API-Key: dk_live_...' -H 'Accept: application/json'

GROUP / 19

Batch operations

Batch operations endpoints sourced from the Ethiopian Calendar API implementation.

1 endpoint

POST /batch Batch SOURCE CONTRACT — UPSTREAM NEEDED $0.0050 / call / 120 rpm Upstream needed

Batch-convert up to 100 dates in a single request. Choose a direction: `"to-gregorian"` (Ethiopian→Gregorian) or `"to-ethiopian"` (Gregorian→Ethiopian). Each item is converted independently — one invalid item fails only that item.

20. `/batch` — Batch Conversion

Batch-convert up to 100 dates in a single request. Choose a direction: "to-gregorian" (Ethiopian→Gregorian) or "to-ethiopian" (Gregorian→Ethiopian). Each item is converted independently — one invalid item fails only that item.

Method: POST only

Body Field	Type	Required	Description	Example
`direction`	string	Yes	`"to-gregorian"` or `"to-ethiopian"`	`to-ethiopian`
`dates`	array	Yes	Array of date objects (max 100)	see below
`lang`	string	No	Language code (default: `en`)	`am`

For to-gregorian, each item: {"year": 2016, "month": 1, "day": 1} For to-ethiopian, each item: {"date": "2024-01-01"}

POST https://ethiopian-calendar-api.p.rapidapi.com/batch
Content-Type: application/json

{
  "direction": "to-ethiopian",
  "dates": [
    {"date": "2024-01-01"},
    {"date": "2024-05-05"},
    {"date": "2024-09-11"}
  ]
}

{
  "status": "success",
  "direction": "to-ethiopian",
  "count": 3,
  "failed": 0,
  "results": [
    {
      "index": 0,
      "input": {"date": "2024-01-01"},
      "ethiopian_date": {"year": 2016, "month": 4, "day": 22, "month_name": "Tahsas"},
      "day_of_week": "Monday"
    },
    {
      "index": 1,
      "input": {"date": "2024-05-05"},
      "ethiopian_date": {"year": 2016, "month": 8, "day": 27, "month_name": "Miyazia"},
      "day_of_week": "Sunday"
    },
    {
      "index": 2,
      "input": {"date": "2024-09-11"},
      "ethiopian_date": {"year": 2017, "month": 1, "day": 1, "month_name": "Meskerem"},
      "day_of_week": "Wednesday"
    }
  ]
}

Batch with a failed item:

POST https://ethiopian-calendar-api.p.rapidapi.com/batch
Content-Type: application/json

{
  "direction": "to-gregorian",
  "dates": [
    {"year": 2016, "month": 1, "day": 1},
    {"year": 2015, "month": 13, "day": 6},
    {"year": 2016, "month": 0, "day": 1}
  ]
}

{
  "status": "success",
  "direction": "to-gregorian",
  "count": 3,
  "failed": 1,
  "results": [
    {
      "index": 0,
      "input": {"year": 2016, "month": 1, "day": 1},
      "gregorian_date": "2023-09-12",
      "day_of_week": "Tuesday"
    },
    {
      "index": 1,
      "input": {"year": 2015, "month": 13, "day": 6},
      "gregorian_date": "2023-09-10",
      "day_of_week": "Sunday"
    },
    {
      "index": 2,
      "input": {"year": 2016, "month": 0, "day": 1},
      "error": "'month' must be >= 1",
      "code": "INVALID_PARAMETER"
    }
  ]
}

Source contract imported from ethiopian calendar/app.py. Handler: batch. Reference: RAPID_README.md.

PARAMETERS

Name	In	Type	Required	Description
`dates`	body	array	Yes	Array of Ethiopian or Gregorian date values to convert in one request.
`direction`	body	string	Yes	Conversion direction: Ethiopian-to-Gregorian or Gregorian-to-Ethiopian.

SAMPLE REQUEST

{
  "dates": [
    "2024-01-01"
  ],
  "direction": "gregorian_to_ethiopian"
}

QUICK CURL

curl -X POST https://api.dakidarts.com/ethiopian-calendar/batch -H 'X-API-Key: dk_live_...' -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"dates": ["2024-01-01"], "direction": "gregorian_to_ethiopian"}'

INTERACTIVE SANDBOX

Explore a response before you integrate.

Edit a JSON request to validate its syntax and preview the published sample response. This stays in your browser; it never calls the live API or uses credits.

The preview checks JSON syntax and shows the saved example response; it does not execute request values.

MOCK RESPONSE

TYPESCRIPT CONTRACT

INTEGRATION SDK

Use the product where it lives.

These are integration templates, not runnable sample calls. Configure an endpoint upstream in API Studio, then replace the placeholder path. Saved samples stay preview-only.

REST/JSON

# Replace with a connected GET route and include any required parameters.
curl -X GET "https://api.dakidarts.com/ethiopian-calendar/v1/your-connected-endpoint" \
  -H "X-API-Key: dk_live_..." \
  -H "Accept: application/json"

# Replace with a connected GET route and include any required parameters.
import requests

headers = {"X-API-Key": "dk_live_..."}
response = requests.get("https://api.dakidarts.com/ethiopian-calendar/v1/your-connected-endpoint", headers=headers)
print(response.json())

// Replace with a connected GET route and include any required parameters.
const res = await fetch("https://api.dakidarts.com/ethiopian-calendar/v1/your-connected-endpoint", {
  headers: { "X-API-Key": "dk_live_..." }
});
const data = await res.json();
console.log(data);

<?php
// Replace with a connected GET route and include any required parameters.
$ch = curl_init("https://api.dakidarts.com/ethiopian-calendar/v1/your-connected-endpoint");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: dk_live_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Explore more Time and adjacent APIs.

Full catalog

Ethiopian Calendar API

Call Ethiopian Calendar API through the Dakidarts gateway.

One key, one gateway

Metered by the call

Observable by default

Also available through RapidAPI.

Built to disappear into the product.

Full Ethiopian and Gregorian month/year views

Batch conversion and date-difference workflows

Month and weekday names in English, Ge’ez/Amharic, Oromo and Tigrinya

The shape of the surface.

Answers before you integrate.

Choose a quota that matches the workload.

Pay-as-you-go access

From first request to production.

Create a Dakidarts key

Call the gateway

Watch usage

Endpoint reference & metered costs.

Operations

1. /status — Service Status

1. /status — Service Status

GET /health

About

GET /about

To Gregorian

2. /to-gregorian — Ethiopian → Gregorian

2. /to-gregorian — Ethiopian → Gregorian

To Ethiopian

3. /to-ethiopian — Gregorian → Ethiopian

3. /to-ethiopian — Gregorian → Ethiopian

Current Date

6. /current-date — Today in Both Calendars

Is Leap Year

7. /is-leap-year — Leap Year Check

Calendar Info

8. /calendar-info — Calendar Overview

Full Month

9. /full-month — Ethiopian Month View

9. /full-month — Ethiopian Month View

10. /full-month/gregorian — Gregorian Month View

10. /full-month/gregorian — Gregorian Month View

Convert

4. /convert — Bidirectional Converter

4. /convert — Bidirectional Converter

Convert Year

5. /convert-year — Year-Level Conversion

5. /convert-year — Year-Level Conversion

Date Range

13. /date-range — Date Range Converter

13. /date-range — Date Range Converter

Year

11. /year — Full Ethiopian Year

11. /year — Full Ethiopian Year

12. /year/gregorian — Full Gregorian Year

12. /year/gregorian — Full Gregorian Year

Holidays

14. /holidays — Holiday Calendar

14. /holidays — Holiday Calendar

Next Holiday

15. /next-holiday — Next Upcoming Holiday

15. /next-holiday — Next Upcoming Holiday

Countdown

16. /countdown — Countdown to a Date

16. /countdown — Countdown to a Date

Difference

17. /difference — Days Between Two Dates

17. /difference — Days Between Two Dates

Time

18. /time — Ethiopian Time

18. /time — Ethiopian Time

Month Names

19. /month-names — Month & Day Names

Batch operations

20. /batch — Batch Conversion

Explore a response before you integrate.

Use the product where it lives.

Explore more Time and adjacent APIs.

The Numerology API

HeFit API

1. `/status` — Service Status

1. `/status` — Service Status

`GET /health`

`GET /about`

2. `/to-gregorian` — Ethiopian → Gregorian

2. `/to-gregorian` — Ethiopian → Gregorian

3. `/to-ethiopian` — Gregorian → Ethiopian

3. `/to-ethiopian` — Gregorian → Ethiopian

6. `/current-date` — Today in Both Calendars

7. `/is-leap-year` — Leap Year Check

8. `/calendar-info` — Calendar Overview

9. `/full-month` — Ethiopian Month View

9. `/full-month` — Ethiopian Month View

10. `/full-month/gregorian` — Gregorian Month View

10. `/full-month/gregorian` — Gregorian Month View

4. `/convert` — Bidirectional Converter

4. `/convert` — Bidirectional Converter

5. `/convert-year` — Year-Level Conversion

5. `/convert-year` — Year-Level Conversion

13. `/date-range` — Date Range Converter

13. `/date-range` — Date Range Converter

11. `/year` — Full Ethiopian Year

11. `/year` — Full Ethiopian Year

12. `/year/gregorian` — Full Gregorian Year

12. `/year/gregorian` — Full Gregorian Year

14. `/holidays` — Holiday Calendar

14. `/holidays` — Holiday Calendar

15. `/next-holiday` — Next Upcoming Holiday

15. `/next-holiday` — Next Upcoming Holiday

16. `/countdown` — Countdown to a Date

16. `/countdown` — Countdown to a Date

17. `/difference` — Days Between Two Dates

17. `/difference` — Days Between Two Dates

18. `/time` — Ethiopian Time

18. `/time` — Ethiopian Time

19. `/month-names` — Month & Day Names

20. `/batch` — Batch Conversion