Get subscription and pricing plans

Request: No body

Returns subscription plans, message top-up packs, and one-time purchase options. Fetch on subscription or payment screens. Cached in Redis (lookup:plans). No auth required.

Success: 200 - subscription tiers grouped by billing period: data.monthly and data.yearly, each with seeker, sage, guru ({slug, plan_name, price, billing_period, message_limit, description, features, discount_price, discounted_till}); data.topup[] message packs; and the one-time products as direct keys data.palm, data.tarot, data.compatibility, data.marriage, data.child. Every plan object's slug is the exact value to send as subscription_slug to POST /coupons/validate and POST /subscriptions/checkout - do not hardcode or guess it on the frontend, since a mismatched slug returns 404.

Errors: None - public endpoint

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "monthly": {
            "seeker": {
                "slug": "seeker",
                "plan_name": "Seeker",
                "price": 0,
                "billing_period": "monthly",
                "message_limit": 5,
                "description": "Free basic access",
                "features": {
                    "messages_per_day": 5,
                    "family_add": 1,
                    "palm_reading": 0,
                    "compatibility_score": 1,
                    "tarot_spread": 0,
                    "marriage_report": 0
                }
            },
            "sage": {
                "slug": "sage-monthly",
                "plan_name": "Sage",
                "price": 299,
                "billing_period": "monthly",
                "message_limit": 30,
                "description": "Sage plan monthly",
                "features": {
                    "messages_per_day": 30,
                    "family_add": 3,
                    "palm_reading": 1,
                    "compatibility_score": 3,
                    "tarot_spread": 1,
                    "marriage_report": 0
                }
            },
            "guru": {
                "slug": "guru-monthly",
                "plan_name": "Guru",
                "price": 599,
                "billing_period": "monthly",
                "message_limit": 50,
                "description": "Guru monthly unlimited content",
                "features": {
                    "messages_per_day": 50,
                    "family_add": "unlimited",
                    "palm_reading": "unlimited",
                    "compatibility_score": "unlimited",
                    "tarot_spread": "unlimited",
                    "marriage_report": 0
                }
            }
        },
        "yearly": {
            "seeker": {
                "slug": "seeker",
                "plan_name": "Seeker",
                "price": 0,
                "billing_period": "yearly",
                "message_limit": 5,
                "description": "Free basic access",
                "features": {
                    "messages_per_day": 5,
                    "family_add": 1,
                    "palm_reading": 0,
                    "compatibility_score": 1,
                    "tarot_spread": 0,
                    "marriage_report": 0
                }
            },
            "sage": {
                "slug": "sage-yearly",
                "plan_name": "Sage",
                "price": 2499,
                "billing_period": "yearly",
                "message_limit": 30,
                "description": "Sage plan yearly",
                "features": {
                    "messages_per_day": 30,
                    "family_add": 5,
                    "palm_reading": 1,
                    "compatibility_score": 3,
                    "tarot_spread": 1,
                    "marriage_report": 0
                }
            },
            "guru": {
                "slug": "guru-yearly",
                "plan_name": "Guru",
                "price": 4999,
                "billing_period": "yearly",
                "message_limit": 0,
                "description": "Guru yearly fully unlimited",
                "features": {
                    "messages_per_day": "unlimited",
                    "family_add": "unlimited",
                    "palm_reading": "unlimited",
                    "compatibility_score": "unlimited",
                    "tarot_spread": "unlimited",
                    "marriage_report": 1
                }
            }
        },
        "topup": [
            {
                "slug": "topup-10",
                "plan_name": "Topup 10 Messages",
                "price": 29,
                "billing_period": "one_time",
                "message_limit": 10,
                "description": "10 extra chat messages",
                "features": {
                    "messages": 10
                }
            },
            {
                "slug": "topup-50",
                "plan_name": "Topup 50 Messages",
                "price": 99,
                "billing_period": "one_time",
                "message_limit": 50,
                "description": "50 extra chat messages",
                "features": {
                    "messages": 50
                }
            }
        ],
        "palm": {
            "slug": "palm-read",
            "plan_name": "Palm Reading",
            "price": 399,
            "billing_period": "one_time",
            "message_limit": 5,
            "description": "AI-powered palm line analysis",
            "features": {
                "usage_limit": 1,
                "feature_type": "palm_reading",
                "total_message": 5
            }
        },
        "tarot": {
            "slug": "tarot-reading",
            "plan_name": "Tarot Reading",
            "price": 149,
            "billing_period": "one_time",
            "message_limit": 5,
            "description": "Past, Present & Future reading with AI interpretation",
            "features": {
                "usage_limit": 1,
                "feature_type": "tarot_reading",
                "total_message": 5
            }
        },
        "compatibility": {
            "slug": "compatibility-score",
            "plan_name": "Compatibility Score",
            "price": 199,
            "billing_period": "one_time",
            "message_limit": 0,
            "description": "See your match % in seconds - green flags, red flags, and a shareable card.",
            "features": {
                "usage_limit": 1,
                "feature_type": "compatibility_score",
                "total_message": 0
            }
        },
        "marriage": {
            "slug": "marriage-report",
            "plan_name": "Marriage Report",
            "price": 1199,
            "billing_period": "one_time",
            "message_limit": 5,
            "description": "Compatibility, Manglik, marriage-timing windows, remedies + detailed AI reading with both kundalis",
            "features": {
                "usage_limit": 1,
                "feature_type": "marriage_report",
                "total_message": 5,
                "includes_compatibility_score": true
            }
        },
        "child": {
            "slug": "child-name-timing",
            "plan_name": "Child Timing & Name",
            "price": 1699,
            "billing_period": "one_time",
            "message_limit": 5,
            "description": "Nakshatra-based name suggestions and auspicious birth windows",
            "features": {
                "usage_limit": 1,
                "feature_type": "child_timing_name",
                "total_message": 5
            }
        }
    }
}

Get subscription and pricing plans

Request

Request Code Samples

Responses