Get my family members

Request: No body - auth token only

Returns a list of all active family members for the authenticated user. Requires a valid Bearer token.

Success: 200 - data.members is an array (each: family_key, full_name, relation, date_of_birth, birth_time, birth_place, latitude, longitude, timezone, gender, profile_image_url, palm_image_url, intents (array of {slug, name, description, icon} - empty array when none set; update via PATCH /users/family/{family_key}/intents), plus a kundali object (kundali_key, status - done/pending/processing/failed/not_generated) and a palm object (status - done/pending/processing/failed/not_uploaded)) plus data.total. Use these per-member statuses to decide whether to call GET /kundali/family/{family_key} or GET /palm/family/{family_key}. Empty list if no members. List is capped to the active plan's family_add allowance, oldest-added member(s) first - if a Child or Marriage report auto-added a partner/baby past that cap, it still exists (nothing is deleted) but is withheld here; data.hidden_count is how many, and they reappear automatically once the plan is upgraded.

Errors: 401 - missing/invalid 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": "Family members fetched",
    "data": {
        "members": [
            {
                "family_key": "Family-78321",
                "full_name": "Sunita Sharma",
                "relation": "Mother",
                "date_of_birth": "1965-03-10",
                "birth_time": "08:00:00",
                "birth_place": "Lucknow, India",
                "latitude": 26.8467,
                "longitude": 80.9462,
                "timezone": "Asia/Kolkata",
                "gender": "F",
                "intents": [
                    {
                        "slug": "career",
                        "name": "Career",
                        "description": "Growth, work and professional direction",
                        "icon": "https://images.hastaai.in/intent/career.webp"
                    }
                ],
                "kundali": {
                    "kundali_key": "Kundali-55012",
                    "status": "done"
                },
                "palm": {
                    "status": "not_uploaded"
                }
            }
        ],
        "total": 1,
        "hidden_count": 0
    }
}

🟠401Unauthorized

Request

Request Code Samples

Responses