Chandramasa List

The Chandramasa List API returns the Amanta and Purnimanta Chandramasa for each day of a given month and year, based on the provided geographic location and timezone.

API Endpoint

POST https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list

Returns the Chandramasa list for the requested month and location.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token, eg: `Bearer {token}`

Request Body

Name	Type	Description
api_key*	String	Your API key
month*	Integer	Month for which Chandramasa is required (01–12), eg: 05
year*	Integer	Year for which Chandramasa is required, eg: 2023
lat*	Float	Latitude of the location, eg: 28.6139
lon*	Float	Longitude of the location, eg: 77.2090
tzone*	Float	Timezone of the location, eg: 5.5
place*	String	Location name, eg: New Delhi

200: OK Chandramasa List Fetched Successfully

{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": [
        {
            "date": "2023-05-01",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-02",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-03",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-04",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-05",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-06",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-07",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-08",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-09",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-10",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-11",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-12",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-13",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-14",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-15",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-16",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-17",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-18",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-19",
            "chandramasa": [
                {
                    "month": "Vaisakh",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-20",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-21",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-22",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-23",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-24",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-25",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-26",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-27",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-28",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-29",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-30",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        },
        {
            "date": "2023-05-31",
            "chandramasa": [
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Amanta"
                },
                {
                    "month": "Jyeshtha",
                    "adhik": false,
                    "type": "Purnimanta"
                }
            ]
        }
    ]
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list' \
--header 'Authorization: Bearer {token}' \
--form 'api_key="Your API Key"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"' \
--form 'place="New Delhi"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list',
  'headers': {
    'Authorization': 'Bearer {token}'
  },
  formData: {
    'api_key': 'Your API Key',
    'month': '05',
    'year': '2023',
    'lat': '28.6139',
    'lon': '77.2090',
    'tzone': '5.5',
    'place': 'New Delhi'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "Your API Key");
form.append("month", "05");
form.append("year", "2023");
form.append("lat", "28.6139");
form.append("lon", "77.2090");
form.append("tzone", "5.5");
form.append("place", "New Delhi");

var settings = {
  "url": "https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list"

payload = {'api_key': 'Your API Key',
'month': '05',
'year': '2023',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5',
'place': 'New Delhi'}
files=[

]
headers = {
  'Authorization': 'Bearer {token}'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Implementation Notes

Chandramasa calculations depend on location and timezone, so accurate latitude, longitude, and tzone are required.

Both Amanta and Purnimanta systems are returned for each date when applicable.

Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely.

Always validate API responses and handle 4xx/5xx errors gracefully.

curl -X POST "https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list" \ -H "Authorization: Bearer {token}" \ --form 'api_key="Your API Key"' \ --form 'month="05"' \ --form 'year="2023"' \ --form 'lat="28.6139"' \ --form 'lon="77.2090"' \ --form 'tzone="5.5"' \ --form 'place="New Delhi"'

import requests url = "https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list" headers = { "Authorization": "Bearer {token}", } payload = { "api_key": "Your API Key", "month": "05", "year": "2023", "lat": "28.6139", "lon": "77.2090", "tzone": "5.5", "place": "New Delhi", } response = requests.post(url, headers=headers, data=payload) print(response.json())

<?php use GuzzleHttp\Client; $client = new Client(); $response = $client->request('POST', 'https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list', [ 'headers' => [ 'Authorization' => 'Bearer {token}', ], 'multipart' => [ ['name' => 'api_key', 'contents' => 'Your API Key'], ['name' => 'month', 'contents' => '05'], ['name' => 'year', 'contents' => '2023'], ['name' => 'lat', 'contents' => '28.6139'], ['name' => 'lon', 'contents' => '77.2090'], ['name' => 'tzone', 'contents' => '5.5'], ['name' => 'place', 'contents' => 'New Delhi'], ], ]); echo $response->getBody();

package main import ( "bytes" "fmt" "mime/multipart" "net/http" "io" ) func main() { body := &bytes.Buffer{} writer := multipart.NewWriter(body) writer.WriteField("api_key", "Your API Key") writer.WriteField("month", "05") writer.WriteField("year", "2023") writer.WriteField("lat", "28.6139") writer.WriteField("lon", "77.2090") writer.WriteField("tzone", "5.5") writer.WriteField("place", "New Delhi") writer.Close() req, _ := http.NewRequest("POST", "https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list", body) req.Header.Set("Content-Type", writer.FormDataContentType()) req.Header.Set("Authorization", "Bearer {token}") client := &http.Client{} resp, _ := client.Do(req) defer resp.Body.Close() body2, _ := io.ReadAll(resp.Body) fmt.Println(string(body2)) }

import okhttp3.*; import java.io.IOException; public class Main { public static void main(String[] args) throws IOException { OkHttpClient client = new OkHttpClient(); RequestBody body = new MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("api_key", "Your API Key") .addFormDataPart("month", "05") .addFormDataPart("year", "2023") .addFormDataPart("lat", "28.6139") .addFormDataPart("lon", "77.2090") .addFormDataPart("tzone", "5.5") .addFormDataPart("place", "New Delhi") .build(); Request request = new Request.Builder() .url("https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list") .post(body) .addHeader("Authorization", "Bearer {token}") .build(); Response response = client.newCall(request).execute(); System.out.println(response.body().string()); } }

import Foundation let url = URL(string: "https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list")! var request = URLRequest(url: url) request.httpMethod = "POST" request.setValue("Bearer {token}", forHTTPHeaderField: "Authorization") let boundary = "Boundary-\(UUID().uuidString)" request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type") var bodyData = Data() bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!) bodyData.append("Your API Key\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"month\"\r\n\r\n".data(using: .utf8)!) bodyData.append("05\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"year\"\r\n\r\n".data(using: .utf8)!) bodyData.append("2023\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"lat\"\r\n\r\n".data(using: .utf8)!) bodyData.append("28.6139\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"lon\"\r\n\r\n".data(using: .utf8)!) bodyData.append("77.2090\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"tzone\"\r\n\r\n".data(using: .utf8)!) bodyData.append("5.5\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"place\"\r\n\r\n".data(using: .utf8)!) bodyData.append("New Delhi\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!) request.httpBody = bodyData let task = URLSession.shared.dataTask(with: request) { data, response, error in if let data = data { print(String(data: data, encoding: .utf8) ?? "") } } task.resume()

import okhttp3.* fun main() { val client = OkHttpClient() val body = MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("api_key", "Your API Key") .addFormDataPart("month", "05") .addFormDataPart("year", "2023") .addFormDataPart("lat", "28.6139") .addFormDataPart("lon", "77.2090") .addFormDataPart("tzone", "5.5") .addFormDataPart("place", "New Delhi") .build() val request = Request.Builder() .url("https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list") .post(body!!) .addHeader("Authorization", "Bearer {token}") .build() client.newCall(request).execute().use { response -> println(response.body?.string()) } }

using System; using System.Net.Http; using System.Threading.Tasks; class Program { static async Task Main() { using var client = new HttpClient(); client.DefaultRequestHeaders.Add("Authorization", "Bearer {token}"); var content = new MultipartFormDataContent(); content.Add(new StringContent("Your API Key"), "api_key"); content.Add(new StringContent("05"), "month"); content.Add(new StringContent("2023"), "year"); content.Add(new StringContent("28.6139"), "lat"); content.Add(new StringContent("77.2090"), "lon"); content.Add(new StringContent("5.5"), "tzone"); content.Add(new StringContent("New Delhi"), "place"); var response = await client.PostAsync("https://astroapi-8.divineapi.com/indian-api/v1/chandramasa-list", content); var result = await response.Content.ReadAsStringAsync(); Console.WriteLine(result); } }