Messaging
Get Conversation Messages
Load the message history for a single Instagram conversation.
Load the messages in one conversation, most recent first. Use the conversation id returned by List Conversations.
Supported platforms: instagram
Request
GET /v1/messages/{conversationId}
x-access-key: YOUR_ACCESS_KEYPath parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
conversationId | string | Yes | Platform conversation ID |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
platform | string | Yes | instagram |
accountId | string | Yes | Integration ID from list_integrations |
limit | integer | No | Max messages to return (1–100, default 25) |
after | string | No | Pagination cursor from a previous response |
Response
{
"success": true,
"messages": [
{
"id": "mid.aWdfbXNnXzk5OQ",
"text": "Do you ship internationally?",
"from": { "id": "17841400000000001", "name": "Jane Doe" },
"timestamp": "2026-08-05T16:40:00.000Z"
},
{
"id": "mid.aWdfbXNnXzk5OA",
"text": "Hi! Yes, we ship worldwide.",
"from": { "id": "17841400000000000", "name": "Your Brand" },
"timestamp": "2026-08-05T16:41:30.000Z"
}
],
"nextCursor": null
}Pass nextCursor as after in the next request to load older messages. null means no more pages.