Foreign Travel and Settlement
Illuminate your journey with astrological clarity using the Foreign Travel and Settlement API. This endpoint generates a branded PDF report that analyzes a native’s horoscope for possibilities of foreign travel, overseas opportunities, and long-term settlement abroad within the framework of Indian Astrology.
API Endpoint
POST https://pdf.divineapi.com/indian-api/v2/foreign-travel-settlement
Returns Foreign Travel and Settlement 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, e.g., 24 |
| month* | Integer | Birth month, e.g., 05 |
| year* | Integer | Birth year, e.g., 2023 |
| hour* | Integer | Birth hour, e.g., 14 |
| min* | Integer | Birth minute, e.g., 40 |
| sec* | Integer | Birth second, e.g., 43 |
| gender* | String | Gender, e.g., male |
| place* | String | Birth place, e.g., New Delhi, India |
| lat* | Float | Latitude of birth place, e.g., 28.7041 |
| lon* | Float | Longitude of birth place, e.g., 77.1025 |
| tzone* | Float | Timezone of birth place, e.g., 5.5 (see timezone guide) |
| lan | String | PDF language en/hi, default en |
| company_name* | String | Your company name, e.g., DivineAPI |
| 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 mobile number, e.g., +91 1212 1212 12 |
| company_bio* | String | Company bio/description, must be less than 500 characters |
| logo_url* | String | Company logo URL (PNG only) |
| footer_text* | String | Footer text to display in PDF, must be less than 100 characters |
| text_secondary_color | String | Secondary text color e.g., #7b1300 |
| text_primary_color | String | Primary text color e.g.,#000000 |
| background_color | String | Background color e.g.,#e7d1ac |
| theme_color | String | Theme or accent color e.g.,#ebab3d |
| front_image | String | Size: 1425x2000px e.g., https://reports.divinestore.net/public/assets/img/002/cover.png |
| report_name | String | Display name of the report e.g.,Foreign Travel and Settlement |
| heading_color | String | Heading text color e.g.,#800000 |
Branding & Theme Customization Support
This API allows you to fully customize the appearance and branding of your PDF reports. You can control visual elements such as colors, themes, cover images, report titles, and company branding by passing the relevant parameters in the request body.
Reference Articles:
Custom Themes & Colors
https://support.divineapi.com/reports-apis/enhancing-your-report-with-custom-themes-and-color
Custom Branding
https://support.divineapi.com/reports-apis/enhancing-your-reports-with-custom-branding
200: OK Foreign Travel and Settlement Fetched Successfully
{
"status": "success",
"code": 200,
"data": {
"name": "Rahul Kumar",
"report_url": "https://reports.divinestore.net/r/1143617556960681647632-16",
"download_url": "https://reports.divinestore.net/generate/1143617556960681647632-16"
},
"message": "Foreign travel settlement report generated successfully."
}
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location '
https://pdf.divineapi.com/indian-api/v2/foreign-travel-settlement' \
--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="DivineAPI"' \
--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="DivineAPI"'NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': '
https://pdf.divineapi.com/indian-api/v2/foreign-travel-settlement',
'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': 'DivineAPI',
'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': 'DivineAPI'
}
};
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", "DivineAPI");
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", "DivineAPI");
var settings = {
"url": "https://pdf.divineapi.com/indian-api/v2/foreign-travel-settlement",
"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/indian-api/v2/foreign-travel-settlement"
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': 'DivineAPI',
'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': 'DivineAPI'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Notes
All company/branding fields are mandatory because the PDF is generated as a white-labeled report.
logo_url must point to a publicly accessible PNG.
company_bio must be under 500 characters and footer_text under 100 characters to render correctly.
The API returns both report_url (view online) and download_url (direct download) for easy distribution to end users.