# History Summary

### Endpoint

The endpoint to access this history summary is working with a GET request :

```url
https://www.owlbot.ai/api/chatbot/[id]/conversation
```

Remember to use the **API Token** in the headers as show in the [Authentication section](https://documentation.owlbot.ai/core-concepts/authentication).

The required parameters are : 

| Property  | Type | Description                                       |
| --------- | ---- | ------------------------------------------------- |
| **\[id]** | uuid | Chatbot `UUID` you want to have chat history from |

{% hint style="info" %}
remember to find your chatbot UUID after listing all your chatbot as shown in [previous section](https://documentation.owlbot.ai/bot-customisation/list-bots).
{% endhint %}

## Example of Response

Response is a HTTP 200 Array with a list of JSON source object : 

{% code overflow="wrap" %}

```json
[
   {
      "id":629,
      "created_at":"2023-07-31T04:46:01.920296+00:00",
      "user_agent":"Mozilla/5.0 (iPhone; CPU iPhone OS 16_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/114.0.5735.124 Mobile/15E148 Safari/604.1",
      "uuid":"e659d963-8412-4fce-b0ee-XXXXX",
      "visibility":1,
      "ip":"XX.136.66.XX",
      "geo":{
         "city":"Paris",
         "region":"cdg1",
         "country":"FR",
         "latitude":"XX.8323",
         "longitude":"XX.4075",
         "countryRegion":"XXX"
      },
      "chatbot_uuid":"694f0f35-a082-41a8-85d5-XXXX",
      "session_uuid":"d48a5374-e952-4c5f-8c0f-XXXXXXX",
      "messagenbr":5
   },
   {///},
   {///}

]
```

{% endcode %}

Here as the description of the details provided : 

| Property          | Type                          | Description                                                                                                                          |
| ----------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **id**            | number                        | unique identifier                                                                                                                    |
| **created\_at**   | timestamp                     | Timedate creation of the user session                                                                                                |
| **user\_agent**   | json                          | This typically includes the type and version of browser, operating system, and sometimes other information such as default language. |
| **uuid**          | Universally Unique Identifier | 128-bit number used to uniquely identify some object or entity on the internet.                                                      |
| **visibility**    | number (0, 1, 2)              | usefull to filter message you have seen, archive or delete                                                                           |
| **ip**            | IPV4 or IPV6 Address          | IP of the user who initiate the session                                                                                              |
| **geo**           | json                          | a JSON giving you information about the user location                                                                                |
| **chatbot\_uuid** | Universally Unique Identifier | UUID of corresponding chatbot                                                                                                        |
| **session\_uuid** | Universally Unique Identifier | uuid to identiy this session                                                                                                         |
| **messagenbr**    | number                        | Number of message the user sent (message from Ai chatbot are not count)                                                              |

{% hint style="info" %}
the usefull parameters is the "**session\_uuid**", you can use it to retreive all the message from a given session
{% endhint %}