NAV
bash javascript

Prokerala Astrology Introduction

Prokerala.com is an astrology service provider with over 10 years of web presence. Our experienced team of astrologers and programmers have succeeded in creating an absolutely reliable astrology platform which is today trusted by millions of dedicated users including professional astrologers and ardent astrology enthusiasts.

Prokerala Astrology API is in pursuance of our efforts to make astrology services and information accessable for everyone. Our simple API empowers you to get started with your own astrology services. You'll be up and running in a jiffy!

Getting Started with Prokerala Astrology API.

This API integration guide will help you get started with your astrology website or mobile app in no time. Prokerala * API integration helps you generate custom horoscope, perform horoscope matching, check mangal dosha and much more.

Horoscope Matching

Horoscope matching is the Vedic astrology way of checking compatibility between two individuals comparing their birth charts, analysing the individuals’ personality, their likes, dislikes and attitude towards life. Horoscope matching for marriage is important as it studies all the factors influencing the married life and tells you whether an alliance is favourable or not.

Example request:

curl -X GET -G "https://api.prokerala.com/v1/astrology/horoscope-matching" \
    -H "Authorization: Bearer {token}"
const url = new URL("https://api.prokerala.com/v1/astrology/horoscope-matching");

    let params = {
            "system": "kerala",
            "ayanamsa": "1",
            "bride_dob": "2004-02-12T15:19:21+00:00",
            "bride_coordinates": "10.214747,78.097626",
            "bridegroom_dob": "2004-02-12T15:19:21+00:00",
            "bridegroom_coordinates": "10.214747,78.097626",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Authorization": "Bearer {token}",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "request": {
        "system": "kerala",
        "ayanamsa": "1",
        "bride_dob": "2004-02-01T15:19:21Z",
        "bridegroom_dob": "2019-01-01T15:19:21Z",
        "bride_coordinates": "10.214747,78.097626",
        "bridegroom_coordinates": "10.214747,78.097626",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "average_porutham": 5.5,
        "compatibility": "Madhyama",
        "detailed_information": {
            "dina_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Not Satisfactory",
                "value": 3,
                "comment": "BrideGroom's nakshatra Vishaka is in 12th postion from bride's nakshatra Mrigashirsha."
            },
            "gana_porutham": {
                "bridegroom": "Asura",
                "bride": "Deva",
                "result": "Not Satisfactory",
                "value": 3,
                "comment": "The bride belongs to Deva gana and bridegroom belongs to Asura gana."
            },
            "mahendra_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Not Satisfactory",
                "value": false,
                "comment": "BrideGroom's Nakshatra Vishaka is in 12th position from bride's nakshatra Mrigashirsha."
            },
            "stree_dhrirgham_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Satisfactory",
                "value": 2,
                "comment": "BrideGroom's Nakshatra Vishaka counted from Bride's nakshatra Mrigashirsha is in 12th position."
            },
            "yoni_porutham": {
                "bridegroom": "Male",
                "bride": "Female",
                "result": "Good",
                "value": 1,
                "comment": "BrideGroom's nakshatra belongs to Male yoni and bride's nakshatra belongs to Female yoni."
            },
            "veda_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Good",
                "value": true,
                "comment": "BrideGroom's nakshatra and Bride's nakshatra have no affliction. So there is veda porutham."
            },
            "rajju_porutham": {
                "bridegroom": "Anthima",
                "bride": "Madhyama",
                "result": "Good",
                "value": 1,
                "comment": "BrideGrooms rajju is Anthima and Brides rajju is Madhyama."
            },
            "vasya_porutham": {
                "bridegroom": "Tula",
                "bride": "Vrishabha",
                "result": "Good",
                "value": true,
                "comment": "BrideGroom's rasi is Tula and Bride's rasi is Vrishabha. Here Brides's rasi is the vasya rasi of BrideGrooms rasi."
            },
            "rasi_porutham": {
                "bridegroom": "Tula",
                "bride": "Vrishabha",
                "result": "Not Satisfactory",
                "value": 3,
                "comment": "BrideGroom's rasi is Tula and Bride's rasi is Vrishabha. BrideGroom's rasi  Tula is in 6th position from Bride's rasi Vrishabha."
            },
            "rashyadhipa_porutham": {
                "bridegroom": "Venus",
                "bride": "Venus",
                "result": "Good",
                "value": true,
                "comment": "BrideGrooms rasyadhipan is Venus and brides rasyadhipan is Venus. Venus and Venus are freinds."
            }
        },
        "papa_samaya_result": {
            "bridegroom_papapoints": {
                "ascendant": {
                    "rahu": {
                        "papam": true,
                        "position": 1
                    },
                    "mars": {
                        "papam": 0,
                        "position": 9
                    },
                    "sun": {
                        "papam": 0,
                        "position": 6
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 6
                    }
                },
                "venus": {
                    "saturn": {
                        "papam": true,
                        "position": 2
                    },
                    "sun": {
                        "papam": true,
                        "position": 2
                    },
                    "mars": {
                        "papam": 0,
                        "position": 5
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 9
                    }
                },
                "moon": {
                    "sun": {
                        "papam": 0,
                        "position": 3
                    },
                    "mars": {
                        "papam": 0,
                        "position": 6
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 3
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 10
                    }
                }
            },
            "bride_papapoints": {
                "moon": {
                    "saturn": {
                        "papam": true,
                        "position": 2
                    },
                    "mars": {
                        "papam": true,
                        "position": 12
                    },
                    "rahu": {
                        "papam": true,
                        "position": 12
                    },
                    "sun": {
                        "papam": 0,
                        "position": 9
                    }
                },
                "venus": {
                    "sun": {
                        "papam": true,
                        "position": 12
                    },
                    "mars": {
                        "papam": 0,
                        "position": 3
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 5
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 3
                    }
                },
                "ascendant": {
                    "sun": {
                        "papam": 0,
                        "position": 6
                    },
                    "mars": {
                        "papam": 0,
                        "position": 9
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 11
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 9
                    }
                }
            },
            "papa_status": "Excellent"
        },
        "bridegroom_details": {
            "nakshatra_details": {
                "id": 16,
                "name": "Vishaka",
                "longitude": 206.49354476276642,
                "lord": "Jupiter",
                "pada": 2
            },
            "rasi_details": {
                "id": 6,
                "name": "Tula",
                "longitude": 206.49354476276642,
                "lord": "Shukra(Venus)"
            },
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "256° 47' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "16° 47' "
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "206° 29' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "26° 29' "
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "240° 39' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "39' "
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "210° 0' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "0' "
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "336° 14' ",
                    "is_reverse": false,
                    "position": 11,
                    "degree": "6° 14' "
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "227° 46' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "17° 46' "
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "257° 19' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "17° 19' "
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "93° 24' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "3° 24' "
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "273° 24' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "3° 24' "
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "115° 4' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "25° 4' "
                }
            ]
        },
        "bride_details": {
            "nakshatra_details": {
                "id": 5,
                "name": "Mrigashirsha",
                "longitude": 54.78653600410415,
                "lord": "Mars",
                "pada": 1
            },
            "rasi_details": {
                "id": 1,
                "name": "Vrishabha",
                "longitude": 54.78653600410415,
                "lord": "Shukra (Venus)"
            },
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "288° 11' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "18° 11' "
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "54° 47' ",
                    "is_reverse": false,
                    "position": 1,
                    "degree": "24° 47' "
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "267° 58' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "27° 58' "
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "327° 43' ",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "27° 43' "
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "4° 57' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "4° 57' "
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "143° 42' ",
                    "is_reverse": true,
                    "position": 4,
                    "degree": "23° 42' "
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "73° 28' ",
                    "is_reverse": true,
                    "position": 2,
                    "degree": "13° 28' "
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "22° 6' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "22° 6' "
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "202° 6' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "22° 6' "
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "145° 0' ",
                    "is_reverse": false,
                    "position": 4,
                    "degree": "25° 0' "
                }
            ]
        }
    }
}

HTTP Request

GET v1/astrology/horoscope-matching

Query Parameters

Parameter Status Description
system required {system should be either Kerala or Tamil. Kerala system calculates compatibility based on Kerala system of dasha porutham and Tamil system calculates porutham based on Tamil jathagam porutham principles.}
ayanamsa required {The longitudinal difference between Tropical (Sāyana) and Sidereal (Nirayana) zodiacs. Prokerala Uses Lahiri ayanamsa. Value for ayanamsa parameter is always 1.}}
bride_dob required {Date of birth & time of birth of the bride in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ eg:2004-02-12T15:19:21+00:00 }.
bride_coordinates required {Exact birth location plays an important role in astrological calculations. Birth location in the form of latitude and longitude eg: 10.214747,78.097626}.
bridegroom_dob required {Date of birth & time of birth of the bride in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ eg:2004-02-12T15:19:21+00:00 }.
bridegroom_coordinates required {Exact birth location plays an important role in astrological calculations. Birth location in the form of latitude and longitude eg: 10.214747,78.097626}.

Kundli Matching

