GET /api/action/mapaprop-chat-ai-v1/history/{questionId}

BETA

Returns the full history of a conversation: the visitor's contact data, the initial message and all messages added to the thread, sorted chronologically.

Resource information
Authentication	Required (API Token, Bearer)
Scope	`mapaprop-chat-ai`
HTTP Method	GET
Response	JSON
Version	1

Resource URL

https://mapaprop.app/api/action/mapaprop-chat-ai-v1/history/{questionId}

Parameters

Key	Type	Required	Description
questionId	int	yes	Conversation ID. Sent as part of the URL (path param), not as a query string or body.

Sample code

GET /api/action/mapaprop-chat-ai-v1/history/481203 HTTP/1.1
Host: mapaprop.app
Authorization: Bearer {access_token}

Response

Object	Field	Type	Required	Description
Response	questionId	int	yes	The ID of the queried conversation.
	leadName	string	yes	Visitor's name.
	leadEmail	string	no	Visitor's email.
	leadPhone	string	no	Visitor's phone number.
	sessionId	string	no	Session identifier associated with the conversation.
	createdAt	string	yes	Conversation creation date/time.
	messageCount	int	yes	Total number of messages (initial message + thread).
	messages	array of objects	yes	The conversation's messages, in chronological order. See structure below.
	metadata	object or string	no	Additional metadata saved in the conversation (for example `propertiesReferenced`, `customerSearch`). If the saved data is not valid JSON, it's returned as-is as a string.

Structure of each `messages` element

Field	Type	Description
id	int	`0` for the conversation's initial message; `1, 2, 3...` for the thread messages, in order.
from	string	Sender's name.
message	string	The message content.
direction	int	`1` = inbound/visitor, `2` = outbound/agent or system, `3` = AI.
timestamp	string	Message date/time.

Errors

Error	Cause
`QUESTION_NOT_FOUND`	The `questionId` sent doesn't exist or doesn't belong to this customer.

Validation errors (the request is cut off)

Error	Cause
`REQUIRED_INPUT` — "questionId is required"	The `questionId` path param is not a valid number.

Sample response

{
    "questionId": 481203,
    "leadName": "Juan Pérez",
    "leadEmail": "juan@example.com",
    "leadPhone": "+54 9 11 5555-5555",
    "sessionId": "b6d1c6b0-2f2a-4e2e-9a4a-8e0a2a2f2a11",
    "createdAt": "2026-08-01 14:32:10",
    "messageCount": 3,
    "messages": [
        {
            "id": 0,
            "from": "Juan Pérez",
            "message": "Nueva conversacion de Chat AI",
            "direction": 1,
            "timestamp": "2026-08-01 14:32:10"
        },
        {
            "id": 1,
            "from": "AI Assistant",
            "message": "Hola Juan! Soy el asistente virtual de la inmobiliaria. ¿En qué puedo ayudarte?",
            "direction": 3,
            "timestamp": "2026-08-01 14:32:10"
        },
        {
            "id": 2,
            "from": "Juan Pérez",
            "message": "¿Tenés departamentos de 2 ambientes en Palermo?",
            "direction": 1,
            "timestamp": "2026-08-01 14:33:02"
        }
    ]
}