Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Find Chaitra Festivals

The Chaitra Festivals API returns all major Hindu festivals, vrats, and observances that fall in the lunar month of Chaitra, based on the Panchang. It includes festivals such as Ugadi, Gudi Padwa, Rang Panchami, Ram Navami, Chaitra Navaratri (all 9 days), Sheetla Ashtami, Kamada Ekadashi, and more, along with important muhurats like abhishekam times, parana windows, and ghatasthapana timings.


Step by Step Find Chaitra Festivals API Postman Testing Integration

https://support.divineapi.com/indian-astrology-apis/testing-festival-api-find-chaitra-festivals-api-using-postman


API Endpoint

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

Returns all festival details from the month of Chaitra.


Headers

NameTypeDescription
Authorization*StringYour API access token, e.g. Bearer {token}

Request Body

NameTypeDescription
api_key*StringYour API key
year*IntegerYear, e.g., 2023
placeStringPlace, e.g., New Delhi
lat*FloatLatitude, e.g., 28.6139
lon*FloatLongitude, e.g., 77.2090
tzone*FloatTimezone, e.g., 5.5Timezone List

200: OK Fetched Chaitra festivals successfully

{
    "success": 1,
    "data": {
        "year": "2023",
        "sheetla_ashtami": {
            "date": "2023-03-15",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Sheetla%20Ashtami.png"
        },
        "papamochani_ekadashi": {
            "smartas": {
                "date": "2023-03-18",
                "parana": {
                    "start_time": "2023-03-19 06:27:22",
                    "end_time": "2023-03-19 08:07:00"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Papamochani%20Ekadashi.png"
            },
            "vaishnavas": {
                "date": "2023-03-18",
                "parana": {
                    "start_time": "2023-03-19 06:27:22",
                    "end_time": "2023-03-19 08:07:00"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Papamochani%20Ekadashi.png"
            }
        },
        "rang_panchami": {
            "date": "2023-03-12",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Rang%20Panchami.png"
        },
        "ugadi": {
            "date": "2023-03-22",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Ugadi.png"
        },
        "gudi_padwa": {
            "date": "2023-03-22",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Gudi%20Padwa.png"
        },
        "gangaur": {
            "date": "2023-03-24",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Gangaur.png"
        },
        "yamuna_chhath": {
            "date": "2023-03-27",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Yamuna%20Chhath.png"
        },
        "ram_navami": {
            "date": "2023-03-30",
            "ram_abhishekam_muhurat": {
                "start_time": "2023-03-30 11:11:36",
                "end_time": "2023-03-30 13:41:36"
            },
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Ram%20Navami.png"
        },
        "kamada_ekadashi": {
            "smartas": {
                "date": "2023-04-01",
                "parana": {
                    "start_time": "2023-04-02 13:40:39",
                    "end_time": "2023-04-02 16:10:39"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Kamada%20Ekadashi.png"
            },
            "vaishnavas": {
                "date": "2023-04-01",
                "parana": {
                    "start_time": "2023-04-02 13:40:39",
                    "end_time": "2023-04-02 16:10:39"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Kamada%20Ekadashi.png"
            }
        },
        "hanuman_jayanti": {
            "date": "2023-04-06",
            "hanumat_abhishekam": {
                "start_time": "2023-04-06 04:34:35",
                "end_time": "2023-04-06 07:38:35"
            },
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Hanuman%20Jayanti.png"
        },
        "chaitra_purnima": {
            "date": "2023-04-06",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Yamuna%20Chhath.png"
        },
        "chaitra_navaratri": {
            "pratipada": {
                "date": "2023-03-22",
                "puja": "Shailputri Puja",
                "ghatasthapana_muhurat": [
                    [
                        "2023-03-22 06:23:54",
                        "2023-03-22 10:27:14"
                    ]
                ],
                "ghatasthapana_abhijit_muhurat": [],
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Ghatasthapana%2C%20Shailputri%20Puja.png"
            },
            "dwitiya": {
                "date": "2023-03-23",
                "puja": "Brahmacharini Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Dwitiya%2C%20Brahmacharini%20Puja.png"
            },
            "tritiya": {
                "date": "2023-03-24",
                "puja": "Chandraghanta Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Tritiya%2C%20Chandraghanta%20Puja.png"
            },
            "chaturthi": {
                "date": "2023-03-25",
                "puja": "Kushmanda Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Chaturthi%2C%20Kushmanda%20Puja.png"
            },
            "panchami": {
                "date": "2023-03-26",
                "puja": "Skandamata Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Panchami%2C%20Skandamata%20Puja.png"
            },
            "shashthi": {
                "date": "2023-03-27",
                "puja": "Katyayani Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Shashthi%2C%20Katyayani%20Puja.png"
            },
            "saptami": {
                "date": "2023-03-28",
                "puja": "Kalaratri Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Saptami%2C%20Kalaratri%20Puja.png"
            },
            "ashtami": {
                "date": "2023-03-29",
                "puja": "Mahagauri Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Ashtami%2C%20Mahagauri%20Puja.png"
            },
            "navami": {
                "date": "2023-03-30",
                "puja": "Sandhi Puja",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Navami%2C%20Sandhi%20Puja.png"
            }
        }
    }
}

Example Implementations

Below are corrected, ready-to-run samples for cURL, NodeJS, JavaScript (jQuery AJAX), and Python.


cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals' \
--header 'Authorization: ' \
--form a'api_key="{Your API Key}"' \
--form 'year="2023"' \
--form 'Place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"'

NodeJS

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

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals",
  "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/chaitra-festivals"

payload = {'api_key': '{Your API Key}',
'year': '2023',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5'}

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

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

print(response.text)


Implementation Notes

Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.

Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).

Check HTTP status codes, log responses, and handle 4xx/5xx errors gracefully.

Defaults are lan=en and house_system=P across the DivineAPI suite; this endpoint does not accept lan/house_system.

Test via Postman first and always use HTTPS for secure communication.

Example Code
curl -X POST "https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals" \
  -H "Authorization: " \
  --form 'a'api_key="{Your"' \
  --form 'year="2023"' \
  --form 'Place="New Delhi"' \
  --form 'lat="28.6139"' \
  --form 'lon="77.2090"' \
  --form 'tzone="5.5"'
const FormData = require('form-data');
const axios = require('axios');

const form = new FormData();
form.append('a'api_key', '{Your');
form.append('year', '2023');
form.append('Place', 'New Delhi');
form.append('lat', '28.6139');
form.append('lon', '77.2090');
form.append('tzone', '5.5');

const response = await axios.post('https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': '',
  }
});

console.log(response.data);
import requests

url = "https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals"
headers = {
    "Authorization": "",
}
payload = {
    "a'api_key": "{Your",
    "year": "2023",
    "Place": "New Delhi",
    "lat": "28.6139",
    "lon": "77.2090",
    "tzone": "5.5",
}

response = requests.post(url, headers=headers, data=payload)

print(response.json())
const formData = new FormData();
formData.append('a'api_key', '{Your');
formData.append('year', '2023');
formData.append('Place', 'New Delhi');
formData.append('lat', '28.6139');
formData.append('lon', '77.2090');
formData.append('tzone', '5.5');

const response = await fetch('https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals', {
  method: 'POST',
  headers: {
      'Authorization': "",
    },
  body: formData,
});

const data = await response.json();
console.log(data);
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals', [
    'headers' => [
        'Authorization' => '',
    ],
    'multipart' => [
        ['name' => 'a'api_key', 'contents' => '{Your'],
        ['name' => 'year', 'contents' => '2023'],
        ['name' => 'Place', 'contents' => 'New Delhi'],
        ['name' => 'lat', 'contents' => '28.6139'],
        ['name' => 'lon', 'contents' => '77.2090'],
        ['name' => 'tzone', 'contents' => '5.5'],
    ],
]);

echo $response->getBody();
package main

import (
    "bytes"
    "fmt"
    "mime/multipart"
    "net/http"
    "io"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    writer.WriteField("a'api_key", "{Your")
    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.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals", body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("Authorization", "")

    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("a'api_key", "{Your")
            .addFormDataPart("year", "2023")
            .addFormDataPart("Place", "New Delhi")
            .addFormDataPart("lat", "28.6139")
            .addFormDataPart("lon", "77.2090")
            .addFormDataPart("tzone", "5.5")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals")
            .post(body)
            .addHeader("Authorization", "")
            .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/chaitra-festivals")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("", 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=\"a'api_key\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("{Your\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)!)
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("a'api_key", "{Your")
        .addFormDataPart("year", "2023")
        .addFormDataPart("Place", "New Delhi")
        .addFormDataPart("lat", "28.6139")
        .addFormDataPart("lon", "77.2090")
        .addFormDataPart("tzone", "5.5")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals")
        .post(body!!)
        .addHeader("Authorization", "")
        .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", "");

        var content = new MultipartFormDataContent();
        content.Add(new StringContent("{Your"), "a'api_key");
        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");

        var response = await client.PostAsync("https://astroapi-3.divineapi.com/indian-api/v2/chaitra-festivals", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}