Authentication

The Kundli.Click API authenticates API requests via Bearer tokens in the HTTP Authorization header. All API requests must be made over HTTPS.

Base URLs & Environments

We provide a dual-environment setup. The stateless architecture ensures the exact same calculation logic applies to both, but the Sandbox uses cached ephemeris tables to prevent server load.

Environment	Base URL	Key Prefix
Production	https://api.kundli.click/v1/	kndl_sk_live_
Sandbox (Free)	https://sandbox.api.kundli.click/v1/	kndl_sk_test_

Bearer Token Usage

Include your secret key in the Authorization header of your HTTP request. Keys are tied to your billing account (in INR ₹). Do not expose your secret keys in frontend client-side code (e.g., React, Vue). Requests must originate from a backend server.

Security Notice

If GitHub or our automated scanners detect a leaked kndl_sk_live_ key in a public repository, the key will be immediately revoked to prevent billing fraud.

Authentication Errors

If authentication fails, the API returns a 401 Unauthorized response. Common reasons include missing headers, expired keys, or sandbox keys used on production endpoints.

Note: For the full interactive code playground, view this page on a desktop browser.

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API Key provided. Ensure you are passing a Bearer token."
  }
}

curl -X POST https://api.kundli.click/v1/career/stream \ -H "Authorization: Bearer kndl_sk_test_..." \ -H "Content-Type: application/json" \ -d '{ "datetime": "1995-08-15T14:30:00+05:30", "coordinates": { "lat": 28.6139, "lon": 77.2090 } }'

const response = await fetch('https://api.kundli.click/v1/career/stream', { method: 'POST', headers: { 'Authorization': 'Bearer kndl_sk_test_...', 'Content-Type': 'application/json' }, body: JSON.stringify({ datetime: "1995-08-15T14:30:00+05:30", coordinates: { lat: 28.6139, lon: 77.2090 } }) }); const data = await response.json();

<?php $payload = json_encode([ "datetime" => "1995-08-15T14:30:00+05:30", "coordinates" => ["lat" => 28.6139, "lon" => 77.2090] ]); $ch = curl_init('https://api.kundli.click/v1/career/stream'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer kndl_sk_test_...', 'Content-Type: application/json' ] ]); $response = curl_exec($ch); curl_close($ch);

import requests url = "https://api.kundli.click/v1/career/stream" headers = { "Authorization": "Bearer kndl_sk_test_...", "Content-Type": "application/json" } payload = { "datetime": "1995-08-15T14:30:00+05:30", "coordinates": {"lat": 28.6139, "lon": 77.2090} } response = requests.post(url, json=payload, headers=headers) print(response.json())