Get conversation
Retrieve details and metadata for a specific conversation. Requires accountId query parameter.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
Query Parameters
The social account ID
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.messages.getInboxConversation({ path: { conversationId: 'conversation_abc123', }, query: { accountId: 'account_abc123', },});console.log(data);{
"data": {
"id": "string",
"accountId": "string",
"accountUsername": "string",
"platform": "string",
"status": "active",
"participantName": "string",
"participantId": "string",
"participantVerifiedType": "blue",
"lastMessage": "string",
"lastMessageAt": "2019-08-24T14:15:22Z",
"updatedTime": "2019-08-24T14:15:22Z",
"participants": [
{
"id": "string",
"name": "string"
}
],
"instagramProfile": {
"isFollower": true,
"isFollowing": true,
"followerCount": 0,
"isVerified": true,
"fetchedAt": "2019-08-24T14:15:22Z"
}
}
}{
"error": "Unauthorized"
}List messages GET
Fetch messages for a specific conversation, with cursor-based pagination and ordering control. Pagination: pass `pagination.nextCursor` from a prior response back as the `cursor` query param to fetch the next page. The cursor is opaque; do not parse or construct it client-side. Sort order: defaults to `asc` (oldest first, chat style). For the "show me the latest messages" pattern, pass `?sortOrder=desc&limit=N`. For Twitter, Facebook and Bluesky, the upstream APIs only return newest-first and have no order parameter — sort order is best-effort and only reverses items within a single page (pages still walk newest→oldest). The response field `sortOrderApplied` tells you what was actually applied. Reddit threads are paginated client-side because Reddit's API has no per-thread cursor. Very long threads may be upstream-truncated by Reddit's inbox/sent windows (~100 most-recent items each); this is a Reddit platform limitation. Twitter/X limitation: X's encrypted "X Chat" messages are not accessible via the API. Conversations where the other participant uses encrypted X Chat may only show your outgoing messages. See the list conversations endpoint for more details.
Update conversation status PUT
Archive or activate a conversation. Requires accountId in request body.