# get_chat: Get a chat

Read one conversation. This action only reads; it changes nothing. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/get_chat
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "chatId": "PASTE_CHAT_ID_HERE"
}
```

## What you give it

- `chatId` (needed): a chat id. The conversation id (from list_chats). Where to get it: Run `list_chats` and use `chats[].id`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `id`: a chat id
- `accountType`: WHATSAPP | LINKEDIN | SLACK | TWITTER | MESSENGER | INSTAGRAM | TELEGRAM
- `providerId`: string
- `attendeeProviderId`: a member id
- `name`: string or null
- `type`: 0 | 1 | 2
- `timestamp`: string or null
- `unreadCount`: number
- `archived`: 0 | 1
- `mutedUntil`: -1 | string or null
- `readOnly`: 0 | 1 | 2
- `disabledFeatures`: reactions | reply[]
- `subject`: string
- `organizationId`: string
- `mailboxId`: string
- `contentType`: inmail | sponsored | linkedin_offer
- `folder`: INBOX | INBOX_LINKEDIN_CLASSIC | INBOX_LINKEDIN_RECRUITER | INBOX_LINKEDIN_SALES_NAVIGATOR | INBOX_LINKEDIN_ORGANIZATION | INBOX_INSTAGRAM_GENERAL | PENDING | OTHER | SPAM | ARCHIVED | HIDDEN | UNKNOWN | string[]
- `pinned`: 0 | 1
- `lastMessage.messageId`: string
- `lastMessage.providerId`: string
- `lastMessage.senderId`: string
- `lastMessage.text`: string or null
- `lastMessage.id`: a message id
- `lastMessage.chatId`: string
- `lastMessage.chatProviderId`: string
- `lastMessage.timestamp`: string
- `lastMessage.isSender`: 0 | 1
- `lastMessage.isForwarded`: boolean
- `lastMessage.isViewOnce`: boolean
- `lastMessage.seen`: 0 | 1
- `lastMessage.hidden`: 0 | 1
- `lastMessage.deleted`: 0 | 1
- `lastMessage.edited`: 0 | 1
- `lastMessage.isEvent`: 0 | 1
- `lastMessage.delivered`: 0 | 1
- `lastMessage.behavior`: 0 or null
- `lastMessage.eventType`: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14
- `lastMessage.original`: string
- `lastMessage.replies`: number
- `lastMessage.replyBy`: string[]
- `lastMessage.parent`: string
- `lastMessage.senderAttendeeId`: string
- `lastMessage.subject`: string or null
- `lastMessage.messageType`: MESSAGE | INVITATION | INMAIL | INMAIL_DECLINE | INMAIL_REPLY | INMAIL_ACCEPT | STORY_MENTION | STORY_REPLY | CONTACT
- `lastMessage.attendeeType`: MEMBER | ORGANIZATION | OTHER
- `lastMessage.attendeeDistance`: 1 | 2 | 3 | 4 | -1
- `lastMessage.senderUrn`: string

Page: https://heyreagent.com/docs/actions/get_chat