The horoscope of an individual is the astrological chart representing the planetary positions and astrological aspects at the time of his birth. Marriage matching is the Vedic astrology way of checking compatibility between two individuals by checking the birth chart of the prospective bride & groom are compared and analysed. This analyses the individuals’ personality, their likes, dislikes and attitude towards life. Horoscope matching for marriage is important as it studies all the factors influencing the married life and tells you whether an alliance is favourable or not. Here, by filling in the below parameters for the API, you can have and accurate marriage compatibility report. Kundali matching is based on ashta kuta system, calculating compatibility out of 36 points. (Gun Milan/Ashtakoot). In Ashtakuta Kundali match, eight different personality aspects of the couple are compared and assigned certain points based on compatibility match. The final result depends on the summation of points assigned to all personality aspects.

Example request:

curl -X GET -G "https://api.prokerala.com/v1/astrology/kundli-matching" \
    -H "Authorization: Bearer {token}"
const url = new URL("https://api.prokerala.com/v1/astrology/kundli-matching");

    let params = {
            "ayanamsa": "1",
            "bride_dob": "2004-02-12T15:19:21+00:00",
            "bride_coordinates": "10.214747,78.097626",
            "bridegroom_dob": "2004-02-12T15:19:21+00:00",
            "bridegroom_coordinates": "10.214747,78.097626",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Authorization": "Bearer {token}",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "request": {
        "ayanamsa": "1",
        "bride_dob": "2004-02-01T15:19:21Z",
        "bridegroom_dob": "2019-01-01T15:19:21Z",
        "bride_coordinates": "10.214747,78.097626",
        "bridegroom_coordinates": "10.214747,78.097626",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "bride_details": {
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "288° 11' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "18° 11' ",
                    "rasi": "Makara",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "54° 47' ",
                    "is_reverse": false,
                    "position": 1,
                    "degree": "24° 47' ",
                    "rasi": "Vrishabha",
                    "rasi_lord": "Shukra (Venus)"
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "267° 58' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "27° 58' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "327° 43' ",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "27° 43' ",
                    "rasi": "Kumbha",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "4° 57' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "4° 57' ",
                    "rasi": "Mesha",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "143° 42' ",
                    "is_reverse": true,
                    "position": 4,
                    "degree": "23° 42' ",
                    "rasi": "Simha",
                    "rasi_lord": "Surya (Sun)"
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "73° 28' ",
                    "is_reverse": true,
                    "position": 2,
                    "degree": "13° 28' ",
                    "rasi": "Mithuna",
                    "rasi_lord": "Budh (Mercury)"
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "22° 6' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "22° 6' ",
                    "rasi": "Mesha",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "202° 6' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "22° 6' ",
                    "rasi": "Tula",
                    "rasi_lord": "Shukra(Venus)"
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "145° 0' ",
                    "is_reverse": false,
                    "position": 4,
                    "degree": "25° 0' ",
                    "rasi": "Simha",
                    "rasi_lord": "Surya (Sun)"
                }
            ],
            "nakshatra_details": {
                "id": 4,
                "name": "Mrigashirsha",
                "longitude": 54.78653600410415,
                "lord": "Mars",
                "pada": -43
            },
            "rasi_details": {
                "id": 1,
                "name": "Vrishabha",
                "longitude": 54.78653600410415,
                "lord": "Shukra (Venus)"
            },
            "varna": {
                "id": 2,
                "name": "Vaishya"
            },
            "vasya": {
                "id": 2,
                "name": "Chatushpada"
            },
            "tara": {
                "id": 2,
                "effect": "benefic",
                "name": "Vipatha",
                "position": 11,
                "point": 1.5
            },
            "yoni": {
                "id": 3,
                "name": "Sarpa"
            },
            "rasi_lord": {
                "id": 3,
                "name": "Venus",
                "moon_rasi_id": 1,
                "moon_rasi": "Vrishabha"
            },
            "gana": {
                "id": 0,
                "name": "Devata"
            },
            "bhakoot": {
                "id": 1,
                "name": "Vrishabha",
                "position": 5
            },
            "nadi": {
                "id": 1,
                "name": "Madhya"
            },
            "manglik_status": 0,
            "mars_current_house": 9,
            "exception_list": null,
            "manglik_exception": 0
        },
        "bridegroom_details": {
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "256° 47' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "16° 47' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "206° 29' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "26° 29' ",
                    "rasi": "Tula",
                    "rasi_lord": "Shukra(Venus)"
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "240° 39' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "39' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "210° 0' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "0' ",
                    "rasi": "Vrischika",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "336° 14' ",
                    "is_reverse": false,
                    "position": 11,
                    "degree": "6° 14' ",
                    "rasi": "Meena",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "227° 46' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "17° 46' ",
                    "rasi": "Vrischika",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "257° 19' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "17° 19' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "93° 24' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "3° 24' ",
                    "rasi": "Karka",
                    "rasi_lord": "Chandra (Moon)"
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "273° 24' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "3° 24' ",
                    "rasi": "Makara",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "115° 4' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "25° 4' ",
                    "rasi": "Karka",
                    "rasi_lord": "Chandra (Moon)"
                }
            ],
            "nakshatra_details": {
                "id": 15,
                "name": "Vishaka",
                "longitude": 206.49354476276642,
                "lord": "Jupiter",
                "pada": 2
            },
            "rasi_details": {
                "id": 6,
                "name": "Tula",
                "longitude": 206.49354476276642,
                "lord": "Shukra(Venus)"
            },
            "varna": {
                "id": 3,
                "name": "Shudra"
            },
            "vasya": {
                "id": 0,
                "name": "Manava"
            },
            "tara": {
                "id": 7,
                "effect": "malefic",
                "name": "Mitra",
                "position": 16,
                "point": 0
            },
            "yoni": {
                "id": 9,
                "name": "Vyagrah"
            },
            "rasi_lord": {
                "id": 3,
                "name": "Venus",
                "moon_rasi_id": 6,
                "moon_rasi": "Tula"
            },
            "gana": {
                "id": 2,
                "name": "Rakshasa"
            },
            "bhakoot": {
                "id": 6,
                "name": "Tula",
                "position": 7
            },
            "nadi": {
                "id": 2,
                "name": "Antya"
            },
            "manglik_status": 0,
            "mars_current_house": 9,
            "exception_list": null,
            "manglik_exception": 0
        },
        "result": {
            "match_status": 2,
            "message": "Union is inauspicious",
            "varna": {
                "bride": "Vaishya",
                "bridegroom": "Shudra",
                "point": 0,
                "message": " Varna represents the working attitude and capacity.  The  bridegroom’s capacity needs to be higher than that of the bride for smooth running of the family. The bridegroom’s varna is Shudra Varna while the bride comes under Vaishya Varna. This type of combination is not very much favorable for a union. For this couple Varna Koot is Not Good. However, if other gunas are matched well, then this alliance may be taken into consideration."
            },
            "vasya": {
                "bride": "Chatushpada",
                "bridegroom": "Manava",
                "point": 1,
                "message": "Vasya was used to determine whether there will be a dedicated and compatible relationship between two people. The bridegroom’s Vasya is Manava Vasya while the bride comes under Chatushpada Vasya. This is a normal match and not excellent or worst. For this couple Vasya Koot is Normal. However, if other gunas are matched well, then this alliance may be taken into consideration."
            },
            "tara": {
                "bride": "Mrigashirsha",
                "bridegroom": "Vishaka",
                "point": 1.5,
                "message": "Tara is used to calculate the health and well-being of the bride and groom after marriage. The bridegroom and bride are in different Tara Group. The bridegroom's nakshatra Vishaka is 16th position from bride's nakshatra Mrigashirsha and this is malefic. At the same time The bride's nakshatra Mrigashirsha is 11th position from bridegroom's nakshatra Vishaka and this is benefic. This is a normal match. For this couple Tara Koot is Normal. But if other gunas are matched well, then this alliance may be taken into consideration."
            },
            "yoni": {
                "bride": "Sarpa",
                "bridegroom": "Vyagrah",
                "point": 2,
                "message": "Yoni indicates the physical and sexual compatibility between a couple.The bridegroom’s Yoni is Vyagrah while the bride comes under Sarpa Yoni. This is a preferable combination. For this couple Yoni Koot is Average."
            },
            "graha_maitri": {
                "bride": "Venus",
                "bridegroom": "Venus",
                "point": 5,
                "message": "Graha Maitri is used to examine the strength of the love between the couple. This is achieved by comparing the sign lords of the moon in the chart of the bride and groom.The bridegroom and the bride both belong to same Rasi Lord Venus.The bridegroom’s Rasi is Tula while the bride's Rasi is Vrishabha. This is so far the best compatible match. For this couple Graha Maitri Koot is Excellent."
            },
            "gana": {
                "bride": "Devata",
                "bridegroom": "Rakshasa",
                "point": 1,
                "message": "Gana is used to identify an individuals temperament.The bridegroom’s Gana is Rakshasa while the bride comes under Devata Gana. This is a preferable combination. For this couple Gana Koot is Average."
            },
            "bhakoot": {
                "bride": "Vrishabha",
                "bridegroom": "Tula",
                "point": 0,
                "message": "Bhakoot or Rashikoot testing is used to verify the overall health, welfare and prosperity of a family after marriage. It is believed that Bhakoot Dosha can affect the intimacy between the couple and cause delays in pregnancy.The bridegroom’s Zodiac sign is Tula while the bride's Zodiac sign is Vrishabha. This is inauspicious combination. For this couple Bhakoot Koot is Not Good."
            },
            "nadi": {
                "bride": "Madhya",
                "bridegroom": "Antya",
                "point": 8,
                "message": "Nadi testing is to check the genetic compatibility of the bride and groom to ensure they are capable of producing healthy children. Nadi Kuot is given supreme priority during match making.The bridegroom belongs to Antya Nadi while the while the bride comes under Madhya Nadi. This is considered to be extremely good combination according to nadi compatibility. For this couple Nadi Koot is Excellent."
            },
            "total_point": 18.5,
            "sub_message": [
                "Horoscope matching shows a low score "
            ]
        }
    }
}

