Skip to main content
GET

Path Parameters

string
required
The remote (external) phone number in E.164 format, URL-encoded. Example: %2B14155559999 (for +14155559999).

Query Parameters

string
required
The Commune phone number ID to scope this conversation to. Format: pn_.... Required because the same remote number could have conversations with multiple of your phone numbers.

Response

SmsMessage[]
Array of messages in this conversation in ascending chronological order (oldest first). Maximum 100 messages returned. See List SMS Messages for the full message schema.
string
The conversation thread ID (32 hex characters). This is a SHA-256 hash derived from orgId:phoneNumberId:remoteNumber — deterministic and stable for the lifetime of the conversation.
Thread IDs are deterministic. The same combination of orgId, phone_number_id, and remote number always produces the same thread ID. You can compute it client-side if needed, but the API returns it for convenience.
Last modified on March 19, 2026