Get a conversation's messages

Request: chat_key path param; Bearer token required

Returns the full message history of one thread, oldest first - use it to render a reopened conversation.

This is also the fallback for the streamed reply: because the /ws/stream socket pushes tokens live with no replay, a client that connected late (or dropped) can call this once generation finishes to fetch the complete, persisted Nandini reply.

Each message has sender (USER | NANDINI), message, message_type, image_url (attached image, if any), created_at (human-readable UTC string), and created_timestamp (same instant as Unix epoch milliseconds - sort/compare on this instead of parsing created_at).

Success: 200 - data.chat_key, data.messages[].

Errors: 401 - invalid/expired token | 404 - conversation 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": "Conversation fetched successfully",
    "data": {
        "chat_key": "Chat-Q3SFA3",
        "messages": [
            {
                "sender": "USER",
                "message": "check my kundali",
                "message_type": "text",
                "image_url": "https://images.hastaai.in/nandini/docs/6edc7dae-2e76-4dc9-bd11-e6c70d85e581",
                "created_at": "2026-07-24T16:37:51Z",
                "created_timestamp": 1784911071000
            },
            {
                "sender": "NANDINI",
                "message": "I'm unable to interpret images directly. However, if you have specific questions about your kundali based on your birth details, feel free to ask!",
                "message_type": "text",
                "created_at": "2026-07-24T16:37:58Z",
                "created_timestamp": 1784911078000
            },
            {
                "sender": "USER",
                "message": "now",
                "message_type": "text",
                "image_url": "https://images.hastaai.in/nandini/docs/40ec4fcf-24bc-4af5-b779-8a7ec8786510",
                "created_at": "2026-07-24T16:52:19Z",
                "created_timestamp": 1784911939000
            },
            {
                "sender": "NANDINI",
                "message": "I'm unable to interpret or extract any text or astrological information from this image. If you have questions about your kundali based on your birth details, feel free to ask!",
                "message_type": "text",
                "created_at": "2026-07-24T16:52:25Z",
                "created_timestamp": 1784911945000
            }
        ]
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

Get a conversation's messages

Request

Request Code Samples

Responses