HTTP Request

GET v1/astrology/kundli-matching

Query Parameters

Parameter Status Description
ayanamsa required {In astrology, this is the longitudinal difference between the Tropical (Sāyana) and Sidereal (Nirayana) zodiacs. Prokerala Uses Lahiri ayanamsa. The value for ayanamsa parameter is always 1.}
bride_dob required {Date of birth & Time of birth of bride is required for the calculation. Date and time should be in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ eg:2004-02-12T15:19:21+00:00 }.
bride_coordinates required { At any given point of time, the global position (latitude and longitude) determines the location of various celestial bodies in space. So exact birth location play important role in astrological calculations. Birth location is accepted in the form of latitude and longitude eg: 10.214747,78.097626}.
bridegroom_dob required {Date of birth & Time of birth of bride is required for the calculation. Date and time should be in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ eg:2004-02-12T15:19:21+00:00 }.
bridegroom_coordinates required {At any given point of time, the global position (latitude and longitude) determines the location of various celestial bodies in space. So exact birth location play important role in astrological calculations. Birth location is accepted in the form of latitude and longitude eg: 10.214747,78.097626}.

Planet Position

Example request:

curl -X GET -G "https://api.prokerala.com/v1/astrology/planet-position" \
    -H "Authorization: Bearer {token}"
const url = new URL("https://api.prokerala.com/v1/astrology/planet-position");

    let params = {
            "ayanamsa": "1",
            "chart_type": "`rasi`",
            "datetime": "2004-02-12T15:19:21+00:00",
            "coordinates": "10.214747,78.097626",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Authorization": "Bearer {token}",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2004-02-06T15:19:21Z",
        "coordinates": "13.0878,80.2785",
        "chart_type": "rasi",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "planet_positions": [
            {
                "id": 0,
                "name": "Sun",
                "longitude": "292.44",
                "is_reverse": false,
                "position": 9,
                "degree": "22.44",
                "rasi": "Makara",
                "rasi_lord": "Shani (Saturn)"
            },
            {
                "id": 1,
                "name": "Moon",
                "longitude": "110.3",
                "is_reverse": false,
                "position": 3,
                "degree": "20.3",
                "rasi": "Karka",
                "rasi_lord": "Chandra (Moon)"
            },
            {
                "id": 2,
                "name": "Mercury",
                "longitude": "274.31",
                "is_reverse": false,
                "position": 9,
                "degree": "4.31",
                "rasi": "Makara",
                "rasi_lord": "Shani (Saturn)"
            },
            {
                "id": 3,
                "name": "Venus",
                "longitude": "333.4",
                "is_reverse": false,
                "position": 11,
                "degree": "3.4",
                "rasi": "Meena",
                "rasi_lord": "Guru (Jupiter)"
            },
            {
                "id": 4,
                "name": "Mars",
                "longitude": "7.48",
                "is_reverse": false,
                "position": 0,
                "degree": "7.48",
                "rasi": "Mesha",
                "rasi_lord": "Mangal (Mars)"
            },
            {
                "id": 5,
                "name": "Jupiter",
                "longitude": "143.17",
                "is_reverse": true,
                "position": 4,
                "degree": "23.17",
                "rasi": "Simha",
                "rasi_lord": "Surya (Sun)"
            },
            {
                "id": 6,
                "name": "Saturn",
                "longitude": "73.13",
                "is_reverse": true,
                "position": 2,
                "degree": "13.13",
                "rasi": "Mithuna",
                "rasi_lord": "Budh (Mercury)"
            },
            {
                "id": 101,
                "name": "Rahu",
                "longitude": "21.52",
                "is_reverse": false,
                "position": 0,
                "degree": "21.52",
                "rasi": "Mesha",
                "rasi_lord": "Mangal (Mars)"
            },
            {
                "id": 102,
                "name": "Ketu",
                "longitude": "201.52",
                "is_reverse": false,
                "position": 6,
                "degree": "21.52",
                "rasi": "Tula",
                "rasi_lord": "Shukra(Venus)"
            },
            {
                "id": 100,
                "name": "Ascendant",
                "longitude": "330.48",
                "is_reverse": false,
                "position": 11,
                "degree": "48",
                "rasi": "Meena",
                "rasi_lord": "Guru (Jupiter)"
            }
        ],
        "chart_positions": {
            "0": [
                4,
                10
            ],
            "2": [
                6
            ],
            "3": [
                1
            ],
            "4": [
                5
            ],
            "6": [
                12
            ],
            "9": [
                0,
                2
            ],
            "11": [
                3,
                14
            ]
        },
        "first_house": 1
    }
}

HTTP Request

GET v1/astrology/planet-position

Query Parameters

Parameter Status Description
ayanamsa required {In astrology, this is the longitudinal difference between the Tropical (Sāyana) and Sidereal (Nirayana) zodiacs. Prokerala Uses Lahiri ayanamsa. The value for ayanamsa parameter is always 1.}
chart_type optional {Chart type may be rasi, navamsa, lagna etc.. The default chart_type is rasi chart.}
datetime required {Date and time is required for the calculation. Date and time should be in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ eg:2004-02-12T15:19:21+00:00 }.
coordinates required { At any given point of time, the global position (latitude and longitude) determines the location of various celestial bodies in space. So exact location play important role in astrological calculations. Location is accepted in the form of latitude and longitude eg: 10.214747,78.097626. Panchang may be different for two different places even for the same time. 2019 Panchang USA is different from Panchang UK even though the same time and date is selected. Even places within US may have different Panchang for the same time.}.

Manglik

Mangal dosha or kuja dosha or chovva dosham is the combination in the birth chart or horoscope where Mars (also known as Mangal or Kuja) is placed in the 2nd, 4th, 7th, 8th or 12th house in the Ascendant. A person with mangal dosh in his natal chart is called Manglik.

Example request:

curl -X GET -G "https://api.prokerala.com/v1/astrology/manglik" \
    -H "Authorization: Bearer {token}"
const url = new URL("https://api.prokerala.com/v1/astrology/manglik");

    let params = {
            "ayanamsa": "1",
            "dob": "2004-02-12T15:19:21+00:00",
            "coordinates": "10.214747,78.097626",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Authorization": "Bearer {token}",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2019-04-11T11:02:00+05:30",
        "coordinates": "13.0878,80.2785",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "result": {
            "nakshatra": [
                {
                    "id": 5,
                    "name": "Ardra",
                    "start": "2019-04-11T10:25:44+05:30",
                    "end": "2019-04-12T09:54:17+05:30"
                }
            ],
            "nakshatra_lord": "Rahu",
            "nakshatra_pada": 1,
            "moon_rasi": [
                {
                    "id": 2,
                    "name": "Mithuna",
                    "start": "2019-04-10T22:32:40+05:30",
                    "end": "2019-04-13T03:15:04+05:30"
                }
            ],
            "rasi_lord": "Budh (Mercury)",
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "357.9",
                    "is_reverse": false,
                    "position": 11,
                    "degree": "27.9",
                    "rasi": "Meena",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "70.9",
                    "is_reverse": false,
                    "position": 2,
                    "degree": "10.9",
                    "rasi": "Mithuna",
                    "rasi_lord": "Budh (Mercury)"
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "329.30",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "29.30",
                    "rasi": "Kumbha",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "324.44",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "24.44",
                    "rasi": "Kumbha",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "43.16",
                    "is_reverse": false,
                    "position": 1,
                    "degree": "13.16",
                    "rasi": "Vrishabha",
                    "rasi_lord": "Shukra (Venus)"
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "240.13",
                    "is_reverse": true,
                    "position": 8,
                    "degree": "13",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "266.6",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "26.6",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "88.7",
                    "is_reverse": false,
                    "position": 2,
                    "degree": "28.7",
                    "rasi": "Mithuna",
                    "rasi_lord": "Budh (Mercury)"
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "268.7",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "28.7",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "152.26",
                    "is_reverse": false,
                    "position": 5,
                    "degree": "2.26",
                    "rasi": "Kanya",
                    "rasi_lord": "Budh (Mercury)"
                }
            ],
            "manglik_status": 0,
            "mars_current_house": 9,
            "ascendant_rasi": "Kanya",
            "manglik_exception": 0,
            "exceptions": null
        }
    }
}

HTTP Request

GET /v1/astrology/manglik

Query Parameters

Parameter Status Description
ayanamsa required {In astrology, this is the longitudinal difference between the Tropical (Sāyana) and Sidereal (Nirayana) zodiacs. Prokerala Uses Lahiri ayanamsa. The value for ayanamsa parameter is always 1.}
dob required {Date of birth & Time of birth is required for the calculation. Date and time should be in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ eg:2004-02-12T15:19:21+00:00 }.
coordinates required { At any given point of time, the global position (latitude and longitude) determines the location of various celestial bodies in space. So exact birth location play important role in astrological calculations. Birth location is accepted in the form of latitude and longitude eg: 10.214747,78.097626}.

