List festivals for the user's regions

Request: No body - auth token only. Returns all active festivals (current year) filtered to the user's region set = birth region ∪ current region ∪ pan-India (so native festivals are never missed while away), ordered by date.

Success: 200 - data.festivals is a list of {name, slug, description, festival_date, festival_type, importance, has_vidhi} - has_vidhi flags whether the festival has a linked puja vidhi (drives a "puja vidhi" CTA on the card without an extra call), plus a data.glossary[] explaining festival terms (Ekadashi, Amavasya, Purnima ...) in plain language.

Errors: 401 invalid/missing token.

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": "Festivals fetched",
    "data": {
        "festivals": [
            {
                "name": "Rath Yatra",
                "slug": "rath-yatra",
                "description": "Jagannath Rath Yatra festival, especially celebrated in Odisha.",
                "festival_date": "2026-07-16",
                "festival_type": "regional",
                "importance": 1,
                "has_vidhi": true
            }
        ],
        "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."
            }
        ]
    }
}

🟠401Unauthorized

List festivals for the user's regions

Request

Request Code Samples

Responses