Find Chandramasa

The Find Chandramasa API helps identify the lunar month (Chandramasa) as per the Indian Vedic calendar. It provides insights into the lunar cycle and determines whether the month is Amanta, Purnimanta, or Adhik (Leap), based on the given date, time, and place.

Step-by-Step Postman Testing Integration

For a complete guide on how to test this API using Postman, refer to the official documentation:
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-chandramasa-api-using-postman

Supported Language Codes

This API supports multiple Indian languages for localized responses. You can specify the language by passing the lan parameter in the request body.

Reference Article:
https://support.divineapi.com/general-api-support/translating-an-indian-vedic-apis-into-a-different-language

Code	Language
en	English
hi	Hindi
bn	Bengali
ma	Marathi
tm	Tamil
tl	Telugu
ml	Malayalam
kn	Kannada

Guide:
Include the lan field in the request body to get responses in a different language. Default is 'en'.

Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v2/chandramasa

This endpoint returns the Chandramasa (lunar month) based on the provided date, time, and coordinates.

Headers

Name	Type	Description
Authorization	String	Your API access token. Example: `Bearer {token}`

Request Body

Name	Type	Required	Description
api_key	String	Yes	Your API key.
day	Integer	Yes	Date of input. Example: `24`.
month	Integer	Yes	Month of input. Example: `05`.
year	Integer	Yes	Year of input. Example: `2023`.
place	String	No	Location name. Example: `New Delhi`.
lat	Float	Yes	Latitude of the place. Example: `28.6139`.
lon	Float	Yes	Longitude of the place. Example: `77.2090`.
tzone	Float	Yes	Timezone offset (e.g., `5.5`). See: https://developers.divineapi.com/divine-api/understanding-time-zones-a-comprehensive-guide
lan	String	No	Language code (default `'en'`).
month_type	String	No	Type of lunar month calculation: `amanta`, `purnimanta`, or `both`. Default is `amanta`.

200: OK Planets Chandramasa Table Successfully

{
    "success": 1,
    "data": {
        "date": "2023-05-24",
        "chandramasa": "Jyeshtha",
        "adhik": "false",
        "type": "Amanta"
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/chandramasa' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'Place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"' \
--form 'lan="en"'

Node.js

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v2/chandramasa',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'day': '24',
    'month': '05',
    'year': '2023',
    'Place': 'New Delhi',
    'lat': '28.6139',
    'lon': '77.2090',
    'tzone': '5.5',
    'lan': 'en'
  }
};
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("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("Place", "New Delhi");
form.append("lat", "28.6139");
form.append("lon", "77.2090");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v2/chandramasa",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth 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-3.divineapi.com/indian-api/v2/chandramasa"

payload = {'api_key': '{Your API Key}',
'day': '24',
'month': '05',
'year': '2023',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5',
'lan': 'en'}

headers = {
  'Authorization': Bearer {Your Auth Token}'
}

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

print(response.text)

Notes and Best Practices

Always include both Authorization (Bearer token) and api_key in your requests.

Ensure the latitude, longitude, and timezone accurately represent the location.

The month_type determines which lunar system (Amanta, Purnimanta, or both) is applied.

Responses are localized if the lan parameter is provided.

Use HTTPS only- non-secure endpoints are not supported.

curl -X POST "https://astroapi-3.divineapi.com/indian-api/v2/chandramasa" \ -H "Authorization: Bearer {Your Auth Token}" \ --form 'api_key="{Your API Key}"' \ --form 'day="24"' \ --form 'month="05"' \ --form 'year="2023"' \ --form 'Place="New Delhi"' \ --form 'lat="28.6139"' \ --form 'lon="77.2090"' \ --form 'tzone="5.5"' \ --form 'lan="en"'

import requests url = "https://astroapi-3.divineapi.com/indian-api/v2/chandramasa" headers = { "Authorization": "Bearer {Your Auth Token}", } payload = { "api_key": "{Your API Key}", "day": "24", "month": "05", "year": "2023", "Place": "New Delhi", "lat": "28.6139", "lon": "77.2090", "tzone": "5.5", "lan": "en", } response = requests.post(url, headers=headers, data=payload) print(response.json())

<?php use GuzzleHttp\Client; $client = new Client(); $response = $client->request('POST', 'https://astroapi-3.divineapi.com/indian-api/v2/chandramasa', [ 'headers' => [ 'Authorization' => 'Bearer {Your Auth Token}', ], 'multipart' => [ ['name' => 'api_key', 'contents' => '{Your API Key}'], ['name' => 'day', 'contents' => '24'], ['name' => 'month', 'contents' => '05'], ['name' => 'year', 'contents' => '2023'], ['name' => 'Place', 'contents' => 'New Delhi'], ['name' => 'lat', 'contents' => '28.6139'], ['name' => 'lon', 'contents' => '77.2090'], ['name' => 'tzone', 'contents' => '5.5'], ['name' => 'lan', 'contents' => 'en'], ], ]); 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("day", "24") writer.WriteField("month", "05") writer.WriteField("year", "2023") writer.WriteField("Place", "New Delhi") writer.WriteField("lat", "28.6139") writer.WriteField("lon", "77.2090") writer.WriteField("tzone", "5.5") writer.WriteField("lan", "en") writer.Close() req, _ := http.NewRequest("POST", "https://astroapi-3.divineapi.com/indian-api/v2/chandramasa", body) req.Header.Set("Content-Type", writer.FormDataContentType()) req.Header.Set("Authorization", "Bearer {Your Auth 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("day", "24") .addFormDataPart("month", "05") .addFormDataPart("year", "2023") .addFormDataPart("Place", "New Delhi") .addFormDataPart("lat", "28.6139") .addFormDataPart("lon", "77.2090") .addFormDataPart("tzone", "5.5") .addFormDataPart("lan", "en") .build(); Request request = new Request.Builder() .url("https://astroapi-3.divineapi.com/indian-api/v2/chandramasa") .post(body) .addHeader("Authorization", "Bearer {Your Auth Token}") .build(); Response response = client.newCall(request).execute(); System.out.println(response.body().string()); } }

import Foundation let url = URL(string: "https://astroapi-3.divineapi.com/indian-api/v2/chandramasa")! var request = URLRequest(url: url) request.httpMethod = "POST" request.setValue("Bearer {Your Auth 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=\"day\"\r\n\r\n".data(using: .utf8)!) bodyData.append("24\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=\"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)!) 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=\"lan\"\r\n\r\n".data(using: .utf8)!) bodyData.append("en\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("day", "24") .addFormDataPart("month", "05") .addFormDataPart("year", "2023") .addFormDataPart("Place", "New Delhi") .addFormDataPart("lat", "28.6139") .addFormDataPart("lon", "77.2090") .addFormDataPart("tzone", "5.5") .addFormDataPart("lan", "en") .build() val request = Request.Builder() .url("https://astroapi-3.divineapi.com/indian-api/v2/chandramasa") .post(body!!) .addHeader("Authorization", "Bearer {Your Auth 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 {Your Auth Token}"); var content = new MultipartFormDataContent(); content.Add(new StringContent("{Your API Key}"), "api_key"); content.Add(new StringContent("24"), "day"); content.Add(new StringContent("05"), "month"); content.Add(new StringContent("2023"), "year"); content.Add(new StringContent("New Delhi"), "Place"); 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("en"), "lan"); var response = await client.PostAsync("https://astroapi-3.divineapi.com/indian-api/v2/chandramasa", content); var result = await response.Content.ReadAsStringAsync(); Console.WriteLine(result); } }