get

/api/v1/chinese-calendar/months/{year}

Get lunar months for a year

Overview

Returns all lunar months for a Chinese year, including leap months if present. Each month includes start/end dates and the traditional Chinese name.

Parameters

Name	Type	In	Required	Description
`year`	string	path	Yes	Gregorian year (1900-2100)

Response

200 — Lunar months for the year

year integer required

months array required

array of object

monthNumber integer required

isLeapMonth boolean required

name object required

chinese string required
pinyin string required
meaning string

startDate string required

endDate string required

days integer required

Example Request

cURL

curl "https://api.almuten.io/api/v1/chinese-calendar/months/{year}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "year": 0,
  "months": [
    {
      "monthNumber": 1,
      "isLeapMonth": true,
      "name": {
        "chinese": "",
        "pinyin": "",
        "meaning": ""
      },
      "startDate": "",
      "endDate": "",
      "days": 29
    }
  ]
}