Natal Couple Report

The Natal Couple Report API generates a detailed, relationship-focused astrological PDF based on the individual natal details of two people. It analyses compatibility, dynamics, and planetary interactions to present a white-labeled, ready-to-share report.

Postman Testing Guide

Testing PDF API – Natal Couple Report Using Postman

API Endpoint

POST https://pdf.divineapi.com/astrology/v1/couple

Returns a Natal Couple PDF 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
p1_full_name*	String	Person 1 full name, e.g., Rahul Kumar
p1_day*	Integer	Person 1 date of birth, e.g., 24
p1_month*	Integer	Person 1 month of birth, e.g., 05
p1_year*	Integer	Person 1 year of birth, e.g., 1998
p1_hour*	Integer	Person 1 hour of birth, e.g., 14
p1_min*	Integer	Person 1 minute of birth, e.g., 40
p1_sec*	Integer	Person 1 second of birth, e.g., 43
p1_gender*	String	Person 1 gender, e.g., male
p1_place*	String	Person 1 birth place, e.g., New Delhi
p1_lat*	Float	Person 1 latitude, e.g., 28.7041
p1_lon*	Float	Person 1 longitude, e.g., 77.1025
p1_tzone*	Float	Person 1 timezone, e.g., 5.5
p2_full_name*	String	Person 2 full name, e.g., Simran Kumari
p2_day*	Integer	Person 2 date of birth, e.g., 10
p2_month*	Integer	Person 2 month of birth, e.g., 12
p2_year*	Integer	Person 2 year of birth, e.g., 1999
p2_hour*	Integer	Person 2 hour of birth, e.g., 14
p2_min*	Integer	Person 2 minute of birth, e.g., 15
p2_sec*	Integer	Person 2 second of birth, e.g., 5
p2_gender*	String	Person 2 gender, e.g., female
p2_place*	String	Person 2 birth place, e.g., New Delhi
p2_lat*	Float	Person 2 latitude, e.g., 28.7041
p2_lon*	Float	Person 2 longitude, e.g., 77.1025
p2_tzone*	Float	Person 2 timezone, e.g., 5.5
lan	String	PDF language. Currently only `en` is available.
company_name*	String	Your company name, e.g., Divine API
company_url*	String	Your full domain URL, e.g., `https://divineapi.com/`
company_email*	String	Your company email, e.g., `admin@divineapi.com`
company_mobile*	String	Your company mobile number, e.g., `+91 1212 1212 12`
company_bio*	String	Company description, must be less than 500 characters
logo_url*	String	Public PNG logo URL to print on the PDF
footer_text*	String	Footer note to print on the PDF, less than 100 characters
report_code*	String	Get valid report codes from: `https://reports.divineapi.com/pdf-codes`
theme	String	Optional theme code; some examples use `theme="001"`

200: OK Match Making PDF fetched successfully

{
    "success": 1,
    "data": {
        "name": "Rahul Kumar",
        "report_url": "https://reports.divinestore.net/r/1189317367569411687173-234",
        "download_url": "https://reports.divinestore.net/generate/1189317367569411687173-234"
    }
}

Example Integrations

Below are language-wise implementation examples.

cURL

