Website kundali registration - creates a real account, no auth required

Request: application/json. No auth, no OTP, no email verification - the website has already collected these details directly from the visitor and this endpoint registers them on the spot.

Unlike POST /public/kundali (a stateless, nothing-saved preview - kept as-is for now, will be removed once the website is live), this creates a real account: users + profiles rows, auth_providers='website', is_onboarded=true. If the email already exists anywhere - a blog subscriber, or an existing app user - no duplicate account is ever created: a subscribers-role row is upgraded to a full account (and mailed about it) and genuinely-empty profile fields are filled in; an account already signed in with Google is left untouched (only the kundali is generated against it). The very same email later completing the app's normal device-register + email-OTP flow logs straight into this same account - no separate linking step needed.

Body: full_name, email, gender, date_of_birth, latitude, longitude, timezone (required); birth_time or moon_sign (one required - same precise/indicative contract as POST /public/kundali); birth_place, intent (optional).

Success: 200 - the same chart/planet/dasha shape as POST /public/kundali (data.confidence, data.charts[] as base64 data URIs for instant display, data.intents[], data.glossary[]), plus data.play_store_url (empty string until the Play Store listing is live - hide the CTA in that case). The full narrative report (with R2-hosted chart images) generates in the background against the new/reconciled account, the same way it does after the app's own onboarding.

Errors: 422 - neither birth_time nor moon_sign supplied, an unrecognised moon_sign, or an invalid email. 429 - too many registrations from this IP (>5 per 600s).

Request

Body Params application/jsonRequired

Example

{
    "birth_place": "Delhi, India",
    "birth_time": "06:30:00",
    "date_of_birth": "1993-07-15",
    "email": "rahul@example.com",
    "full_name": "Rahul Sharma",
    "gender": "M",
    "intent": "[\"career\", \"wealth\"]",
    "latitude": 28.6139,
    "longitude": 77.209,
    "timezone": "Asia/Kolkata"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "name": "Rahul",
        "confidence": "precise",
        "sun_sign": "Cancer",
        "moon_sign": "Scorpio",
        "lagna": {
            "degree": 123.45,
            "sign": "Leo",
            "sign_num": 5,
            "nakshatra": "Purva Phalguni",
            "pada": 2
        },
        "planets": {
            "Sun": {
                "degree": 89.12,
                "sign": "Cancer",
                "sign_num": 4,
                "house": 12,
                "nakshatra": "Pushya",
                "nakshatra_lord": "Saturn",
                "retrograde": false
            }
        },
        "moon_nakshatra": {
            "index": 17,
            "name": "Anuradha",
            "pada": 3,
            "lord": "Saturn",
            "degree": 214.5
        },
        "vimshottari_dasha": [
            {
                "planet": "Venus",
                "start_date": "1993-07-15",
                "end_date": "2013-07-15",
                "years": 20
            }
        ],
        "charts": [
            {
                "chart_type": "rashi",
                "style": "north",
                "label": "Birth Chart (North Indian)",
                "image_base64": "data:image/webp;base64,UklGRiQAAABXRUJQVlA4IBgAAAAwAQCdASoBAAEAAgA0JaQAA3AA/v3AgAA="
            },
            {
                "chart_type": "rashi",
                "style": "south",
                "label": "Birth Chart (South Indian)",
                "image_base64": "data:image/webp;base64,UklGRiQAAABXRUJQVlA4IBgAAAAwAQCdASoBAAEAAgA0JaQAA3AA/v3AgAA="
            }
        ],
        "intents": [
            {
                "slug": "career",
                "name": "Career",
                "description": "Growth, work and professional direction",
                "icon": "https://images.hastaai.in/intent/career.webp"
            }
        ],
        "glossary": [
            {
                "slug": "nakshatra",
                "term": "Nakshatra",
                "meaning": "The Moon's 'star home' among 27 lunar mansions. It colours the day's energy and your natural instincts."
            }
        ],
        "play_store_url": "https://play.google.com/store/apps/details?id=in.hastaai.app"
    }
}

🟠422Parameter Error

🟠429