Panchang

Panchang is a sanskrit word meaning Five Limbs. These five limbs represent five sources of energy, both visible and invisible, as denoted by these segments in a day. Location, Time Zone, Time and Date etc... are very important in determining the accurate panchang for a particular day. Panchangam refers to the five attributes of the day - Tithi (lunar day), Yoga (luni-solar day), Vara (week day), Nakshatra (constellation), and Karana (half of a lunar day).

Example request:

curl -X GET -G "https://api.prokerala.com/v1/astrology/panchang" \
    -H "Authorization: Bearer {token}"
const url = new URL("https://api.prokerala.com/v1/astrology/panchang");

    let params = {
            "ayanamsa": "1",
            "datetime": "2004-02-12T15:19:21+00:00",
            "coordinates": "10.214747,78.097626",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Authorization": "Bearer {token}",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2004-02-06T15:19:21Z",
        "coordinates": "13.0878,80.2785",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "week_day": {
            "id": 5,
            "name": "Friday"
        },
        "nakshatra": [
            {
                "id": 8,
                "name": "Ashlesha",
                "start": "2004-02-05T20:56:13+00:00",
                "end": "2004-02-06T21:49:54+00:00"
            },
            {
                "id": 9,
                "name": "Magha",
                "start": "2004-02-06T21:49:55+00:00",
                "end": "2004-02-07T22:17:25+00:00"
            }
        ],
        "karana": [
            {
                "id": 0,
                "name": "Bava",
                "start": "2004-02-05T20:33:13+00:00",
                "end": "2004-02-06T08:46:56+00:00"
            },
            {
                "id": 1,
                "name": "Balava",
                "start": "2004-02-06T08:46:57+00:00",
                "end": "2004-02-06T20:53:21+00:00"
            },
            {
                "id": 2,
                "name": "Kaulava",
                "start": "2004-02-06T20:53:22+00:00",
                "end": "2004-02-07T08:52:56+00:00"
            }
        ],
        "yoga": [
            {
                "id": 3,
                "name": "Saubhagya",
                "start": "2004-02-05T22:25:37+00:00",
                "end": "2004-02-06T21:29:36+00:00"
            },
            {
                "id": 4,
                "name": "Sobhana",
                "start": "2004-02-06T21:29:37+00:00",
                "end": "2004-02-07T20:12:41+00:00"
            }
        ],
        "tithi": [
            {
                "id": 14,
                "name": "Purnima",
                "start": "2004-02-05T08:11:43+00:00",
                "end": "2004-02-06T08:46:56+00:00",
                "paksha": "Sukla Paksha",
                "type": false
            },
            {
                "id": 15,
                "name": "Pratipada",
                "start": "2004-02-06T08:46:57+00:00",
                "end": "2004-02-07T08:52:56+00:00",
                "paksha": "Krishna Paksha",
                "type": false
            }
        ]
    }
}

HTTP Request

GET https://api.prokerala.com/v1/astrology/panchang

Query Parameters

Parameter Status Description
ayanamsa required {In astrology, this is the longitudinal difference between the Tropical (Sāyana) and Sidereal (Nirayana) zodiacs. Prokerala Uses Lahiri ayanamsa. The value for ayanamsa parameter is always 1.}
datetime required {Date and time is required for the calculation. Date and time should be in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ eg:2004-02-12T15:19:21+00:00 }.
coordinates required { At any given point of time, the global position (latitude and longitude) determines the location of various celestial bodies in space. So exact location play important role in astrological calculations. Location is accepted in the form of latitude and longitude eg: 10.214747,78.097626. Panchang may be different for two different places even for the same time. 2019 Panchang USA is different from Panchang UK even though the same time and date is selected. Even places within US may have different Panchang for the same time.}.

Nakshatra Porutham

It is an essential pre-requisite for a marriage alliance where nakshatra and rasi porutham of both the boy and the girl who plan to get married is checked.It is believed that the better the stars match, the better the compatibility between the two individuals and the deeper will be the intimacy of the couple culminating in a lasting marriage..

Example request:

curl -X GET -G "/v1/astrology/nakshatra-porutham" \
    -H "Authorization: Bearer {token}"
const url = new URL("/v1/astrology/nakshatra-porutham");

    let params = {
            "bride_star": "Magha",
            "bridegroom_star": "Ashwini",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Authorization": "Bearer {token}",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "request": {
        "bride_star": "21-2",
        "bridegroom_star": "1",
        "lang": "en",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "result": {
            "dina": {
                "result": 1,
                "status": 1
            },
            "gana": {
                "result": 1,
                "status": 1
            },
            "mahendra": {
                "result": 0,
                "status": 0
            },
            "streedhrirgham": {
                "result": 0,
                "status": 0
            },
            "yoni": {
                "result": 0,
                "status": 0
            },
            "veda": {
                "result": 1,
                "status": 1
            },
            "rajju": {
                "result": 1,
                "status": 1
            },
            "rasi": {
                "result": 0,
                "status": 0
            },
            "rasilord": {
                "result": 0,
                "status": 0
            },
            "vasya": {
                "result": 1,
                "status": 1
            }
        },
        "porutham_details": {
            "dina": "Their match is deemed to be 'excellent' or 'Uthamam' since on counting from birth star of girl to boy – the result shows 8 and that is a positive sign.",
            "gana": "The girl’s star belongs to Manushya ganam and the boy’s star belongs to Deva ganam, making this match Madhyamam (Medium compatibilty match)",
            "mahendra": "This relationship can be declared as an 'Athamam' relationship as on counting the birth star of girl to boy, it can come to the number 8 - which shows that here both will find it difficult to enjoy a smooth relation.",
            "streedhrirgham": "This relationship can be declared as an 'Athamam' relationship as on counting the birth star of girl to boy, it can come to the number 8- which shows that here both will find it difficult to enjoy a smooth relation.",
            "yoni": "The gender of the girl’s Nakshatra is male and the gender of the boy’s Nakshatra is also male. This makes this an Bad match (Athamam).",
            "veda": "For the couples where the birth stars do not have vedha, there is a satisfactory match in their birth stars.",
            "rajju": "As per the stars, both belong to different Rajju, and therefore this can be selected as a perfect match.",
            "rasi": "This match is not recommended and can be called as 'Athamam' because on counting the rashis from the girl to the boy's rashi – it can be calculated to 4, which shows an unhappy relationship.",
            "rasilord": "Since the ruling Lords of the girl and the boy are hostile to each other, so this relationships is said to be 'Athamam'. The relationship is not a recommended one at all.",
            "vasya": "In this situation, it looks like a perfect match or one that is Uttamam because the boy's rasi can be a part of the girls's vasya which means that the girl can influence the boy in life."
        },
        "nakshatras_details": {
            "girl_rasi_lord": "Sani",
            "boy_rasi_lord": "Kuja",
            "boy_yoni": "Horse",
            "girl_yoni": "Bull",
            "girl_gana": "Manushya",
            "boy_gana": "Deva",
            "girl_star": "Ashwini",
            "boy_star": "Uttara Ashadha - 2nd Pada",
            "girl_rashi": "Makara",
            "boy_rashi": "Mesha"
        }
    }
}

HTTP Request

GET /v1/astrology/nakshatra-porutham

Query Parameters

Parameter Status Description
bride_star required {Nakshtra of bride}.
bridegroom_star required {Nakshatra of the bridegroom }.

Error Response

Error Response 1 (Unauthorized)

Error Response 1

{
    "response": {
        "status_code": 604,
        "status_message": "Unauthorised Request. Your api key has expired or is incorrect. Please verify your key or create a new key using your valid credentials."
    }
}
Index Description
status_code Numeric representation of the response
status_message Description about the error

Error Response 2 (Bad Request)

Error Response 2

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2004-02-06T15:19:21Z",
        "coordinates": "13.0878,80.278s5",
        "userid": 1
    },
    "response": {
        "status_code": 601,
        "status_message": "Please provide valid inputs for calculation.",
        "errors": {
            "coordinates": [
                "Please enter valid coordinates. For eg., if 10.214747 is latitude and 78.097626 is longitude, the `coordinates` should be `10.214747,78.097626`"
            ]
        }
    }
}
Index Description
status_code Numeric representation of the response
status_message Short Description about the problem
errors Group each errors
dob/bridegroom_dob/bride_dob Date and time of birth of bridegroom should be in UTC format Y-m-dTH:i:sZ. Verify your date of birth parameter is in the correct format eg: 1998-11-03T11:31:00+05:30

Error Response 3 (Bad Request)

Error Response 3

{
    "response": {
        "status_code": 605,
        "status_message": "The service you are trying to access is not available in our system."
    }
}
Index Description
status_code Numeric representation of the response
status_message Short Description about the problem

Error Response 4 (Bad Request)

Error Response 4

{
    "response": {
        "status_code": 603,
        "status_message": "Too many attempts, please slow down the request."
    }
}
Index Description
status_code Numeric representation of the response
status_message Short Description about the problem

Error Response 5 (Bad Request)

Error Response 5

{
    "response": {
        "status_code": 602,
        "status_message": "Your daily quota limit exceeded."
    }
}
Index Description
status_code Numeric representation of the response
status_message Short Description about the problem

Success Response

