OpenIntegrations/docs/en/md/GreenAPI/Message-logs/Get-chat-history.mdx

---
sidebar_position: 1
description: Get chat history and other functions to work with Green API in the Open Integration Package, a free open-source integration library for 1C:Enterprise 8, OneScript and CLI
keywords: [1C, 1С, 1С:Enterprise, 1С:Enterprise 8.3, API, Integration, Services, Exchange, OneScript, CLI, Green API]
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Get chat history
 Retrieves the chat message history



`Function GetChatHistory(Val AccessParameters, Val ChatID, Val Count = 100) Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | AccessParameters | --access | Structure Of KeyAndValue | ✔ | Access parameters. See FormAccessParameters |
  | ChatID | --chat | String | ✔ | Chat identifier |
  | Count | --count | Number | ✖ | Number of messages to receive |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Green API

<br/>

:::tip
Method at API documentation: [GetChatHistory](https://green-api.com/docs/api/journals/GetChatHistory/)
:::
<br/>


```bsl title="1C:Enterprise/OneScript code example"
    ApiUrl           = FunctionParameters["GreenAPI_ApiURL"];
    MediaUrl         = FunctionParameters["GreenAPI_MediaURL"];
    IdInstance       = FunctionParameters["GreenAPI_IdInstance"];
    ApiTokenInstance = FunctionParameters["GreenAPI_Token"];

    ChatID = FunctionParameters["GreenAPI_TestGroupID"];

    AccessParameters = OPI_GreenAPI.FormAccessParameters(ApiUrl, MediaUrl, IdInstance, ApiTokenInstance);
    Result           = OPI_GreenAPI.GetChatHistory(AccessParameters, ChatID);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            # JSON data can also be passed as a path to a .json file
            
            oint greenapi GetChatHistory \
             --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" \
             --chat "120363410406221140@g.us"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            :: JSON data can also be passed as a path to a .json file
            
            oint greenapi GetChatHistory ^
             --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" ^
             --chat "120363410406221140@g.us"
        ```
    </TabItem>
</Tabs>


```json title="Result"
[
 {
  "type": "outgoing",
  "idMessage": "BAE5A96E72014E09",
  "timestamp": 1760462790,
  "typeMessage": "extendedTextMessage",
  "chatId": "120363410406221140@g.us",
  "textMessage": "Новое сообщение",
  "extendedTextMessage": {
   "text": "Новое сообщение",
   "description": "",
   "title": "",
   "previewType": "None",
   "jpegThumbnail": "",
   "forwardingScore": 1,
   "isForwarded": true
  },
  "statusMessage": "sent",
  "sendByApi": true,
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "BAE5521E230AF357",
  "timestamp": 1760462789,
  "typeMessage": "contactMessage",
  "chatId": "120363410406221140@g.us",
  "contact": {
   "displayName": "Велосипед",
   "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;;;\nFN:Велосипед\nORG:Велосипед\nTEL;type=CELL;type=VOICE;waid=79001234568:+79001234568\nEND:VCARD",
   "forwardingScore": 0,
   "isForwarded": false
  },
  "quotedMessage": {
   "stanzaId": "BAE5D5C2E89AC0A1",
   "participant": "1234567890@c.us",
   "typeMessage": "contactMessage",
   "contact": {
    "displayName": "Артем Евпаторийский Петрович",
    "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:Петрович;Артем;Евпаторийский;\nFN:Артем Евпаторийский Петрович\nORG:Велосипед\nTEL;type=CELL;type=VOICE;waid=79001234568:+79001234568\nEND:VCARD",
    "forwardingScore": 0,
    "isForwarded": false
   },
   "deletedMessageId": "",
   "editedMessageId": "",
   "isEdited": false,
   "isDeleted": false
  },
  "statusMessage": "sent",
  "sendByApi": true,
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "BAE5D5C2E89AC0A1",
  "timestamp": 1760462788,
  "typeMessage": "contactMessage",
  "chatId": "120363410406221140@g.us",
  "contact": {
   "displayName": "Артем Евпаторийский Петрович",
   "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:Петрович;Артем;Евпаторийский;\nFN:Артем Евпаторийский Петрович\nORG:Велосипед\nTEL;type=CELL;type=VOICE;waid=79001234568:+79001234568\nEND:VCARD",
   "forwardingScore": 0,
   "isForwarded": false
  },
  "statusMessage": "sent",
  "sendByApi": true,
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "BAE5FA5B08AD229B",
  "timestamp": 1760462787,
  "typeMessage": "locationMessage",
  "chatId": "120363410406221140@g.us",
  "location": {
   "nameLocation": "",
   "address": "",
   "jpegThumbnail": "",
   "latitude": 53.908522,
   "longitude": 27.574821,
   "forwardingScore": 0,
   "isForwarded": false
  },
  "quotedMessage": {
   "stanzaId": "BAE532401D3C7A83",
   "participant": "1234567890@c.us",
   "typeMessage": "locationMessage",
   "location": {
    "nameLocation": "Площадь Победы, Минск",
    "address": "пл. Победы",
    "jpegThumbnail": "",
    "latitude": 53.908522,
    "longitude": 27.574821,
    "forwardingScore": 0,
    "isForwarded": false
   },
   "deletedMessageId": "",
   "editedMessageId": "",
   "isEdited": false,
   "isDeleted": false
  },
  "statusMessage": "sent",
  "sendByApi": true,
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "BAE532401D3C7A83",
  "timestamp": 1760462786,
  "typeMessage": "locationMessage",
  "chatId": "120363410406221140@g.us",
  "location": {
   "nameLocation": "Площадь Победы, Минск",
   "address": "пл. Победы",
   "jpegThumbnail": "",
   "latitude": 53.908522,
   "longitude": 27.574821,
   "forwardingScore": 0,
   "isForwarded": false
  },
  "statusMessage": "sent",
  "sendByApi": true,
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "BAE5A63708A4C858",
  "timestamp": 1760462785,
  "typeMessage": "pollMessage",
  "chatId": "120363410406221140@g.us",
  "pollMessageData": {
   "name": "Какой ваш любимый цвет?",
   "options": [
    {
     "optionName": "Красный"
...
```