Developers
Open Swarmhit
Smart APIRaw API
API referenceLinkedin messaging
GET
/api/v1/chats/{id}/messages

Newest first, pages of 20 read from LinkedIn (up to 10 a call); cursor is a time anchor. A Sales Navigator InMail conversation is read from the Sales Navigator inbox, 10 messages a page; its messages carry subject, its people are Sales Navigator ids (ACw…) and their files are not listed.

Authorization

X-API-KEY<token>

Your API key from the console (gw_live_…).

In: header

Path Parameters

id*string

A LinkedIn chat id (lgc_…).

Query Parameters

limit?integer

How many messages to return. Default 20; a call reads at most 10 pages (200 messages, 100 in a Sales Navigator InMail conversation).

Range1 <= value
Default20
cursor?string

The cursor the previous page answered, passed back unchanged, for the next page. Leave it out for the first page; a null cursor means there is no next page. Opaque: its form differs by route.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/chats/lgc_Q2xpZW50Q2hhdA/messages?limit=50"
{  "object": "MessageList",  "items": [    {      "object": "Message",      "id": "lgm_Zm9vYmFyYmF6cXV4",      "message_id": "lgm_Zm9vYmFyYmF6cXV4",      "chat_id": "lgc_Q2xpZW50Q2hhdA",      "text": "Thanks, happy to talk next week.",      "timestamp": "2026-10-31T09:30:00.000Z",      "is_sender": 0,      "is_event": 0,      "sender_attendee_provider_id": "ACoAAB1a2b3c4d5e6f",      "sender_provider_id": "ACoAAB1a2b3c4d5e6f",      "attachments": []    }  ],  "cursor": null}

List conversations GET

Newest first, read from LinkedIn as the member's inbox scrolls (pages of 20, up to 10 pages a call). `cursor` is a time anchor to continue from. `unread=true` keeps only unread ones of the page read.

Mark a conversation read or unread PATCH

Only `setReadStatus` is supported on LinkedIn; any other action is 422.