Kundli PDF Report API

A client-ready kundli as a PDF, under your name, logo and colour

POST/v1/reports/kundli.pdf

10 credits · Secret key (test or live) · getKundliReport

Needs a birth time. Charts, avakhada, planets, Vimshottari mahadashas, yogas and doshas. With lang hi the labels and tables are Hindi; yoga rules and dosha notes stay in English, because we hold no reviewed Hindi for them. Nothing is stored.

Request body

• birth Birth required
  • date string (date) required

    e.g. "1990-08-13"

  • time string

    pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"

  • time_accuracy string

    With "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.

    one of exact, approximate, unknown · default "exact"

  • place Coordinates or object or object required

    Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.

    One of:

    1. Coordinates
       Fields

       • latitude number required

         ≥ -90 · ≤ 90

       • longitude number required

         ≥ -180 · ≤ 180

       No other fields are accepted.

    2. object
       Fields

       • place_id string required

       No other fields are accepted.

    3. object
       Fields

       • query string required

         at least 2 characters · at most 120 characters

       No other fields are accepted.

  • timezone string

    "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".

    default "auto"

  No other fields are accepted.

• brand object required
  • name string required

    Printed at the top of every page.

    at least 1 characters · at most 80 characters

  • tagline string

    at most 120 characters

  • contact string

    Printed at the foot of every page.

    at most 120 characters

  • color string

    Accent colour, as #rrggbb.

    pattern ^#[0-9a-fA-F]{6}$

  • logo_base64 string

    A PNG or JPEG in base64, up to about 150 KB.

    at most 200000 characters

  No other fields are accepted.

• client_name string

  at least 1 characters · at most 80 characters

• lang string

  one of en, hi · default "en"

• style string

  one of north, south · default "north"

No other fields are accepted.

Response

application/pdf

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/reports/kundli.pdf' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"brand":{"name":"Sample Jyotish Studio","contact":"hello@example.com","color":"#1f4e79"},"client_name":"Sample Client","lang":"en"}'

const res = await fetch("https://api.astrologics.in/v1/reports/kundli.pdf", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "brand": {
      "name": "Sample Jyotish Studio",
      "contact": "hello@example.com",
      "color": "#1f4e79"
    },
    "client_name": "Sample Client",
    "lang": "en"
  }),
});
console.log(await res.text());

import json
import urllib.error
import urllib.request

body = {
    "birth": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
    "brand": {
        "name": "Sample Jyotish Studio",
        "contact": "hello@example.com",
        "color": "#1f4e79",
    },
    "client_name": "Sample Client",
    "lang": "en",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/reports/kundli.pdf",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(res.read().decode())
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

<?php
$ch = curl_init('https://api.astrologics.in/v1/reports/kundli.pdf');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"brand":{"name":"Sample Jyotish Studio","contact":"hello@example.com","color":"#1f4e79"},"client_name":"Sample Client","lang":"en"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

Returns a PDF document. Save the response body as a file.

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON){ "birth": { "date": "1990-08-13", "time": "06:30", "place": { "latitude": 28.6139, "longitude": 77.209 } }, "brand": { "name": "Sample Jyotish Studio", "contact": "hello@example.com", "color": "#1f4e79" }, "client_name": "Sample Client", "lang": "en" }

Send