GET
/
v1
/
sms
/
conversations
/
{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
}

​
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
}