GET
/
v1
/
sms
/
conversations
/
{id}
Get Conversation by ID
curl --request GET \
  --url https://api.bland.ai/v1/sms/conversations/{id} \
  --header 'authorization: <authorization>'
{
  "data": {
    "id": "convo_abc123",
    "created_at": "2025-05-13T20:50:59.233Z",
    "updated_at": "2025-05-13T20:50:59.233Z",
    "user_id": "user_abc123",
    "user_number": "+15550001111",
    "agent_number": "+15550002222",
    "inbound_id": 123456,
    "variables": null,
    "current_node_id": null,
    "last_message_at": "2025-05-13T20:50:59.233Z",
    "is_active": true,
    "messages": [
      {
        "created_at": "2025-05-13T20:50:59.708Z",
        "message": "<Call Connected>",
        "from": "+15550002222",
        "to": "+15550001111",
        "sender": "USER",
        "id": 100001,
        "status": null,
        "error_code": null
      },
      {
        "created_at": "2025-05-13T20:51:00.917Z",
        "message": "Hey, what's up?",
        "from": "+15550002222",
        "to": "+15550001111",
        "sender": "AGENT",
        "id": 100002,
        "status": "delivered",
        "error_code": null
      }
    ]
  },
  "errors": null
}
Enterprise Feature - SMS is only available on Enterprise plans. Contact your Bland representative for access.

Headers

authorization
string
required
Your API key for authentication

Path Parameters

id
string
required
The unique ID of the conversation to retrieve.

Response

data
object
The full conversation object, including its messages.
data.id
string
The unique ID of the conversation.
data.created_at
string
ISO timestamp for when the conversation was created.
data.updated_at
string
ISO timestamp for when the conversation was last updated.
data.user_number
string
The user’s phone number in the conversation.
data.agent_number
string
The assistant’s phone number in the conversation.
data.variables
object|null
Variables stored on the conversation, or null if none.
data.current_node_id
string|null
The current node ID in the pathway, if any.
data.is_active
boolean
Whether the conversation is still active.
data.messages
array
An array of message objects in the conversation, sorted chronologically.
data.messages[].id
string
Unique ID of the message.
data.messages[].created_at
string
ISO timestamp of when the message was created.
data.messages[].message
string
The message body.
data.messages[].from
string
Sender phone number.
data.messages[].to
string
Receiver phone number.
data.messages[].sender
string
Either "user" or "agent" to indicate who sent the message.
data.messages[].status
string
Delivery status of the message (e.g. "delivered", "failed").
data.messages[].error_code
string|null
Twilio error code if the message failed, otherwise null.
errors
null|array
null on success, or a list of error objects if a failure occurred.
{
  "data": {
    "id": "convo_abc123",
    "created_at": "2025-05-13T20:50:59.233Z",
    "updated_at": "2025-05-13T20:50:59.233Z",
    "user_id": "user_abc123",
    "user_number": "+15550001111",
    "agent_number": "+15550002222",
    "inbound_id": 123456,
    "variables": null,
    "current_node_id": null,
    "last_message_at": "2025-05-13T20:50:59.233Z",
    "is_active": true,
    "messages": [
      {
        "created_at": "2025-05-13T20:50:59.708Z",
        "message": "<Call Connected>",
        "from": "+15550002222",
        "to": "+15550001111",
        "sender": "USER",
        "id": 100001,
        "status": null,
        "error_code": null
      },
      {
        "created_at": "2025-05-13T20:51:00.917Z",
        "message": "Hey, what's up?",
        "from": "+15550002222",
        "to": "+15550001111",
        "sender": "AGENT",
        "id": 100002,
        "status": "delivered",
        "error_code": null
      }
    ]
  },
  "errors": null
}