Fetch user reminders

Returns all active reminders for the authenticated user, including reminders set for family members. Ordered by creation date.

Request: Bearer token

Success: 200 - data.reminders[] (each with the same fields as the create response, including family_key/family_member_name when set for a family member, and reference_slug for content-aware library/mantra reminders) plus data.total. Empty array if none.

Errors: 401 - invalid/expired 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": "Success",
    "data": {
        "reminders": [
            {
                "reminder_key": "Remind-83421",
                "reminder_type": "puja",
                "title": "Daily Puja",
                "description": "Time for your morning puja ritual.",
                "reminder_time": "07:00",
                "timezone": "Asia/Kolkata",
                "repeat_type": "daily",
                "is_active": true,
                "next_trigger_on": "2026-05-22T01:30:00Z"
            },
            {
                "reminder_key": "Remind-83422",
                "family_key": "Family-78321",
                "family_member_name": "Sunita Sharma",
                "reminder_type": "mantra",
                "reference_slug": "hanuman-chalisa",
                "title": "Evening Chant",
                "reminder_time": "19:00",
                "timezone": "Asia/Kolkata",
                "repeat_type": "weekly",
                "repeat_days": [
                    0,
                    2,
                    4
                ],
                "is_active": true,
                "next_trigger_on": "2026-05-25T13:30:00Z",
                "last_triggered_on": "2026-05-20T13:30:00Z"
            }
        ],
        "total": 2
    }
}

🟠401Unauthorized

Request

Request Code Samples

Responses