Response for Planet Position API

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2004-02-06T15:19:21Z",
        "coordinates": "13.0878,80.2785",
        "chart_type": "rasi",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "planet_positions": [
            {
                "id": 0,
                "name": "Sun",
                "longitude": "292.44",
                "is_reverse": false,
                "position": 9,
                "degree": "22.44",
                "rasi": "Makara",
                "rasi_lord": "Shani (Saturn)"
            },
            {
                "id": 1,
                "name": "Moon",
                "longitude": "110.3",
                "is_reverse": false,
                "position": 3,
                "degree": "20.3",
                "rasi": "Karka",
                "rasi_lord": "Chandra (Moon)"
            },
            {
                "id": 2,
                "name": "Mercury",
                "longitude": "274.31",
                "is_reverse": false,
                "position": 9,
                "degree": "4.31",
                "rasi": "Makara",
                "rasi_lord": "Shani (Saturn)"
            },
            {
                "id": 3,
                "name": "Venus",
                "longitude": "333.4",
                "is_reverse": false,
                "position": 11,
                "degree": "3.4",
                "rasi": "Meena",
                "rasi_lord": "Guru (Jupiter)"
            },
            {
                "id": 4,
                "name": "Mars",
                "longitude": "7.48",
                "is_reverse": false,
                "position": 0,
                "degree": "7.48",
                "rasi": "Mesha",
                "rasi_lord": "Mangal (Mars)"
            },
            {
                "id": 5,
                "name": "Jupiter",
                "longitude": "143.17",
                "is_reverse": true,
                "position": 4,
                "degree": "23.17",
                "rasi": "Simha",
                "rasi_lord": "Surya (Sun)"
            },
            {
                "id": 6,
                "name": "Saturn",
                "longitude": "73.13",
                "is_reverse": true,
                "position": 2,
                "degree": "13.13",
                "rasi": "Mithuna",
                "rasi_lord": "Budh (Mercury)"
            },
            {
                "id": 101,
                "name": "Rahu",
                "longitude": "21.52",
                "is_reverse": false,
                "position": 0,
                "degree": "21.52",
                "rasi": "Mesha",
                "rasi_lord": "Mangal (Mars)"
            },
            {
                "id": 102,
                "name": "Ketu",
                "longitude": "201.52",
                "is_reverse": false,
                "position": 6,
                "degree": "21.52",
                "rasi": "Tula",
                "rasi_lord": "Shukra(Venus)"
            },
            {
                "id": 100,
                "name": "Ascendant",
                "longitude": "330.48",
                "is_reverse": false,
                "position": 11,
                "degree": "48",
                "rasi": "Meena",
                "rasi_lord": "Guru (Jupiter)"
            }
        ],
        "chart_positions": {
            "0": [
                4,
                10
            ],
            "2": [
                6
            ],
            "3": [
                1
            ],
            "4": [
                5
            ],
            "6": [
                12
            ],
            "9": [
                0,
                2
            ],
            "11": [
                3,
                14
            ]
        },
        "first_house": 1
    }
}
Index Description
request Input Data
response API Response
status_code Indicate the response is success/failure
status_message Indicate the response is success/failure
planet_positions Nirayana Planetary Positions with Lahiri Ayanamsha
chart_positions Formatted planet positions for drawing the chart
first_house Starting index of the chart

Planet Positions include:

Response for Horoscope Matching API

{
    "request": {
        "system": "kerala",
        "ayanamsa": "1",
        "bride_dob": "2004-02-01T15:19:21Z",
        "bridegroom_dob": "2019-01-01T15:19:21Z",
        "bride_coordinates": "10.214747,78.097626",
        "bridegroom_coordinates": "10.214747,78.097626",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "average_porutham": 5.5,
        "compatibility": "Madhyama",
        "detailed_information": {
            "dina_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Not Satisfactory",
                "value": 3,
                "comment": "BrideGroom's nakshatra Vishaka is in 12th postion from bride's nakshatra Mrigashirsha."
            },
            "gana_porutham": {
                "bridegroom": "Asura",
                "bride": "Deva",
                "result": "Not Satisfactory",
                "value": 3,
                "comment": "The bride belongs to Deva gana and bridegroom belongs to Asura gana."
            },
            "mahendra_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Not Satisfactory",
                "value": false,
                "comment": "BrideGroom's Nakshatra Vishaka is in 12th position from bride's nakshatra Mrigashirsha."
            },
            "stree_dhrirgham_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Satisfactory",
                "value": 2,
                "comment": "BrideGroom's Nakshatra Vishaka counted from Bride's nakshatra Mrigashirsha is in 12th position."
            },
            "yoni_porutham": {
                "bridegroom": "Male",
                "bride": "Female",
                "result": "Good",
                "value": 1,
                "comment": "BrideGroom's nakshatra belongs to Male yoni and bride's nakshatra belongs to Female yoni."
            },
            "veda_porutham": {
                "bridegroom": "Vishaka",
                "bride": "Mrigashirsha",
                "result": "Good",
                "value": true,
                "comment": "BrideGroom's nakshatra and Bride's nakshatra have no affliction. So there is veda porutham."
            },
            "rajju_porutham": {
                "bridegroom": "Anthima",
                "bride": "Madhyama",
                "result": "Good",
                "value": 1,
                "comment": "BrideGrooms rajju is Anthima and Brides rajju is Madhyama."
            },
            "vasya_porutham": {
                "bridegroom": "Tula",
                "bride": "Vrishabha",
                "result": "Good",
                "value": true,
                "comment": "BrideGroom's rasi is Tula and Bride's rasi is Vrishabha. Here Brides's rasi is the vasya rasi of BrideGrooms rasi."
            },
            "rasi_porutham": {
                "bridegroom": "Tula",
                "bride": "Vrishabha",
                "result": "Not Satisfactory",
                "value": 3,
                "comment": "BrideGroom's rasi is Tula and Bride's rasi is Vrishabha. BrideGroom's rasi  Tula is in 6th position from Bride's rasi Vrishabha."
            },
            "rashyadhipa_porutham": {
                "bridegroom": "Venus",
                "bride": "Venus",
                "result": "Good",
                "value": true,
                "comment": "BrideGrooms rasyadhipan is Venus and brides rasyadhipan is Venus. Venus and Venus are freinds."
            }
        },
        "papa_samaya_result": {
            "bridegroom_papapoints": {
                "ascendant": {
                    "rahu": {
                        "papam": true,
                        "position": 1
                    },
                    "mars": {
                        "papam": 0,
                        "position": 9
                    },
                    "sun": {
                        "papam": 0,
                        "position": 6
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 6
                    }
                },
                "venus": {
                    "saturn": {
                        "papam": true,
                        "position": 2
                    },
                    "sun": {
                        "papam": true,
                        "position": 2
                    },
                    "mars": {
                        "papam": 0,
                        "position": 5
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 9
                    }
                },
                "moon": {
                    "sun": {
                        "papam": 0,
                        "position": 3
                    },
                    "mars": {
                        "papam": 0,
                        "position": 6
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 3
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 10
                    }
                }
            },
            "bride_papapoints": {
                "moon": {
                    "saturn": {
                        "papam": true,
                        "position": 2
                    },
                    "mars": {
                        "papam": true,
                        "position": 12
                    },
                    "rahu": {
                        "papam": true,
                        "position": 12
                    },
                    "sun": {
                        "papam": 0,
                        "position": 9
                    }
                },
                "venus": {
                    "sun": {
                        "papam": true,
                        "position": 12
                    },
                    "mars": {
                        "papam": 0,
                        "position": 3
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 5
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 3
                    }
                },
                "ascendant": {
                    "sun": {
                        "papam": 0,
                        "position": 6
                    },
                    "mars": {
                        "papam": 0,
                        "position": 9
                    },
                    "saturn": {
                        "papam": 0,
                        "position": 11
                    },
                    "rahu": {
                        "papam": 0,
                        "position": 9
                    }
                }
            },
            "papa_status": "Excellent"
        },
        "bridegroom_details": {
            "nakshatra_details": {
                "id": 16,
                "name": "Vishaka",
                "longitude": 206.49354476276642,
                "lord": "Jupiter",
                "pada": 2
            },
            "rasi_details": {
                "id": 6,
                "name": "Tula",
                "longitude": 206.49354476276642,
                "lord": "Shukra(Venus)"
            },
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "256° 47' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "16° 47' "
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "206° 29' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "26° 29' "
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "240° 39' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "39' "
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "210° 0' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "0' "
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "336° 14' ",
                    "is_reverse": false,
                    "position": 11,
                    "degree": "6° 14' "
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "227° 46' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "17° 46' "
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "257° 19' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "17° 19' "
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "93° 24' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "3° 24' "
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "273° 24' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "3° 24' "
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "115° 4' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "25° 4' "
                }
            ]
        },
        "bride_details": {
            "nakshatra_details": {
                "id": 5,
                "name": "Mrigashirsha",
                "longitude": 54.78653600410415,
                "lord": "Mars",
                "pada": 1
            },
            "rasi_details": {
                "id": 1,
                "name": "Vrishabha",
                "longitude": 54.78653600410415,
                "lord": "Shukra (Venus)"
            },
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "288° 11' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "18° 11' "
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "54° 47' ",
                    "is_reverse": false,
                    "position": 1,
                    "degree": "24° 47' "
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "267° 58' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "27° 58' "
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "327° 43' ",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "27° 43' "
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "4° 57' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "4° 57' "
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "143° 42' ",
                    "is_reverse": true,
                    "position": 4,
                    "degree": "23° 42' "
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "73° 28' ",
                    "is_reverse": true,
                    "position": 2,
                    "degree": "13° 28' "
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "22° 6' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "22° 6' "
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "202° 6' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "22° 6' "
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "145° 0' ",
                    "is_reverse": false,
                    "position": 4,
                    "degree": "25° 0' "
                }
            ]
        }
    }
}
Index Description
request Input Data
response API Response
status_code Indicate the response is success/failure
status_message Indicate the response is success/failure
average_porutham Marriage compatibility score for your input
compatibility String representation of compatibility score
detailed_information Includes information about the dasha porutham
papa_samaya_result Includes information about the papa samyam between two horoscope
bridegroom_details Basic astrological details about the bridegroom's horoscope
bride_details Basic astrological details about the bride's horoscope

