Natal Report

Illuminate your journey with astrological clarity using our Natal Report API, generating enlightening and personalized astrological charts in PDF format that shed light on life’s path within the framework of Indian Astrology.

API Endpoint

POST https://pdf.divineapi.com/astrology/v2/report

Returns Natal Report in the response.

Headers

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

Request Body

Name	Type	Description
api_key*	String	Your API key
full_name*	String	Full name of the user, e.g., Rahul Kumar
day*	Integer	Birth date of the user, e.g., 24
month*	Integer	Birth month of the user, e.g., 05
year*	Integer	Birth year of the user, e.g., 2023
hour*	Integer	Birth hour of the user, e.g., 14
min*	Integer	Birth minute of the user, e.g., 40
sec*	Integer	Birth second of the user, e.g., 43
gender*	String	Gender of the user, e.g., male
place*	String	User’s birth place, e.g., New Delhi, India
lat*	Float	Latitude of the birth place, e.g., 28.7041
lon*	Float	Longitude of the birth place, e.g., 77.1025
tzone*	Float	Timezone of the location, e.g., 5.5. See Timezone List
company_name*	String	Your company name, e.g., Divine API
company_url*	String	Your domain full URL, e.g., `https://divineapi.com/`
company_email*	String	Your company email, e.g., `admin@divineapi.com`
company_mobile*	String	Your company contact number, e.g., `+91 1212 1212 12`
company_bio*	String	Company description, less than 500 characters
logo_url*	String	Your company logo URL (PNG only)
footer_text*	String	Footer text, less than 100 characters
lan	String	Language for PDF generation. Currently available only in English.
report_code*	String	Choose report type from Report Codes
theme*	String	Choose theme from Theme Codes

200: OK Natal Report Fetched Successfully

{
    "success": 1,
    "data": {
        "name": "Rahul Kumar",
        "report_url": "report_url",
        "download_url": "download_url"
    }
}

Example Integrations

Below are examples of how you might call this API via cURL, NodeJS, jQuery AJAX, and Python.

cURL

curl --location 'https://pdf.divineapi.com/astrology/v2/report' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Rahul Kumar"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi, India"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \
--form 'company_name="Divine API"' \
--form 'company_url="https://divineapi.com/"' \
--form 'company_email="admin@divineapi.com"' \
--form 'company_mobile="+91 212 1212 12"' \
--form 'company_bio="Discover the best Horoscope API and Tarot API services at Divineapi.com. They offer Daily
Horoscope API for all twelve zodiac signs, along with Indian astrology services like
Panchang, Kundali, and Kundali Matching. Check out their website for more information
and enjoy accurate and engaging astrology insights for your audience!"' \
--form 'logo_url="https://divineapi.com/assets/logo.png"' \
--form 'footer_text="Divine API"' \
--form 'report_code="CAREER-REPORT"' \
--form 'theme="002"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://pdf.divineapi.com/astrology/v2/report',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Rahul Kumar',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi, India',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'lan': 'en',
    'company_name': 'Divine API',
    'company_url': 'https://divineapi.com/',
    'company_email': 'admin@divineapi.com',
    'company_mobile': '+91 212 1212 12',
    'company_bio': 'Discover the best Horoscope API and Tarot API services at Divineapi.com. They offer Daily\nHoroscope API for all twelve zodiac signs, along with Indian astrology services like\nPanchang, Kundali, and Kundali Matching. Check out their website for more information\nand enjoy accurate and engaging astrology insights for your audience!',
    'logo_url': 'https://divineapi.com/assets/logo.png',
    'footer_text': 'Divine API',
    'report_code': 'CAREER-REPORT',
    'theme': '002'
  }
};
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("full_name", "Rahul Kumar");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi, India");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");
form.append("company_name", "Divine API");
form.append("company_url", "https://divineapi.com/");
form.append("company_email", "admin@divineapi.com");
form.append("company_mobile", "+91 212 1212 12");
form.append("company_bio", "Discover the best Horoscope API and Tarot API services at Divineapi.com. They offer Daily
Horoscope API for all twelve zodiac signs, along with Indian astrology services like
Panchang, Kundali, and Kundali Matching. Check out their website for more information
and enjoy accurate and engaging astrology insights for your audience!");
form.append("logo_url", "https://divineapi.com/assets/logo.png");
form.append("footer_text", "Divine API");
form.append("report_code", "CAREER-REPORT");
form.append("theme", "002");

var settings = {
  "url": "https://pdf.divineapi.com/astrology/v2/report",
  "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://pdf.divineapi.com/astrology/v2/report"

payload = {'api_key': '{Your API Key}',
'full_name': 'Rahul Kumar',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',
'company_name': 'Divine API',
'company_url': 'https://divineapi.com/',
'company_email': 'admin@divineapi.com',
'company_mobile': '+91 212 1212 12',
'company_bio': 'Discover the best Horoscope API and Tarot API services at Divineapi.com. They offer Daily
Horoscope API for all twelve zodiac signs, along with Indian astrology services like
Panchang, Kundali, and Kundali Matching. Check out their website for more information
and enjoy accurate and engaging astrology insights for your audience!',
'logo_url': 'https://divineapi.com/assets/logo.png',
'footer_text': 'Divine API',
'report_code': 'CAREER-REPORT',
'theme': '002'}

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

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

print(response.text)

Notes

The Natal Report API supports English PDFs only at this time.

Both report_code and theme are mandatory to customize the report type and design.

All company details (name, email, logo, etc.) are required for white-labeled output.

Ensure the logo URL is a valid, publicly accessible PNG.

The API returns two URLs:

report_url → View report online

download_url → Direct download link