> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Unified call and SMS history with keyword search and rich filtering

The Conversations API provides a unified view of all calls and SMS messages, grouped by contact phone number. A "conversation" is the full history of interactions between your Allo number(s) and an external phone number.

## Key concepts

**Conversation** — a summary of interactions with a `contact_number`, including the matched contacts and the last interaction (last call, last SMS). Use the `/items` endpoints to access the full history.

**Conversation item** — a single call or SMS message. Use the search or get endpoints to retrieve full item details including transcripts, summaries, and recordings.

**Contact matching** — each conversation includes matched contacts with their company and deal information. A phone number can match zero, one, or multiple contacts.

**Keyword search** — search endpoints support keyword search across call transcripts, summaries, and SMS content. Use `sort=RELEVANCE` to order results by relevance.

**Extend** — use `?extend=transcript` to include full call transcripts on items. Transcripts are excluded by default to keep responses lightweight.

## Endpoints

<CardGroup cols={1}>
  <Card title="List conversations" href="/en/v2/api-reference/conversations/list-conversations">
    Conversation summaries with the last interaction per contact number
  </Card>

  <Card title="Get conversation item" href="/en/v2/api-reference/conversations/get-item">
    Full detail for a single call or SMS
  </Card>

  <Card title="Search conversation items" href="/en/v2/api-reference/conversations/search-conversation-items">
    Search calls and SMS across all conversations
  </Card>

  <Card title="Get many conversation items" href="/en/v2/api-reference/conversations/batch-get">
    Fetch multiple items by ID in a single request
  </Card>

  <Card title="Execute conversation action" href="/en/v2/api-reference/conversations/execute-action">
    Mark as read, unread, archive, or unarchive a conversation
  </Card>
</CardGroup>