Get a mantra

Request: slug path param; Bearer token optional

Returns a published mantra: full data (mantra_text, meaning, benefits, performing_time, performing_way, audio_url, chant_count, …) plus puja_vidhis[] - the puja(s) this mantra is recited in, each returned in full with ordered steps[] and samagri[] so the puja screen renders without another call.

Premium gating: if the mantra is premium (is_premium=true) and the caller is anonymous or on the free Seeker plan, the response is locked - is_locked=true, mantra_text empty and the heavy fields (meaning/explanation/benefits/performing_*/audio_url) + puja_vidhis withheld - with an upgrade message. An active Sage/Guru subscriber gets the full mantra.

Success: 200 - full mantra data, or the locked teaser for gated premium.

Errors: 404 - not found

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Mantra fetched successfully",
    "data": {
        "name": "Gayatri Mantra",
        "slug": "gayatri-mantra",
        "short_description": "The revered Vedic prayer for clarity and inner light.",
        "mantra_text": "ॐ भूर्भुवः स्वः … (Devanagari + transliteration)",
        "meaning": "We meditate on the divine light of the sun…",
        "explanation": "The most revered Vedic mantra…",
        "benefits": "Clarity, wisdom, spiritual awakening.",
        "performing_time": "Brahma muhurta (pre-dawn) and at sunrise.",
        "performing_way": "Sit facing east, 108 times with a mala.",
        "audio_url": "https://audio.hastaai.in/audio/mantras/abc123",
        "narration_url": "https://audio.hastaai.in/audio/mantras/narr-abc123",
        "is_premium": false,
        "is_locked": false,
        "chant_count": 108,
        "puja_vidhis": [
            {
                "name": "Jagannath Puja",
                "slug": "jagannath-puja",
                "description": "Worship of Lord Jagannath, Balabhadra, and Subhadra.",
                "puja_type": "festival",
                "steps": [
                    {
                        "step_number": 1,
                        "title": "Preparation",
                        "description": "Clean the puja space and sit calmly."
                    },
                    {
                        "step_number": 2,
                        "title": "Sankalp",
                        "description": "Take a simple sankalp with name, place, date, and purpose."
                    }
                ],
                "samagri": [
                    {
                        "item_name": "Diya",
                        "quantity": "2",
                        "is_required": true
                    },
                    {
                        "item_name": "Flowers",
                        "quantity": "1 bunch",
                        "is_required": true
                    }
                ],
                "mantras": [
                    {
                        "name": "Om Namo Bhagavate Vasudevaya",
                        "slug": "om-namo-bhagavate-vasudevaya",
                        "short_description": "The twelve-syllable mantra of Lord Vishnu.",
                        "chant_count": 108
                    }
                ]
            }
        ],
        "has_reminder": false,
        "created_at": "2026-06-23T10:30:00Z"
    }
}

🟠404Record Not Found

🟠422Parameter Error

Request

Request Code Samples

Responses