Testing Panchang API - Find Chandrabalam And Tarabalam API Using Postman

The Find Chandrabalam and Tarabalam API is an essential part of the Panchang API suite, designed to provide astrological insights into the lunar (Chandrabalam) and star (Tarabalam) strengths for any given day, based on specific geographical coordinates. Chandrabalam refers to the moon's strength or auspiciousness relative to one's moon sign, while Tarabalam pertains to the auspiciousness of the nakshatras (stars) in relation to one's birth star. This API delineates the favorable and unfavorable signs and nakshatras for current and upcoming periods, facilitating auspicious timing for activities and rituals.

 Last updated : 28 Jan, 2025

1. Securing Your API Key

To start, you need an API key. Head over to https://divineapi.com/ and register to initiate your 7-day trial.

  • Select the APIs you are interested in; you can change these selections at any time. You can add or remove APIs in the future.
  • Click on checkout, fill out the sign-up form, and enter your payment details on the next page.

Your trial will begin immediately. You won't be charged during the trial period, and you can cancel anytime without incurring any charges.

 

2. Importing the Postman Collection

Import our Postman collection to facilitate your API testing:

 

3. Configuring Your API Request

Once the collection is imported:

 

4. Setting Request Parameters

This API call necessitates only your API key. To find your API key.

  • Go to your DivineAPI dashboard > API Key page.
  • Click on “Copy” next to the API key

 Notice the difference between the key, and the Access Token.

 

Go back to Postman to set the parameters.

  • Navigate to “Authorization”, select “Bearer Token” in the Auth type, and then add the token from your Divine API profile.
  • Navigate to 'Body', select 'form_data', and then add:
    • api_key: “<Your_API_Key>” - Your unique API subscription identifier.
    • day: “24” - Enter the date of birth.
    • month: “05” - Enter the month of birth.
    • year: "2023" - The year of interest.
    • place: "New Delhi" - The name of the city.
    • lat: "28.6139" - Latitude for location-specific details.
    • lon: "77.2090" - Longitude for accurate location insights.
    • tzone: "5.5" - Timezone offset from UTC.
    • lan: “en” - Enter the language.
  • Please ensure that the bearer token is exactly the same as in your profile, with no changes in spacing or formatting.

 

5. Making the Request

Hit the 'Send' button to submit your request.

 

6. Deciphering the Response

The API's response will be structured as follows:

{

{
    "success": 1,
    "data": {
        "chandrabalams": {
            "current": [
                "Aries",
                "Gemini",
                "Leo",
                "Virgo",
                "Sagittarius",
                "Capricorn"
            ],
            "upto": "08:27 AM, May 24",
            "next": [
                "Taurus",
                "Cancer",
                "Virgo",
                "Libra",
                "Capricorn",
                "Aquarius"
            ]
        },
        "tarabalams": {
            "current": [
                "Bharani",
                "Rohini",
                "Ardhra",
                "Pushya",
                "Ashlesha",
                "Purva Phalguni",
                "Hasta",
                "Swati",
                "Anuradha",
                "Jyeshtha",
                "Purva Ashada",
                "Shravana",
                "Satabhisha",
                "Uttara Bhadrapada",
                "Revati"
            ],
            "upto": "03:06 PM, May 24",
            "next": [
                "Ashwini",
                "Krittika",
                "Mrigashirsha",
                "Punarvasu",
                "Ashlesha",
                "Magha",
                "Uttara Phalguni",
                "Chitra",
                "Vishakha",
                "Jyeshtha",
                "Moola",
                "Uttara Ashada",
                "Dhanishta",
                "Purva Bhadrapada",
                "Revati"
            ]
        }
    }
}
  • The response provides the current and next sets of auspicious lunar signs (Chandrabalams) and lunar constellations (Tarabalams). 
  • "chandrabalams" lists "current" signs valid until the "upto" time, after which "next" signs become effective.
  •  Similarly, "tarabalams" lists "current" constellations valid until the "upto" time, with "next" constellations becoming effective afterward. 

7. Error Resolution

Ensure your API key is correctly entered if you encounter errors, as most issues are due to invalid or missing API keys.

8. Further Assistance

For additional support or inquiries, feel free to contact our customer service team at admin@divineapi.com.