API

Ethiopian Calendar API

Explore the Ethiopian Calendar API — a multilingual date conversion and calendar generation tool by Dakidarts. Instantly convert Ethiopian to Gregorian dates, get full-month calendars, support 100+ languages, and handle timezones with ease. Available exclusively on RapidAPI.

The API caters to a wide range of programming languages, including but not limited to: C, Clojure, C#, GO, Java, JavaScript, Kotlin, Node.js, Objective-C, OCaml, PHP, PowerShell, Python, R, RapidQL, Ruby, Shell, and Swift.

Subscribe to Ethiopian Calendar API

Introduction

API Overview

The Ethiopian Calendar API by Dakidarts provides a simple yet powerful way to work with dates in the Ethiopian calendar system — one of the world’s most ancient and culturally rich time systems.
Whether you’re building a global app, an Ethiopian date converter, or a multilingual calendar, this API lets you convert dates between the Ethiopian and Gregorian calendars, generate full-month calendars, and retrieve contextual information about the Ethiopian year — all in real time.

Built for precision, translation flexibility, and ease of integration, this API supports both GET and POST requests and delivers JSON-formatted responses for seamless cross-platform use.

Key Features:

🔁 Date Conversion Made Easy
Instantly convert between Ethiopian and Gregorian calendars in both directions.
🗓 Full-Month Calendar Generation
Get a complete Ethiopian or Gregorian month view with each day’s corresponding date in the other calendar system.
🌍 Timezone Support
Handle conversions in your preferred timezone for accurate local results.
💬 Multilingual Translation (100+ Languages)
Translate month and day names using Google Translate — supporting Amharic, English, French, Arabic, Swahili, and many more.
📅 Current Date Retrieval
Retrieve today’s Ethiopian and Gregorian date details, optionally adjusted for a specific timezone.
📖 Calendar Insights
Access information such as whether a given Ethiopian year is a leap year and view structured year summaries.
🚀 RESTful Integration
Fast, reliable, and built to scale — ideal for mobile, web, or analytics applications.

Additional Highlights:

Developed and maintained by Dakidarts — creators of APIs that bridge technology, culture, and consciousness.
Fully documented and accessible through RapidAPI, ensuring developer-friendly onboarding and testing.
Responses are lightweight JSON, optimized for both speed and readability.
Each endpoint is localized with translation and timezone support for global integration.
Version: v1.0.0 (stable release)

Endpoints

/input

Endpoints Overview

Ethiopian date to Gregorian

Converts a given Ethiopian date to its Gregorian equivalent.

Methods: GET, POST

Parameters:

Name	Type	Required	Description
`year`	Integer	✅ Yes	Ethiopian year (e.g. `2017`)
`month`	Integer	✅ Yes	Ethiopian month number (1–13)
`day`	Integer	✅ Yes	Ethiopian day number (1–30, or ≤6 for month 13)
`lang`	String	❌ Optional	Language code (ISO 639-1) for translated day/month names

Example GET:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/to-gregorian"
querystring = {"year":"2017","month":"2","day":"14"}
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"input": {"year": 2017, "month": 2, "day": 14},
"gregorian_date": "2025-10-23",
"day_of_week": "Thursday"
}

Gregorian date to Ethiopian

Converts a Gregorian date into the Ethiopian calendar system.

Methods: GET, POST

Parameters

Name	Type	Required	Description
`date`	String	✅ Yes	Gregorian date in ISO format (e.g. `2025-10-24`)
`lang`	String	❌ Optional	Target language for translation

Example GET:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/to-ethiopian"
querystring = {"date":"2025-10-24"}
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"input": "2025-10-24",
"ethiopian_date": {"year": 2018, "month": 2, "day": 16},
"month_name": "Tikimt",
"day_of_week": "Friday"
}

Current Date

Returns today’s date in both Ethiopian and Gregorian formats, with optional timezone adjustment.

Methods: GET

Parameters

Name	Type	Required	Description
`tz`	String	❌ Optional	Timezone name (e.g. `Africa/Addis_Ababa`)
`lang`	String	❌ Optional	Target language for month/day translations

