Astrology API PHP SDK (DivineAPI)

<?php
require 'vendor/autoload.php';

use DivineApi\DivineApi;

$client = new DivineApi('YOUR_API_KEY', 'YOUR_AUTH_TOKEN');

// Daily horoscope for Leo: h_day is 'today', 'tomorrow' or 'yesterday'; tzone is a decimal offset
$result = $client->horoscope()->dailyHoroscope(['sign' => 'leo', 'h_day' => 'today', 'tzone' => 5.5]);

if (($result['success'] ?? 0) !== 1) {
    exit(print_r($result, true));
}
echo $result['data']['sign'], ' ', $result['data']['date'], PHP_EOL;
echo $result['data']['prediction']['luck'][1], PHP_EOL;

// Weekly Horoscope
// week selects the period: 'current', 'prev', or 'next'.
$result = $client->horoscope()->weeklyHoroscope([
    'sign' => 'leo',
    'week' => 'current',
    'tzone' => 5.5,
    'lan' => 'en',
]);

// Yes or No Tarot
$result = $client->horoscope()->yesOrNoTarot(['lan' => 'en']);

// Love Compatibility
$result = $client->horoscope()->loveCompatibility([
    'sign_1' => 'aries',
    'sign_2' => 'leo',
    'lan' => 'en',
]);

// Find Panchang
$result = $client->indian()->panchang()->findPanchang([
    'day' => 15,
    'month' => 3,
    'year' => 2026,
    'place' => 'new delhi',
    'lat' => 28.6139,
    'lon' => 77.2090,
    'tzone' => 5.5,
    'lan' => 'en',
]);

// Grah Gochar (Planet Transit)
$result = $client->indian()->panchang()->grahGochar('saturn', [
    'month' => 3,
    'year' => 2026,
    'place' => 'mumbai',
    'lat' => 19.0760,
    'lon' => 72.8777,
    'tzone' => 5.5,
    'lan' => 'en',
]);

$birthParams = [
    'full_name' => 'John Doe',
    'day' => 15,
    'month' => 6,
    'year' => 1990,
    'hour' => 10,
    'min' => 30,
    'sec' => 0,
    'gender' => 'male',
    'place' => 'new delhi',
    'lat' => 28.6139,
    'lon' => 77.2090,
    'tzone' => 5.5,
    'lan' => 'en',
];

// Basic Astro Details
$result = $client->indian()->kundli()->basicAstroDetails($birthParams);

// Horoscope Chart (D1, D9, etc.)
$result = $client->indian()->kundli()->horoscopeChart('D1', $birthParams);

// Manglik Dosha
$result = $client->indian()->kundli()->manglikDosha($birthParams);

// Vimshottari Dasha
$result = $client->indian()->kundli()->vimshottariDasha(
    array_merge($birthParams, ['dasha_type' => 'maha-dasha'])
);

// Jaimini Swamsa Chart: the Navamsa (D9) chart with the Karakamsha sign as house 1.
// Returns atmakaraka, swamsha_sign, lagnamsha_sign and the chart as svg / base64_image.
$result = $client->indian()->kundli()->jaiminiSwamsaChart($birthParams);

// Lal Kitab Teva
$result = $client->indian()->kundli()->lalKitabTeva($birthParams);

// Lal Kitab Planet Analysis
$result = $client->indian()->kundli()->lalKitabPlanetAnalysis(
    array_merge($birthParams, ['analysis_planet' => 'sun'])
);

// Lal Kitab Varshphal Chart
$result = $client->indian()->kundli()->lalKitabVarshphalChart(
    array_merge($birthParams, ['varshphal_year' => 2026])
);

// Lal Kitab Mahadasha Content (no birth data needed)
$result = $client->indian()->kundli()->lalKitabMahadashaContent([
    'maha_dasha' => 'saturn',
    'lan' => 'en',
]);

// Bhava Analysis
$result = $client->indian()->kundli()->bhavaAnalysis($birthParams);

// Planet Remedies (birth params + analysis_planet)
$result = $client->indian()->kundli()->planetRemedies(
    array_merge($birthParams, ['analysis_planet' => 'sun'])
);

$coupleParams = [
    'p1_full_name' => 'Person One',
    'p1_day' => 15, 'p1_month' => 6, 'p1_year' => 1990,
    'p1_hour' => 10, 'p1_min' => 30, 'p1_sec' => 0,
    'p1_gender' => 'male',
    'p1_place' => 'new delhi', 'p1_lat' => 28.6139, 'p1_lon' => 77.2090, 'p1_tzone' => 5.5,

    'p2_full_name' => 'Person Two',
    'p2_day' => 20, 'p2_month' => 9, 'p2_year' => 1992,
    'p2_hour' => 14, 'p2_min' => 15, 'p2_sec' => 0,
    'p2_gender' => 'female',
    'p2_place' => 'mumbai', 'p2_lat' => 19.0760, 'p2_lon' => 72.8777, 'p2_tzone' => 5.5,

    'lan' => 'en',
];

$result = $client->indian()->matchMaking()->ashtakootMilan($coupleParams);

