---
title: "Search Conversations"
method: GET
path: "/v1/api/contact/{contact_id}/conversation"
tags: ["Conversations"]
deprecated: true
---

# Search Conversations

`GET /v1/api/contact/{contact_id}/conversation`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v1/api/contact/{contact_id}/conversation`
- Auth: API key in header `Authorization`

> **Deprecated.**

**Deprecated.** Use `POST /v2/api/conversations/items/search` instead. This endpoint still responds, but it is no longer maintained and is not part of the current API reference.

Search calls and SMS for a specific contact. Returns paginated results including call recordings, transcripts, AI summaries, and text messages.

## Path parameters

- `contact_id` string, required

## Query parameters

- `size` integer
- `page` integer
- `allo_number` string

## Response `200`

Conversation retrieved successfully

- GetContactConversationResponse: Standard response wrapper for contact conversation
  - `data` ConversationApiResponse: Paginated conversation history with calls and messages
    - `results` ConversationItemApiResponse[]: List of conversation items (calls and messages)
      - `type` 'CALL' | 'TEXT_MESSAGE': Type of conversation item
      - `call` CallApiResponse: A call record with details about the conversation
        - `id` string: Unique call identifier
        - `from_number` string: Phone number that initiated the call (E.164 format or 'anonymous')
        - `to_number` string, nullable: Phone number that received the call
        - `length_in_minutes` number, double: Duration of the call in minutes
        - `type` 'INBOUND' | 'OUTBOUND', nullable: Direction of the call
        - `result` 'ANSWERED' | 'VOICEMAIL' | 'TRANSFERRED_AI' | 'TRANSFERRED_EXTERNAL' | 'BLOCKED' | 'FAILED' | 'FAILED_EXTERNAL' | 'RECEIVED' | 'CLOSED': The outcome of the call. For outbound calls that reached voicemail, this will be VOICEMAIL regardless of the routing result. Common values: ANSWERED (call was answered), VOICEMAIL (call went to voicemail), TRANSFERRED_AI (transferred to AI agent), BLOCKED (call was blocked)
        - `summary` string, nullable: AI-generated summary of the call conversation
        - `tag` string, nullable: Tag/category assigned to the call
        - `recording_url` string, uri, nullable: URL to access the call recording
        - `start_date` string, date-time: When the call started (ISO 8601 format)
        - `transcript` TranscriptRow[], nullable: Transcript of the call conversation
          - `source` 'AGENT' | 'EXTERNAL' | 'USER': The source of this transcript entry (AGENT for AI assistant, EXTERNAL for the caller, USER for the Allo user)
          - `text` string: The transcribed text content
          - `time` string, date-time: When this transcript entry occurred (ISO 8601 format)
          - `start_seconds` number, double, nullable: Start time of this segment in seconds from call start
          - `end_seconds` number, double, nullable: End time of this segment in seconds from call start
      - `message` TextMessageApiResponse: Sent SMS message details
        - `from_number` string, nullable: Phone number that sent the message. Null when sender_id is used instead.
        - `sender_id` string, nullable: Sender ID used for the message (alphanumeric identifier). Only populated when sending with a verified Sender ID (e.g., for France SMS). Null when from_number is used.
        - `to_number` string: Phone number that received the message
        - `type` 'OUTBOUND': Direction of the message (always OUTBOUND for sent messages)
        - `content` string: Content of the SMS message
        - `start_date` string, date-time: When the message was sent
    - `metadata` PaginationMeta, nullable: Pagination metadata wrapper for contacts endpoint
      - `pagination` object
        - `total_pages` integer
        - `current_page` integer

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - API key lacks required scope
- `429`: Too Many Requests - Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v1/api/contact/:contact_id/conversation/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)