Example GET:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/current-date"
querystring = {"tz":"Africa/Addis_Ababa"}
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"gregorian_today": "2025-10-24",
"ethiopian_today": {
"year": 2018,
"month": 2,
"day": 16,
"month_name": "Tikimt"
},
"day_of_week": "Friday"
}

Is Ethiopian Leap Year

Checks whether a given Ethiopian year is a leap year.

Methods: GET

Parameters

Name	Type	Required	Description
`year`	Integer	✅ Yes	Ethiopian year to evaluate

Example GET:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/is-leap-year"
querystring = {"year":"2019"}
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"year": 2019,
"is_leap": true,
"explanation": "Ethiopian leap years occur every 4 years, one year before Gregorian leap years."
}

Get Ethiopian Calendar Info

Returns essential information about the current Ethiopian year, including leap year status and month breakdown.

Methods: GET

Parameters

Name	Type	Required	Description
lang	String	❌ No	Language for translated results

Example GET:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/calendar-info"
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers)
print(response.json())

Response Example:

{
"year": 2018,
"months": [
{"name": "Meskerem", "days": 30},
{"name": "Tikimt", "days": 30},
...
{"name": "Pagumen", "days": 5}
],
"is_leap": false,
"difference_from_gregorian_years": 7,
"description": "The Ethiopian calendar has 13 months, with the 13th month (Pagumen) having 5 or 6 days."
}

Ethiopian Month Calendar

Returns the complete Ethiopian month calendar with corresponding Gregorian dates for each day.

Methods: GET, POST

Parameters

Name	Type	Required	Description
`year`	Integer	✅ Yes	Ethiopian year
`month`	Integer	✅ Yes	Ethiopian month number (1–13)
`lang`	String	❌ Optional	Target translation language
`tz`	String	❌ Optional	Timezone (e.g. `Africa/Addis_Ababa`)

Example GET:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/full-month"
querystring = {"year":"2017","month":"2","tz":"Africa/Addis_Ababa"}
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"ethiopian_year": 2017,
"ethiopian_month": 2,
"month_name": "Tikimt",
"days": [
{"ethiopian_day": 1, "gregorian_date": "2025-10-08", "day_of_week": "Wednesday"},
...
{"ethiopian_day": 30, "gregorian_date": "2025-11-06", "day_of_week": "Thursday"}
]
}

Gregorian Month Calendar

Generates a Gregorian month calendar with each day’s Ethiopian date equivalent — ideal for cultural or dual-date calendars.

Methods: GET, POST

Parameters

Name	Type	Required	Description
`year`	Integer	✅ Yes	Gregorian year
`month`	Integer	✅ Yes	Gregorian month (1–12)
`lang`	String	❌ Optional	Translation language code
`tz`	String	❌ Optional	Timezone adjustment

Example GET:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/full-month/gregorian"
querystring = {"year":"2025","month":"10","tz":"Asia/Tokyo"}
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

import requests
url = "https://ethiopian-calendar-api.p.rapidapi.com/full-month/gregorian"
querystring = {"year":"2025","month":"10","tz":"Asia/Tokyo"}
headers = {
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
"x-rapidapi-host": "ethiopian-calendar-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Subscribe to Ethiopian Calendar API

Subscribe on RapidAPI

Head over to our API listing on RapidAPI and click the “Subscribe” button. Choose a plan that fits your needs — from free testing to full-scale production.

Get Your API Key

Once subscribed, grab your unique X-RapidAPI-Key from the "Endpoints" tab. You’ll use this key to authenticate all your requests securely.

Start Making Requests

Use the provided code snippets or integrate directly into your app. Send requests to any available endpoint and enjoy seamless access to our powerful API features.

Ethiopian Calendar API

API

Ethiopian Calendar API

Introduction

API Overview

Key Features:

Additional Highlights:

Endpoints

Endpoints Overview

Ethiopian date to Gregorian

Gregorian date to Ethiopian

Current Date

Is Ethiopian Leap Year

Get Ethiopian Calendar Info

Ethiopian Month Calendar

Gregorian Month Calendar

Subscribe on RapidAPI

Get Your API Key

Start Making Requests

Frequently Asked Questions

What is the Ethiopian Calendar API used for?

Does it support timezones?

How many languages does it support?

Is this API free to use?

Can I use both GET and POST methods?

Let's Get Started Today!