Get Messages

Method: GET

Endpoint: https://api.assistable.ai/v2/get-conversation

This endpoint fetches the full conversation history for a specific contact.

Use Case: Use this to display the chat history in a custom UI (like a chat bubble on your website) so the user can see what they discussed with the AI previously.

1. Authorizations

You must verify your identity to read messages.

Header Name: Authorization
Value: Bearer <your_token_here>

2. Query Parameters

Since this is a GET request, you send the data in the URL (Query Parameters), not in the body.

Field	Type	Required?	Description
`location_id`	string	Yes	The unique ID of the GoHighLevel location.
`contact_id`	string	Yes	The specific Contact ID whose history you want to read.

3. Example Request (Code)

Copy the code below. Notice how the parameters are attached to the end of the URL with a ? and &.

Bash

curl --request GET \
  --url 'https://api.assistable.ai/v2/get-conversation?location_id=loc_12345&contact_id=cont_abc987' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'

4. Success Response

If successful, you will receive a 200 status and a list of message objects.

JSON

{
  "status": 200,
  "data": [
    {
      "role": "user",
      "content": "Hi, what are your hours?",
      "created_at": "2023-11-01T10:00:00Z"
    },
    {
      "role": "assistant",
      "content": "We are open 9am to 5pm, Monday through Friday.",
      "created_at": "2023-11-01T10:00:05Z"
    }
  ]
}

5. Troubleshooting

Empty List: If data is empty [], it means no conversation exists yet for this contact.
404 Not Found: Check that your location_id and contact_id are correct.
Order: Messages are usually returned in chronological order (oldest to newest), but you should check the timestamps to be sure.