Use the Jodiac API

Send the key in either header:

Authorization: Bearer jd_live_YOUR_KEY
X-API-Key: jd_live_YOUR_KEY

Create and revoke keys on the account page. A key is shown once, when you create it. Keep it on your server, never in a web page or an app.

Most calls take the same birth fields. Unknown fields are refused.

No coordinates? Use places search to get them and the time zone from a city name.

Sky and places calls are in the full reference and on the Developers page, where you can try them.

Each plan has credits per period and requests per minute. See pricing. Every answer shows where you stand:

• Calls that fail cost no credits.
• The per-minute limit is counted per account, not per key.

Reports are paid from a prepaid wallet that you top up in the portal. They use no plan credits.

1. Top up the wallet in the portal.
2. Send POST /v1/reports with an Idempotency-Key header. You get 202 and an id.
3. Ask GET /v1/reports/{id} until status is done.
4. Use the download link. It works for five minutes; ask again for a fresh one. The file stays available for 30 days.

curl -X POST https://jodiac.in/v1/reports \
  -H "Authorization: Bearer $JODIAC_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-2026-0001" \
  -d '{"type":"chart","language":"en","people":[{"name":"Asha","date":"1990-05-15","time":"04:00","timezone":"Asia/Kolkata","latitude":19.076,"longitude":72.8777}]}'

Add a web address under Webhooks in the portal. We call it when something happens to your account.

Events include plan.renewed, payment.failed, credits.80, credits.100, spend.cap_reached, invoice.issued and report.completed.

Your address

• It must be https, on a public host name, port 443 or 8443.
• We do not follow redirects and do not read your answer. Any 2xx answer means received.
• If it fails we try again after 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours and 24 hours.

What we send

{"id":"evt_1042","type":"plan.renewed","created":"2026-12-10T00:00:07Z","data":{"plan":"developer","period_end":"2027-01-10T00:00:00+00:00"}}

Check the signature

Every call has a header Jodiac-Signature: t=1700000000,v1=.... The value v1 is the hex HMAC-SHA256 of "{t}." + raw body, made with your secret.

• Refuse messages whose t is more than five minutes old.
• The same event can arrive twice. Use id to ignore repeats.

import hmac, hashlib, time
def valid(secret, header, raw_body):
    parts = dict(p.split("=", 1) for p in header.split(","))
    if abs(time.time() - int(parts["t"])) > 300: return False
    expected = hmac.new(secret.encode(), parts["t"].encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts["v1"])

Errors always look like this:

{"error":{"code":"credits_exhausted","message":"...","request_id":"..."}}

Retry 503 and 429 after the wait we send. Do not retry other 4xx errors without changing the call.

A sandbox key (jd_test_...) always returns the same stored answer with "sandbox": true. It costs nothing and allows 30 requests a minute. It answers only for these samples:

• Cache answers on your side. A birth chart for the same input never changes.
• Birth details are sent in the request body, are used only to answer the call, and are not stored or logged by us.
• Quote the X-Request-ID when you write to us about a call.