Astrology API by DivineAPI

Astrology API that returns Vedic (kundli, panchang), Western (natal chart), horoscope, tarot and numerology data as JSON. 300+ endpoints, 125+ white-label PDF report types and hosted MCP servers, for developers building astrology apps, sites and AI assistants.

Verified live against the DivineAPI API on 2 October 2026.

This repo is the hub for DivineAPI on GitHub: what the platform covers, one quickstart per language, and which repo to open next.

300+ endpoints across 8 domains. Calculations use Swiss Ephemeris under a commercial licence; Vedic endpoints are sidereal (Lahiri ayanamsa, fixed), Western endpoints are tropical.

1. Get credentials. Start the 14-day free trial (credit card required to activate the trial), then copy your API key and auth token from the dashboard.

2. Make a call. Every endpoint is a POST with a multipart/form-data body. Send the auth token as a Bearer header and the API key as the api_key form field. The example below returns Vedic basic details (moon sign, nakshatra, tithi and more) for a birth date, time and place.

Runnable files: examples/ (curl, Python, Node.js, PHP).

curl -s -X POST https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN" \
  -F api_key=YOUR_API_KEY \
  -F full_name="Rahul Kumar" -F gender=male \
  -F day=24 -F month=05 -F year=1990 \
  -F hour=14 -F min=40 -F sec=0 \
  -F place="new delhi" -F lat=28.6139 -F lon=77.2090 -F tzone=5.5

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details"
headers = {"Authorization": "Bearer YOUR_AUTH_TOKEN"}
fields = {
    "api_key": "YOUR_API_KEY",
    "full_name": "Rahul Kumar", "gender": "male",
    "day": "24", "month": "05", "year": "1990",
    "hour": "14", "min": "40", "sec": "0",
    "place": "new delhi", "lat": "28.6139", "lon": "77.2090", "tzone": "5.5",
}

# files= sends multipart/form-data, which every DivineAPI endpoint expects
r = requests.post(url, headers=headers, files={k: (None, v) for k, v in fields.items()}, timeout=60)
data = r.json()
if data.get("success") != 1:
    raise SystemExit(data)
print(data["data"]["moonsign"], data["data"]["nakshatra"], data["data"]["tithi"])
# Taurus Krittika Amavasya

Save as basic-astro.mjs (top-level await needs an ES module) and run node basic-astro.mjs.

const url = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details";

const form = new FormData();
const fields = {
  api_key: "YOUR_API_KEY",
  full_name: "Rahul Kumar", gender: "male",
  day: "24", month: "05", year: "1990",
  hour: "14", min: "40", sec: "0",
  place: "new delhi", lat: "28.6139", lon: "77.2090", tzone: "5.5",
};
for (const [k, v] of Object.entries(fields)) form.append(k, v);

const res = await fetch(url, {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_AUTH_TOKEN" },
  body: form,
});
const data = await res.json();
if (data.success !== 1) throw new Error(JSON.stringify(data));
console.log(data.data.moonsign, data.data.nakshatra, data.data.tithi);
// Taurus Krittika Amavasya

<?php
$url = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details";

$fields = [
    "api_key"   => "YOUR_API_KEY",
    "full_name" => "Rahul Kumar", "gender" => "male",
    "day"  => "24", "month" => "05", "year" => "1990",
    "hour" => "14", "min"   => "40", "sec"  => "0",
    "place" => "new delhi", "lat" => "28.6139", "lon" => "77.2090", "tzone" => "5.5",
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $fields, // an array makes cURL send multipart/form-data
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer YOUR_AUTH_TOKEN"],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($data["success"] ?? 0) !== 1) {
    exit(print_r($data, true));
}
echo $data["data"]["moonsign"], " ", $data["data"]["nakshatra"], " ", $data["data"]["tithi"], PHP_EOL;