Average porutham

average_porutham : Marriage compatibility score based on nakshatra porutham

Compatibility

compatibility : How to Interpret Marriage Horoscope Matching Result:

Detailed Information

detailed_information : Information about the 10 porutham.

The 10 poruthams (kootas) thus chalked out are: dinam, ganam, yoni, rasi, rasiyathipaty, rajju, vedha, vasya, mahendram and stree deergham.

Papa Samaya Information

papa_samaya_result : Papa (dosha) Comparison is done here by assigning points for the position of Mars, Saturn, Rahu, Ketu and Sun with respect to Lagna, Moon as well as Venus.

Bridegroom Details & Bride Details

Marriage matching is done based on the birth stars and janma rashi of the people getting married. These include the basic astrological details in the bride & bridegroom's horoscope.

Nakshatra Details include:

Rasi Details include:

Planet Positions include:

Response for Kundli Matching API

{
    "request": {
        "ayanamsa": "1",
        "bride_dob": "2004-02-01T15:19:21Z",
        "bridegroom_dob": "2019-01-01T15:19:21Z",
        "bride_coordinates": "10.214747,78.097626",
        "bridegroom_coordinates": "10.214747,78.097626",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "bride_details": {
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "288° 11' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "18° 11' ",
                    "rasi": "Makara",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "54° 47' ",
                    "is_reverse": false,
                    "position": 1,
                    "degree": "24° 47' ",
                    "rasi": "Vrishabha",
                    "rasi_lord": "Shukra (Venus)"
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "267° 58' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "27° 58' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "327° 43' ",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "27° 43' ",
                    "rasi": "Kumbha",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "4° 57' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "4° 57' ",
                    "rasi": "Mesha",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "143° 42' ",
                    "is_reverse": true,
                    "position": 4,
                    "degree": "23° 42' ",
                    "rasi": "Simha",
                    "rasi_lord": "Surya (Sun)"
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "73° 28' ",
                    "is_reverse": true,
                    "position": 2,
                    "degree": "13° 28' ",
                    "rasi": "Mithuna",
                    "rasi_lord": "Budh (Mercury)"
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "22° 6' ",
                    "is_reverse": false,
                    "position": 0,
                    "degree": "22° 6' ",
                    "rasi": "Mesha",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "202° 6' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "22° 6' ",
                    "rasi": "Tula",
                    "rasi_lord": "Shukra(Venus)"
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "145° 0' ",
                    "is_reverse": false,
                    "position": 4,
                    "degree": "25° 0' ",
                    "rasi": "Simha",
                    "rasi_lord": "Surya (Sun)"
                }
            ],
            "nakshatra_details": {
                "id": 4,
                "name": "Mrigashirsha",
                "longitude": 54.78653600410415,
                "lord": "Mars",
                "pada": -43
            },
            "rasi_details": {
                "id": 1,
                "name": "Vrishabha",
                "longitude": 54.78653600410415,
                "lord": "Shukra (Venus)"
            },
            "varna": {
                "id": 2,
                "name": "Vaishya"
            },
            "vasya": {
                "id": 2,
                "name": "Chatushpada"
            },
            "tara": {
                "id": 2,
                "effect": "benefic",
                "name": "Vipatha",
                "position": 11,
                "point": 1.5
            },
            "yoni": {
                "id": 3,
                "name": "Sarpa"
            },
            "rasi_lord": {
                "id": 3,
                "name": "Venus",
                "moon_rasi_id": 1,
                "moon_rasi": "Vrishabha"
            },
            "gana": {
                "id": 0,
                "name": "Devata"
            },
            "bhakoot": {
                "id": 1,
                "name": "Vrishabha",
                "position": 5
            },
            "nadi": {
                "id": 1,
                "name": "Madhya"
            },
            "manglik_status": 0,
            "mars_current_house": 9,
            "exception_list": null,
            "manglik_exception": 0
        },
        "bridegroom_details": {
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "256° 47' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "16° 47' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "206° 29' ",
                    "is_reverse": false,
                    "position": 6,
                    "degree": "26° 29' ",
                    "rasi": "Tula",
                    "rasi_lord": "Shukra(Venus)"
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "240° 39' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "39' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "210° 0' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "0' ",
                    "rasi": "Vrischika",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "336° 14' ",
                    "is_reverse": false,
                    "position": 11,
                    "degree": "6° 14' ",
                    "rasi": "Meena",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "227° 46' ",
                    "is_reverse": false,
                    "position": 7,
                    "degree": "17° 46' ",
                    "rasi": "Vrischika",
                    "rasi_lord": "Mangal (Mars)"
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "257° 19' ",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "17° 19' ",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "93° 24' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "3° 24' ",
                    "rasi": "Karka",
                    "rasi_lord": "Chandra (Moon)"
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "273° 24' ",
                    "is_reverse": false,
                    "position": 9,
                    "degree": "3° 24' ",
                    "rasi": "Makara",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "115° 4' ",
                    "is_reverse": false,
                    "position": 3,
                    "degree": "25° 4' ",
                    "rasi": "Karka",
                    "rasi_lord": "Chandra (Moon)"
                }
            ],
            "nakshatra_details": {
                "id": 15,
                "name": "Vishaka",
                "longitude": 206.49354476276642,
                "lord": "Jupiter",
                "pada": 2
            },
            "rasi_details": {
                "id": 6,
                "name": "Tula",
                "longitude": 206.49354476276642,
                "lord": "Shukra(Venus)"
            },
            "varna": {
                "id": 3,
                "name": "Shudra"
            },
            "vasya": {
                "id": 0,
                "name": "Manava"
            },
            "tara": {
                "id": 7,
                "effect": "malefic",
                "name": "Mitra",
                "position": 16,
                "point": 0
            },
            "yoni": {
                "id": 9,
                "name": "Vyagrah"
            },
            "rasi_lord": {
                "id": 3,
                "name": "Venus",
                "moon_rasi_id": 6,
                "moon_rasi": "Tula"
            },
            "gana": {
                "id": 2,
                "name": "Rakshasa"
            },
            "bhakoot": {
                "id": 6,
                "name": "Tula",
                "position": 7
            },
            "nadi": {
                "id": 2,
                "name": "Antya"
            },
            "manglik_status": 0,
            "mars_current_house": 9,
            "exception_list": null,
            "manglik_exception": 0
        },
        "result": {
            "match_status": 2,
            "message": "Union is inauspicious",
            "varna": {
                "bride": "Vaishya",
                "bridegroom": "Shudra",
                "point": 0,
                "message": " Varna represents the working attitude and capacity.  The  bridegroom’s capacity needs to be higher than that of the bride for smooth running of the family. The bridegroom’s varna is Shudra Varna while the bride comes under Vaishya Varna. This type of combination is not very much favorable for a union. For this couple Varna Koot is Not Good. However, if other gunas are matched well, then this alliance may be taken into consideration."
            },
            "vasya": {
                "bride": "Chatushpada",
                "bridegroom": "Manava",
                "point": 1,
                "message": "Vasya was used to determine whether there will be a dedicated and compatible relationship between two people. The bridegroom’s Vasya is Manava Vasya while the bride comes under Chatushpada Vasya. This is a normal match and not excellent or worst. For this couple Vasya Koot is Normal. However, if other gunas are matched well, then this alliance may be taken into consideration."
            },
            "tara": {
                "bride": "Mrigashirsha",
                "bridegroom": "Vishaka",
                "point": 1.5,
                "message": "Tara is used to calculate the health and well-being of the bride and groom after marriage. The bridegroom and bride are in different Tara Group. The bridegroom's nakshatra Vishaka is 16th position from bride's nakshatra Mrigashirsha and this is malefic. At the same time The bride's nakshatra Mrigashirsha is 11th position from bridegroom's nakshatra Vishaka and this is benefic. This is a normal match. For this couple Tara Koot is Normal. But if other gunas are matched well, then this alliance may be taken into consideration."
            },
            "yoni": {
                "bride": "Sarpa",
                "bridegroom": "Vyagrah",
                "point": 2,
                "message": "Yoni indicates the physical and sexual compatibility between a couple.The bridegroom’s Yoni is Vyagrah while the bride comes under Sarpa Yoni. This is a preferable combination. For this couple Yoni Koot is Average."
            },
            "graha_maitri": {
                "bride": "Venus",
                "bridegroom": "Venus",
                "point": 5,
                "message": "Graha Maitri is used to examine the strength of the love between the couple. This is achieved by comparing the sign lords of the moon in the chart of the bride and groom.The bridegroom and the bride both belong to same Rasi Lord Venus.The bridegroom’s Rasi is Tula while the bride's Rasi is Vrishabha. This is so far the best compatible match. For this couple Graha Maitri Koot is Excellent."
            },
            "gana": {
                "bride": "Devata",
                "bridegroom": "Rakshasa",
                "point": 1,
                "message": "Gana is used to identify an individuals temperament.The bridegroom’s Gana is Rakshasa while the bride comes under Devata Gana. This is a preferable combination. For this couple Gana Koot is Average."
            },
            "bhakoot": {
                "bride": "Vrishabha",
                "bridegroom": "Tula",
                "point": 0,
                "message": "Bhakoot or Rashikoot testing is used to verify the overall health, welfare and prosperity of a family after marriage. It is believed that Bhakoot Dosha can affect the intimacy between the couple and cause delays in pregnancy.The bridegroom’s Zodiac sign is Tula while the bride's Zodiac sign is Vrishabha. This is inauspicious combination. For this couple Bhakoot Koot is Not Good."
            },
            "nadi": {
                "bride": "Madhya",
                "bridegroom": "Antya",
                "point": 8,
                "message": "Nadi testing is to check the genetic compatibility of the bride and groom to ensure they are capable of producing healthy children. Nadi Kuot is given supreme priority during match making.The bridegroom belongs to Antya Nadi while the while the bride comes under Madhya Nadi. This is considered to be extremely good combination according to nadi compatibility. For this couple Nadi Koot is Excellent."
            },
            "total_point": 18.5,
            "sub_message": [
                "Horoscope matching shows a low score "
            ]
        }
    }
}
Index Description
request Input Data
response API Response
status_code Indicate the response is success/failure
status_message Indicate the response is success/failure
result Contains the result of kundli matching
match_status Numeric value that represents the kundli matching result
message String description about the kundli matching result
total_point Total Guna Milan / Kundli matching point
sub_message Summary and recommendation about the result
bridegroom_details Basic astrological details about the bridegroom's horoscope
bride_details Basic astrological details about the bride's horoscope