$festivalParams = [
    'year' => 2026,
    'place' => 'new delhi',
    'lat' => 28.6139,
    'lon' => 77.2090,
    'tzone' => 5.5,
];

// Chaitra Festivals
$result = $client->indian()->festival()->chaitraFestivals($festivalParams);

// Generic Hindu month festivals
$result = $client->indian()->festival()->hinduMonthFestivals('kartika', $festivalParams);

// Find specific festival (festival is a lowercase snake_case slug from the DivineAPI festival list)
$result = $client->indian()->festival()->findFestival(
    array_merge($festivalParams, ['festival' => 'maha_shivratri'])
);

$westernBirth = [
    'full_name' => 'Jane Smith',
    'day' => 22,
    'month' => 7,
    'year' => 1995,
    'hour' => 14,
    'min' => 0,
    'sec' => 0,
    'gender' => 'female',
    'place' => 'london',
    'lat' => 51.5074,
    'lon' => -0.1278,
    'tzone' => 0,
    // house_system accepts a friendly name (placidus, koch, whole-sign, ...) or a
    // single-letter code (P, K, W, ...); the SDK normalises it to the API's letter code.
    'house_system' => 'placidus',
    'lan' => 'en',
];

// Planetary Positions
$result = $client->western()->natal()->planetaryPositions($westernBirth);  // 18 bodies incl. Vertex; see note below

// Natal Wheel Chart
$result = $client->western()->natal()->natalWheelChart($westernBirth);

// Natal Insights
$result = $client->western()->natal()->natalInsights($westernBirth);

// Persona Chart: the chart for the moment, within the first year of life, that the
// transiting Sun reaches the natal degree of persona_planet.
// output_include defaults to "raw_data" (~21 KB); image tokens are ~0.5 MB per SVG
// and output_include = "all" returns ~4.3 MB.
$result = $client->western()->natal()->personaChart(
    $westernBirth + ['persona_planet' => 'moon']
);

// Physical Compatibility
$result = $client->western()->synastry()->physicalCompatibility($coupleParams);

// Harmonious Aspect Reading
$result = $client->western()->synastry()->harmoniousAspectReading($coupleParams);

// Daily Transit
$result = $client->western()->transit()->daily($westernBirth);

// Full Transit
$result = $client->western()->transit()->full($westernBirth);

// The API requires all seven branding fields below on every PDF request
// (a few legacy reports also need company_landline). The SDK treats
// company_mobile as optional, so make sure you pass it.
$reportParams = array_merge($birthParams, [
    'company_name' => 'YOUR_COMPANY_NAME',
    'company_url' => 'YOUR_COMPANY_URL',
    'company_email' => 'YOUR_COMPANY_EMAIL',
    'company_mobile' => 'YOUR_COMPANY_MOBILE',
    'company_bio' => 'YOUR_COMPANY_BIO',
    'logo_url' => 'YOUR_LOGO_URL',
    'footer_text' => 'YOUR_FOOTER_TEXT',
]);

// Kundali Sampoorna Report
$result = $client->pdfReport()->kundaliSampoorna($reportParams);

// Astrology Report with report code (report_code + theme are required, alongside the branding fields above)
$result = $client->pdfReport()->astrologyReport(
    array_merge($reportParams, ['report_code' => 'CAREER-REPORT', 'theme' => '001'])
);

// Loshu Grid
$result = $client->numerology()->loshuGrid([
    'day' => 15,
    'month' => 6,
    'year' => 1990,
    'fname' => 'John',
    'lname' => 'Doe',
    'lan' => 'en',
]);

// Core Numbers
$result = $client->numerology()->coreNumbers([
    'full_name' => 'John Doe',
    'day' => 15,
    'month' => 6,
    'year' => 1990,
    'gender' => 'male',
    'method' => 'chaldean',
]);

$result = $client->lifestyle()->zodiacGiftGuru([
    'sign' => 'virgo',
    'h_day' => 'today',
    'tzone' => 5.5,
    'lan' => 'en',
]);

// FLAMES Calculator
$result = $client->calculator()->flamesCalculator([
    'your_name' => 'John',
    'partner_name' => 'Jane',
]);

// Love Calculator
$result = $client->calculator()->loveCalculator([
    'your_name' => 'John',
    'partner_name' => 'Jane',
    'your_gender' => 'male',
    'partner_gender' => 'female',
]);

use DivineApi\Exceptions\AuthenticationException;
use DivineApi\Exceptions\ValidationException;
use DivineApi\Exceptions\DivineApiException;

try {
    $result = $client->horoscope()->dailyHoroscope([...]);
} catch (AuthenticationException $e) {
    // Invalid API key or auth token (401/403)
    echo "Auth error: " . $e->getMessage();
    print_r($e->getResponseBody());
} catch (ValidationException $e) {
    // Invalid parameters (400/422)
    echo "Validation error: " . $e->getMessage();
    print_r($e->getResponseBody());
} catch (DivineApiException $e) {
    // Any other API error
    echo "API error ({$e->getCode()}): " . $e->getMessage();
}

// Set a 60-second timeout
$client = new DivineApi('api-key', 'auth-token', 60);