Get Conversation by ID

Retrieve a single SMS conversation and its messages by its ID

GET /v1/sms/conversations/{id}

Get Conversation by ID

cURL

curl --request GET \
  --url https://api.bland.ai/v1/sms/conversations/{id} \
  --header 'authorization: <authorization>'

Response

{
  "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": "[phone]",
    "agent_number": "[phone]",
    "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": "[phone]",
        "to": "[phone]",
        "sender": "USER",
        "id": 100001,
        "status": null,
        "error_code": null
      },
      {
        "created_at": "2025-05-13T20:51:00.917Z",
        "message": "Hey, what's up?",
        "from": "[phone]",
        "to": "[phone]",
        "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.

Response

{
  "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": "[phone]",
    "agent_number": "[phone]",
    "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": "[phone]",
        "to": "[phone]",
        "sender": "USER",
        "id": 100001,
        "status": null,
        "error_code": null
      },
      {
        "created_at": "2025-05-13T20:51:00.917Z",
        "message": "Hey, what's up?",
        "from": "[phone]",
        "to": "[phone]",
        "sender": "AGENT",
        "id": 100002,
        "status": "delivered",
        "error_code": null
      }
    ]
  },
  "errors": null
}