get

/api/v1/chinese-calendar/new-year

Get Chinese New Year dates

Overview

Returns Chinese New Year dates for a range of years, including the zodiac animal and element for each year.

Parameters

NameTypeInRequiredDescription
startYearstringqueryNo

Starting year. Defaults to current year.

endYearstringqueryNo

Ending year. Defaults to startYear + 10.

Response

200 — Chinese New Year dates

newYears array required

array of object

gregorianYear integer required
date string required
animal string required
Enum:
RatOxTigerRabbitDragonSnakeHorseGoatMonkeyRoosterDogPig
element string required
Enum:
WoodFireEarthMetalWater

Example Request

cURL
curl "https://api.almuten.io/api/v1/chinese-calendar/new-year" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "newYears": [
    {
      "gregorianYear": 0,
      "date": "",
      "animal": "Rat",
      "element": "Wood"
    }
  ]
}