curl --location 'https://pdf.divineapi.com/astrology/v1/couple' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'p1_full_name="Rahul Kumar"' \
--form 'p1_day="24"' \
--form 'p1_month="05"' \
--form 'p1_year="1998"' \
--form 'p1_hour="14"' \
--form 'p1_min="40"' \
--form 'p1_sec="43"' \
--form 'p1_lat="28.7041"' \
--form 'p1_lon="77.1025"' \
--form 'p1_tzone="5.5"' \
--form 'p1_gender="male"' \
--form 'p2_place="New Delhi"' \
--form 'p2_full_name="Simran Kumari"' \
--form 'p2_day="10"' \
--form 'p2_month="12"' \
--form 'p2_year="1999"' \
--form 'p2_hour="14"' \
--form 'p2_min="15"' \
--form 'p2_sec="05"' \
--form 'p2_lat="28.7041"' \
--form 'p2_lon="77.1025"' \
--form 'p2_tzone="5.5"' \
--form 'p2_gender="female"' \
--form 'p1_place="New Delhi"' \
--form 'lan="en"' \
--form 'company_name="Divine API"' \
--form 'company_url="https://divineapi.com/"' \
--form 'company_email="admin@divineapi.com"' \
--form 'company_mobile="+91 9557787052"' \
--form 'company_bio="Note Should be less then 500 character, ex: \"Your Company Bio\""' \
--form 'logo_url="https://divineapi.com/assets/logo.png"' \
--form 'footer_text="Note Should be less then 100 character, ex: \"Short note\""' \
--form 'report_code="ALIGNED-ENERGIES-REPORT"' \
--form 'theme="001"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://pdf.divineapi.com/astrology/v1/couple',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'p1_full_name': 'Rahul Kumar',
    'p1_day': '24',
    'p1_month': '05',
    'p1_year': '1998',
    'p1_hour': '14',
    'p1_min': '40',
    'p1_sec': '43',
    'p1_lat': '28.7041',
    'p1_lon': '77.1025',
    'p1_tzone': '5.5',
    'p1_gender': 'male',
    'p2_place': 'New Delhi',
    'p2_full_name': 'Simran Kumari',
    'p2_day': '10',
    'p2_month': '12',
    'p2_year': '1999',
    'p2_hour': '14',
    'p2_min': '15',
    'p2_sec': '05',
    'p2_lat': '28.7041',
    'p2_lon': '77.1025',
    'p2_tzone': '5.5',
    'p2_gender': 'female',
    'p1_place': 'New Delhi',
    'lan': 'en',
    'company_name': 'Divine API',
    'company_url': 'https://divineapi.com/',
    'company_email': 'admin@divineapi.com',
    'company_mobile': '+91 9557787052',
    'company_bio': 'Note Should be less then 500 character, ex: "Your Company Bio"',
    'logo_url': 'https://divineapi.com/assets/logo.png',
    'footer_text': 'Note Should be less then 100 character, ex: "Short note"',
    'report_code': 'ALIGNED-ENERGIES-REPORT',
    'theme': '001'
  }
};
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("p1_full_name", "Rahul Kumar");
form.append("p1_day", "24");
form.append("p1_month", "05");
form.append("p1_year", "1998");
form.append("p1_hour", "14");
form.append("p1_min", "40");
form.append("p1_sec", "43");
form.append("p1_lat", "28.7041");
form.append("p1_lon", "77.1025");
form.append("p1_tzone", "5.5");
form.append("p1_gender", "male");
form.append("p2_place", "New Delhi");
form.append("p2_full_name", "Simran Kumari");
form.append("p2_day", "10");
form.append("p2_month", "12");
form.append("p2_year", "1999");
form.append("p2_hour", "14");
form.append("p2_min", "15");
form.append("p2_sec", "05");
form.append("p2_lat", "28.7041");
form.append("p2_lon", "77.1025");
form.append("p2_tzone", "5.5");
form.append("p2_gender", "female");
form.append("p1_place", "New Delhi");
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 9557787052");
form.append("company_bio", "Note Should be less then 500 character, ex: \"Your Company Bio\"");
form.append("logo_url", "https://divineapi.com/assets/logo.png");
form.append("footer_text", "Note Should be less then 100 character, ex: \"Short note\"");
form.append("report_code", "ALIGNED-ENERGIES-REPORT");
form.append("theme", "001");

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

payload = {'api_key': '{Your API Key}',
'p1_full_name': 'Rahul Kumar',
'p1_day': '24',
'p1_month': '05',
'p1_year': '1998',
'p1_hour': '14',
'p1_min': '40',
'p1_sec': '43',
'p1_lat': '28.7041',
'p1_lon': '77.1025',
'p1_tzone': '5.5',
'p1_gender': 'male',
'p2_place': 'New Delhi',
'p2_full_name': 'Simran Kumari',
'p2_day': '10',
'p2_month': '12',
'p2_year': '1999',
'p2_hour': '14',
'p2_min': '15',
'p2_sec': '05',
'p2_lat': '28.7041',
'p2_lon': '77.1025',
'p2_tzone': '5.5',
'p2_gender': 'female',
'p1_place': 'New Delhi',
'lan': 'en',
'company_name': 'Divine API',
'company_url': 'https://divineapi.com/',
'company_email': 'admin@divineapi.com',
'company_mobile': '+91 9557787052',
'company_bio': 'Note Should be less then 500 character, ex: "Your Company Bio"',
'logo_url': 'https://divineapi.com/assets/logo.png',
'footer_text': 'Note Should be less then 100 character, ex: "Short note"',
'report_code': 'ALIGNED-ENERGIES-REPORT',
'theme': '001'}

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

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

print(response.text)

Notes

All branding fields are mandatory to produce a white-labeled PDF.

report_code must be a valid code from the Divine API report code list.

Logo must be PNG and publicly accessible.

PDF is currently available only in English (lan="en").

Timezone, latitude, and longitude must match the birth place for accurate charts.