{
  "success": 1,
  "data": {
    "full_name": "Rahul Kumar",
    "place": "new delhi",
    "timezone": "5.5",
    "sunrise": "1990-05-24 05:25:52",
    "sunset": "1990-05-24 19:09:50",
    "tithi": "Amavasya",
    "paksha": "Krishna",
    "sunsign": "Taurus",
    "moonsign": "Taurus",
    "chandramasa": "Vaishakh",
    "nakshatra": "Krittika",
    "vaar": "Thursday",
    "varna": "Vaishya",
    "yoni": "Mesha",
    "gana": "Rakshasa",
    "nadi": "Anta",
    "yoga": "Atiganda",
    "karana": "Naga",
    "...": "..."
  }
}

Same auth and body format everywhere. Each of these calls was run live; the repo linked in the last column has full samples and real responses.

Hosts are https://<host>.divineapi.com. Use the host shown for each endpoint in the docs; endpoints are not interchangeable between hosts.

More in the docs: SDKs and libraries.

Hosted Model Context Protocol servers (streamable HTTP). Authenticate with the X-Divine-Api-Key and X-Divine-Auth-Token headers.

Example for Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "divineapi-indian": {
      "url": "https://mcp.divineapi.com/indian/mcp",
      "headers": {
        "X-Divine-Api-Key": "YOUR_API_KEY",
        "X-Divine-Auth-Token": "YOUR_AUTH_TOKEN"
      }
    }
  }
}

Setup for Claude Desktop and VS Code: developers.divineapi.com/mcp.

Set the language with the lan form field (default en). DivineAPI uses its own language codes, not ISO 639-1: send ma for Marathi, tm for Tamil and tl for Telugu (the ISO codes mr and te are rejected, and ta means Filipino, not Tamil).

Translator replies can take 25 to 35 seconds, so set your HTTP timeout to at least 60 seconds for those calls.

• Check the body, not only the status. Hosts astroapi-1 to astroapi-5 return HTTP 200 even on errors: success: 1 is OK, 2 is a validation error, 3 is an auth error ({"success":3,"msg":"Invalid authorization token!"}). Hosts astroapi-7, astroapi-8 and pdf return real 4xx codes with status: "error" and an error_code.
• tzone is a decimal offset (5.5 for India, -4 for New York in summer), not +5:30 and not a zone name. It is not adjusted for daylight saving, so send the offset that applied at the birth moment.
• sec is required on birth endpoints. Send 0 if the second is unknown.
• place in lowercase (new delhi). lat and lon drive the calculation.
• Dates are three fields: day, month, year.
• Horoscope periods are keywords: h_day=today|tomorrow|yesterday, and current|prev|next for week, month and year.

Each product has its own plans on divineapi.com: Vedic (Vedic Sampoorna, Vedic Ananta, Vedic Prakash), Western (Western Nova, Western Atlas, Western Lumen), Horoscope (Horoscope Starter, Horoscope Pro), Tarot (Tarot Basic, Tarot Essentials, Tarot Gold) and Numerology (Numerology API), plus single-tool plans and white-label PDF reports. Compare what each plan includes at divineapi.com/pricing.

Is there a free trial? Yes, a 14-day free trial (credit card required to activate the trial): divineapi.com/start-trial. Plans and prices are at divineapi.com/pricing.

Which ayanamsa do the Vedic endpoints use? Lahiri, fixed. Western endpoints are tropical.

Which house systems are available for Western charts? 25 house systems through the house_system field; Placidus (P) is the default.

Can I get the chart as an image? Yes, as SVG and base64. Western has a natal wheel chart endpoint and Vedic has divisional chart endpoints (D1, D9, D10 and more, north or south style); see the Western and Indian docs.

Can I generate branded PDF reports? Yes, 125+ white-label PDF report types with your company name, logo and footer. See real samples and the PDF Report API docs.

Is there a Postman collection or OpenAPI spec? Postman: documenter.getpostman.com/view/26759678/2sBYAysU8Y. OpenAPI and the full reference: developers.divineapi.com.

• Docs: developers.divineapi.com
• Changelog: developers.divineapi.com/changelog
• Status: status.divineapi.com
• Help center: support.divineapi.com
• Website: divineapi.com

Terms of the API service: divineapi.com/terms-service.

Code samples in this repository are released under the MIT License (see LICENSE). The DivineAPI name and logo are trademarks of DivineAPI.