Match Status

Numeric value that represents the kundli matching result. Match status may be either 1 or 2. Match status 1 means Matching is recommended & 2 means Matching is NOT recommended.

Message

Description for the parameter match_status. Message format is as follows

Total Point

Each koot in the gun milan method assigned a maximum point. Total Point index in the response represents the total of the obtained points in the gun milan test out of 36.

Sub Message

It is the summary and recommendation about the result. eg:Union is not recommended because of Nadi Maha Dosha

Bridegroom Details & Bride Details

Marriage matching is done based on the birth stars and janma rashi of the people getting married. These include the basic astrological details in the bride & bridegroom's horoscope.

Nakshatra Details include:

Rasi Details include:

Planet Positions include:

Response for Mangal Dosha API

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2019-04-11T11:02:00+05:30",
        "coordinates": "13.0878,80.2785",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "result": {
            "nakshatra": [
                {
                    "id": 5,
                    "name": "Ardra",
                    "start": "2019-04-11T10:25:44+05:30",
                    "end": "2019-04-12T09:54:17+05:30"
                }
            ],
            "nakshatra_lord": "Rahu",
            "nakshatra_pada": 1,
            "moon_rasi": [
                {
                    "id": 2,
                    "name": "Mithuna",
                    "start": "2019-04-10T22:32:40+05:30",
                    "end": "2019-04-13T03:15:04+05:30"
                }
            ],
            "rasi_lord": "Budh (Mercury)",
            "planet_positions": [
                {
                    "id": 0,
                    "name": "Sun",
                    "longitude": "357.9",
                    "is_reverse": false,
                    "position": 11,
                    "degree": "27.9",
                    "rasi": "Meena",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 1,
                    "name": "Moon",
                    "longitude": "70.9",
                    "is_reverse": false,
                    "position": 2,
                    "degree": "10.9",
                    "rasi": "Mithuna",
                    "rasi_lord": "Budh (Mercury)"
                },
                {
                    "id": 2,
                    "name": "Mercury",
                    "longitude": "329.30",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "29.30",
                    "rasi": "Kumbha",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 3,
                    "name": "Venus",
                    "longitude": "324.44",
                    "is_reverse": false,
                    "position": 10,
                    "degree": "24.44",
                    "rasi": "Kumbha",
                    "rasi_lord": "Shani (Saturn)"
                },
                {
                    "id": 4,
                    "name": "Mars",
                    "longitude": "43.16",
                    "is_reverse": false,
                    "position": 1,
                    "degree": "13.16",
                    "rasi": "Vrishabha",
                    "rasi_lord": "Shukra (Venus)"
                },
                {
                    "id": 5,
                    "name": "Jupiter",
                    "longitude": "240.13",
                    "is_reverse": true,
                    "position": 8,
                    "degree": "13",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 6,
                    "name": "Saturn",
                    "longitude": "266.6",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "26.6",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 101,
                    "name": "Rahu",
                    "longitude": "88.7",
                    "is_reverse": false,
                    "position": 2,
                    "degree": "28.7",
                    "rasi": "Mithuna",
                    "rasi_lord": "Budh (Mercury)"
                },
                {
                    "id": 102,
                    "name": "Ketu",
                    "longitude": "268.7",
                    "is_reverse": false,
                    "position": 8,
                    "degree": "28.7",
                    "rasi": "Dhanu",
                    "rasi_lord": "Guru (Jupiter)"
                },
                {
                    "id": 100,
                    "name": "Ascendant",
                    "longitude": "152.26",
                    "is_reverse": false,
                    "position": 5,
                    "degree": "2.26",
                    "rasi": "Kanya",
                    "rasi_lord": "Budh (Mercury)"
                }
            ],
            "manglik_status": 0,
            "mars_current_house": 9,
            "ascendant_rasi": "Kanya",
            "manglik_exception": 0,
            "exceptions": null
        }
    }
}
Index Description
request Input Data
response API Response
status_code Indicate the response is success/failure
status_message Indicate the response is success/failure
nakshatra_details Janma nakshatra & related information for your input
rasi_details Janma rasi & related information for your input
planet_positions Nirayana Planetary Positions with Lahiri Ayanamsha
manglik_status Indicates that if the person is affected by mangal dosha or not
mars_current_house Indicates the current position of mars in the chart
ascendant_rasi Indicates the Lagana Rasi
manglik_exception Indicates that any manglik exceptions can applicable based on the birth chart.
exceptions List of exceptions that can be cancel/reduce the malific effect of mars

Nakshatra Details include:

Rasi Details include:

Planet Positions include:

Manglik Status:

Indicates that if the person is affected by mangal dosha or not. Value can be either 0 or 1. O indicates there is no mangal dosha and 1 indicates there is mangal dosha.

Mars Current House:

Indicates the current position of mars in the chart. There are 12 houses on the chart , this index indicates currently which house contains mars. if mars_current_house is 7/8 it indicates strong manglik dosha. if mars_current_house is 1/2/4/12 it indicates mild manglik dosha.

Ascendant Rasi

Indicates the lagana rasi. Ascendant at the time of the birth is known as Janma Lagna (Lagana Rasi/Ascendant Rasi). Janma Lagna is the zodiac sign rising at the Eastern horizon at the time of the birth.

Manglik Exception

In some cases the malific effect of Mangal Dosha may be reduce/cancel because of some reasons. This index indicates that if any of such exceptions are applicable or not. If the value is 1 then there is some exceptions that can reduce the evil effect. If the value is 0 then there is no such exceptions.

Exceptions

List of exceptions that can be cancel/reduce the malific effect of mars. eg: Mars is in conjunction or aspected by Mercury. ​ Mars is in conjunction or aspected by Saturn. ​ Mars is said to have a maturity age of 28. The malefic effects of Mars reduce after the age of 28.

Response for Panchang API

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2004-02-06T15:19:21Z",
        "coordinates": "13.0878,80.2785",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "week_day": {
            "id": 5,
            "name": "Friday"
        },
        "nakshatra": [
            {
                "id": 8,
                "name": "Ashlesha",
                "start": "2004-02-05T20:56:13+00:00",
                "end": "2004-02-06T21:49:54+00:00"
            },
            {
                "id": 9,
                "name": "Magha",
                "start": "2004-02-06T21:49:55+00:00",
                "end": "2004-02-07T22:17:25+00:00"
            }
        ],
        "karana": [
            {
                "id": 0,
                "name": "Bava",
                "start": "2004-02-05T20:33:13+00:00",
                "end": "2004-02-06T08:46:56+00:00"
            },
            {
                "id": 1,
                "name": "Balava",
                "start": "2004-02-06T08:46:57+00:00",
                "end": "2004-02-06T20:53:21+00:00"
            },
            {
                "id": 2,
                "name": "Kaulava",
                "start": "2004-02-06T20:53:22+00:00",
                "end": "2004-02-07T08:52:56+00:00"
            }
        ],
        "yoga": [
            {
                "id": 3,
                "name": "Saubhagya",
                "start": "2004-02-05T22:25:37+00:00",
                "end": "2004-02-06T21:29:36+00:00"
            },
            {
                "id": 4,
                "name": "Sobhana",
                "start": "2004-02-06T21:29:37+00:00",
                "end": "2004-02-07T20:12:41+00:00"
            }
        ],
        "tithi": [
            {
                "id": 14,
                "name": "Purnima",
                "start": "2004-02-05T08:11:43+00:00",
                "end": "2004-02-06T08:46:56+00:00",
                "paksha": "Sukla Paksha",
                "type": false
            },
            {
                "id": 15,
                "name": "Pratipada",
                "start": "2004-02-06T08:46:57+00:00",
                "end": "2004-02-07T08:52:56+00:00",
                "paksha": "Krishna Paksha",
                "type": false
            }
        ]
    }
}

