Skip to main content
GET
/
v1
/
api
/
contact
/
{contact_id}
/
conversation
Search Conversations
curl --request GET \
  --url https://api.withallo.com/v1/api/contact/{contact_id}/conversation \
  --header 'Authorization: <api-key>'
{
  "data": {
    "results": [
      {
        "type": "CALL",
        "call": {
          "id": "call_abc123",
          "from_number": "+1234567890",
          "to_number": "+0987654321",
          "length_in_minutes": 5.5,
          "type": "INBOUND",
          "summary": "Customer called about order status.",
          "tag": "support",
          "tags": [
            "support",
            "order"
          ],
          "recording_url": "https://storage.withallo.com/recordings/abc123.mp3",
          "start_date": "2024-01-15T10:30:00",
          "transcript": [
            {
              "source": "AGENT",
              "text": "Hello, how can I help you today?",
              "time": "2024-01-15T10:30:05",
              "start_seconds": 5,
              "end_seconds": 8.5
            }
          ]
        },
        "message": null
      },
      {
        "type": "TEXT_MESSAGE",
        "call": null,
        "message": {
          "from_number": "+1234567890",
          "to_number": "+0987654321",
          "type": "OUTBOUND",
          "content": "Thank you for contacting us!",
          "start_date": "2024-01-15T11:00:00"
        }
      }
    ],
    "metadata": {
      "pagination": {
        "total_pages": 5,
        "current_page": 0
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

Scope needed: CONVERSATIONS_READ

Path Parameters

​
contact_id
string
required

The unique identifier of the contact (e.g., "cnt_abc123")

Example:

"cnt_abc123"

Query Parameters

​
size
integer
default:10

Number of results per page. Must be between 1 and 100.

Required range: 1 <= x <= 100
​
page
integer
default:0

Page number (0-indexed).

Required range: x >= 0
​
allo_number
string

Filter conversations by a specific Allo phone number (E.164 format).

Example:

"+1234567890"

Response

Conversation retrieved successfully

Standard response wrapper for contact conversation

​
data
object

Paginated conversation history with calls and messages