Kundli Matching

North Indian 36-point Guna Milan system

POST /v2/astrology/kundli-matching $0.050

Overview

North Indian 36-point Guna Milan system

Request

curl -X POST "https://api.vedika.io/v2/astrology/kundli-matching" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "male": {
      "datetime": "1990-05-15T10:30:00",
      "latitude": 28.6139,
      "longitude": 77.209,
      "timezone": "+05:30"
    },
    "female": {
      "datetime": "1992-03-20T14:00:00",
      "latitude": 19.07,
      "longitude": 72.87,
      "timezone": "+05:30"
    }
  }'

Parameters

Parameter Type Required Description
datetime string Yes Birth date/time in ISO 8601 format
latitude number Yes Birth location latitude (-90 to 90)
longitude number Yes Birth location longitude (-180 to 180)

Response

{
  "success": true,
  "data": {
    // Endpoint-specific response data
  },
  "metadata": {
    "requestId": "req_123456",
    "timestamp": "2026-01-07T00:00:00Z",
    "cost": 0.010
  }
}

Error Handling

{
  "success": false,
  "error": {
    "code": "INVALID_DATETIME",
    "message": "Invalid datetime format. Use ISO 8601.",
    "details": { ... }
  }
}

Rate Limits

  • Free Sandbox: Mock data for testing (no auth required)
  • Starter ($12/mo): 300 credits/month
  • Pro ($60/mo): 1,500 credits/month
  • Business ($120/mo): 3,000 credits/month
  • Enterprise ($240/mo): 6,000 credits/month
  • Enterprise ($240/mo): 6,000 credits + custom limits

SDKs

JavaScript/Node.js

const { VedikaClient } = require('@vedika-io/sdk');

const client = new VedikaClient({ apiKey: 'YOUR_API_KEY' });

async function main() {
  const result = await client.post('/v2/astrology/kundli-matching', {
    male: {
      datetime: '1990-05-15T10:30:00',
      latitude: 28.6139,
      longitude: 77.209,
      timezone: '+05:30'
    },
    female: {
      datetime: '1992-03-20T14:00:00',
      latitude: 19.07,
      longitude: 72.87,
      timezone: '+05:30'
    }
  });
  console.log(result);
}

main().catch(console.error);

Python

from vedika import VedikaClient

client = VedikaClient(api_key="YOUR_API_KEY")
result = client.request("POST", "/v2/astrology/kundli-matching", json={
    "male": {
        "datetime": "1990-05-15T10:30:00",
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "+05:30"
    },
    "female": {
        "datetime": "1992-03-20T14:00:00",
        "latitude": 19.07,
        "longitude": 72.87,
        "timezone": "+05:30"
    }
})
print(result)

Ready to Build with Vedika?

Get your API key and start building astrology features today.