*All datetime given in the response is in UTC format you can convert it to any timezone as per your requirement.

Week day

The Hindu calendrical day starts with local sunrise to next sunrise.

Nakshatra Details include:

Karana Details

A karana is half of a tithi. To be precise, a karana is the time required for the angular distance between the sun and the moon to increase in steps of 6 degree starting from 0 degree.

Yoga Details

Yoga is another component of Panchanga system that plays important role in choosing Muhurta for any action. Literal meaning of the word ‘Yoga’ is addition; and Nithya Yoga is derived from addition of sun and moon position in Zodiac and these specify some characteristic of the persona. There are 27 ‘Yogas’, and this is the reason that their length is 13 degrees and 20 Minutes each, just like Nakshatras.

Tithi Details

In vedic timekeeping, a tithi (also spelled thithi) is a lunar day, or the time it takes for the longitudinal angle between the moon and the sun to increase by 12. Tithis begin at varying times of day and vary in duration from approximately 19 to approximately 26 hours. There are 30 tithis in each lunar month

Response for Nakshatra Porutham API

{
    {
    "request": {
        "bride_star": "2",
        "bridegroom_star": "3-2",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "result": {
            "dina": {
                "result": 1,
                "status": 1
            },
            "gana": {
                "result": 1,
                "status": 0.5
            },
            "mahendra": {
                "result": 0,
                "status": 0
            },
            "streedhrirgham": {
                "result": 0,
                "status": 0
            },
            "yoni": {
                "result": 0,
                "status": 0
            },
            "veda": {
                "result": 1,
                "status": 1
            },
            "rajju": {
                "result": 1,
                "status": 1
            },
            "rasi": {
                "result": 0,
                "status": 0
            },
            "rasilord": {
                "result": 1,
                "status": 1
            },
            "vasya": {
                "result": 0,
                "status": 0
            }
        },
        "porutham_details": {
            "dina": "Their match is deemed to be 'excellent' or 'Uthamam' since on counting from birth star of girl to boy – the result shows 2 and that is a positive sign.",
            "gana": "The girl’s star belongs to Manushya ganam and the boy’s star belongs to Asura ganam, making this match Madhyamam (Medium compatibilty match).",
            "mahendra": "This relationship can be declared as an 'Athamam' relationship as on counting the birth star of girl to boy, it can come to the number 2 - which shows that here both will find it difficult to enjoy a smooth relation.",
            "streedhrirgham": "This relationship can be declared as an 'Athamam' relationship as on counting the birth star of girl to boy, it can come to the number 2- which shows that here both will find it difficult to enjoy a smooth relation.",
            "yoni": "The gender of the girl’s Nakshatra is male and the gender of the boy’s Nakshatra is  female. This makes this a Bad match (Athamam) .",
            "veda": "For the couples where the birth stars do not have vedha, there is a satisfactory match in their birth stars.",
            "rajju": "As per the stars, both belong to different Rajju, and therefore this can be selected as a perfect match.",
            "rasi": "This match is not recommended and can be called as 'Athamam' because on counting the rashis from the girl to the boy's rashi – it can be calculated to 2, which shows an unhappy relationship.",
            "rasilord": "Since the ruling Lords of the girl and the boy are loving and united in thoughts and deeds, so this relationships is said to be 'Uthamam'.",
            "vasya": "This is an Athamam relationship since the girl's rasi is not at all compatible to the boy's vasya or even in the opposite manner. Hence this will not be a peaceful relationship."
        },
        "nakshatras_details": {
            "girl_rasi_lord": "Kuja",
            "boy_rasi_lord": "Sukra",
            "boy_yoni": "Sheep",
            "girl_yoni": "Elephant",
            "girl_gana": "Manushya",
            "boy_gana": "Asura",
            "girl_star": "Bharani",
            "boy_star": "Krithika - 2nd Pada",
            "girl_rashi": "Mesha",
            "boy_rashi": "Vrishabha"
        }
    }
}

Nakshatra Details include:

Porutham Details

A short description about how to interpret the porutham

Result Details

10 porutham and its status

Sample Code

Sample PHP code for accessing API

All output timezone is in UTC, you can convert it to any timezone as per your requirement.

    <?php

        $base_url = "https://api.prokerala.com/v1/astrology/panchang";
        $ar_parameter = [
            'ayanamsa' => 1,
            'datetime' => "2019-04-06T17:13:21Z",
            'coordinates' => "13.0878,80.2785",
        ];
        $api_url = addParam($base_url, $ar_parameter);

        $ch = curl_init();

        curl_setopt($ch, CURLOPT_URL, $api_url);

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

        curl_setopt($ch, CURLOPT_HTTPGET, true);

        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization:bearer YOUR_API_KEY']);

        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

        $response = curl_exec($ch);

        print_r($response);

        curl_close($ch);

        function addParam($url, $param = []) {
            $ar = [];
            foreach ($param as $k => $v) {
                $ar[] = $k . '=' . urlencode($v);
            }
            $param = implode('&', $ar);
            return $url .= ((false === strpos($url, '?')) ? "?${param}" : "&${param}");
        }
OUTPUT

{
    "request": {
        "ayanamsa": "1",
        "datetime": "2004-02-06T15:19:21Z",
        "coordinates": "13.0878,80.2785",
        "userid": 1
    },
    "response": {
        "status_code": 600,
        "status_message": "success",
        "week_day": {
            "id": 5,
            "name": "Friday"
        },
        "nakshatra": [
            {
                "id": 8,
                "name": "Ashlesha",
                "start": "2004-02-05T20:56:13+00:00",
                "end": "2004-02-06T21:49:54+00:00"
            },
            {
                "id": 9,
                "name": "Magha",
                "start": "2004-02-06T21:49:55+00:00",
                "end": "2004-02-07T22:17:25+00:00"
            }
        ],
        "karana": [
            {
                "id": 0,
                "name": "Bava",
                "start": "2004-02-05T20:33:13+00:00",
                "end": "2004-02-06T08:46:56+00:00"
            },
            {
                "id": 1,
                "name": "Balava",
                "start": "2004-02-06T08:46:57+00:00",
                "end": "2004-02-06T20:53:21+00:00"
            },
            {
                "id": 2,
                "name": "Kaulava",
                "start": "2004-02-06T20:53:22+00:00",
                "end": "2004-02-07T08:52:56+00:00"
            }
        ],
        "yoga": [
            {
                "id": 3,
                "name": "Saubhagya",
                "start": "2004-02-05T22:25:37+00:00",
                "end": "2004-02-06T21:29:36+00:00"
            },
            {
                "id": 4,
                "name": "Sobhana",
                "start": "2004-02-06T21:29:37+00:00",
                "end": "2004-02-07T20:12:41+00:00"
            }
        ],
        "tithi": [
            {
                "id": 14,
                "name": "Purnima",
                "start": "2004-02-05T08:11:43+00:00",
                "end": "2004-02-06T08:46:56+00:00",
                "paksha": "Sukla Paksha",
                "type": false
            },
            {
                "id": 15,
                "name": "Pratipada",
                "start": "2004-02-06T08:46:57+00:00",
                "end": "2004-02-07T08:52:56+00:00",
                "paksha": "Krishna Paksha",
                "type": false
            }
        ]
    }
}

Sample PHP code for converting Time Zone

Sample PHP code for converting the sunrise time UTC (+00:00) to Indian time zone (+05:30).

<?php

$base_url = "https://api.prokerala.com/v1/astrology/panchang";
$ar_parameter = [
    'ayanamsa' => 1,
    'datetime' => "2019-04-06T17:13:21+00:00",
    'coordinates' => "13.0878,80.2785",
];
$api_url = addParam($base_url, $ar_parameter);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $api_url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

curl_setopt($ch, CURLOPT_HTTPGET, true);

curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization:bearer API_KEY']);

curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

$response = curl_exec($ch);

$response_data = json_decode($response);

$sunrise = $response_data->sunrise;

echo "Sunrise time in UTC : ".$sunrise."\n\n";

$tz = new \DateTimeZone("Asia/Kolkata");
$indian_sunrise = new \DateTime($sunrise);
$indian_sunrise->setTimezone($tz);

echo "Sunrise time in UTC +05.30 (Indian Timezone) :    ".$indian_sunrise->format("c");

curl_close($ch);

function addParam($url, $param = []) {
    $ar = [];
    foreach ($param as $k => $v) {
        $ar[] = $k . '=' . urlencode($v);
    }
    $param = implode('&', $ar);
    return $url .= ((false === strpos($url, '?')) ? "?${param}" : "&${param}");
}
OUTPUT

Sunrise time in UTC : 2019-04-06T00:35:41+00:00

Sunrise time in UTC +05.30 (Indian Timezone) : 2019-04-06T06:05:41+05:30