Get Conversation by ID
Messaging
Get Conversation by ID
Retrieve a single SMS conversation and its messages by its ID
GET
Get Conversation by ID
Enterprise Feature - SMS is only available on Enterprise plans. Contact your Bland representative for access.
Headers
string
required
Your API key for authentication
Path Parameters
string
required
The unique ID of the conversation to retrieve.
Response
object
The full conversation object, including its messages.
string
The unique ID of the conversation.
string
ISO timestamp for when the conversation was created.
string
ISO timestamp for when the conversation was last updated.
string
The user’s phone number in the conversation.
string
The assistant’s phone number in the conversation.
object|null
Variables stored on the conversation, or
null if none.string|null
The current node ID in the pathway, if any.
string|null
The UUID of the current pathway being used in this conversation.
string|null
The specific version of the pathway being used (e.g., “latest”, “v1.0”).
string|null
ISO timestamp when the conversation timed out due to inactivity, if applicable. When set, the conversation will not respond to new user messages but will store them.
boolean
Whether the conversation is still active.
string|null
The resolved delivery channel for this conversation:
"sms", "rcs", or "whatsapp". Determined based on the input channel and whether the messaging service supports RCS.string|null
AI-generated conversation summary, produced when the conversation ends and a summary prompt is configured on the SMS number.
object|null
Extracted citation variable values from the conversation transcript. Keys are variable names, values are the extracted data. Only populated when citation schemas are configured.
string|null
The first successful outcome result tag. Provides a quick classification of the conversation outcome without needing to inspect the full
disposition_logs.array
An array of message objects in the conversation, sorted chronologically.
string
Unique ID of the message.
string
ISO timestamp of when the message was created.
string
The message body.
string
Sender phone number.
string
Receiver phone number.
string
Either
"USER" or "AGENT" to indicate who sent the message.string
Delivery status of the message. Possible values:
"pending", "queued", "sent", "delivered", "read", "failed", "undelivered". The "read" status is available for RCS and WhatsApp channels.string|null
Twilio error code if the message failed, otherwise
null.array
An array of outcome run results for this conversation. Each entry represents one outcome that was evaluated when the conversation ended.
string
The ID of the outcome that was run.
number
The version of the outcome’s transformation code that was executed.
string
The execution status.
"COMPLETE" indicates the outcome ran successfully, "ERROR" indicates a failure.object|null
The extracted outcome values, or
null if the run failed.string|null
Error message if the outcome run failed, otherwise
null.number
Execution time in milliseconds.
null|array
null on success, or a list of error objects if a failure occurred.Docs for agents: llms.txt