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

# Attention: List Conversations

> List recorded Attention calls with transcripts, filterable by date, participant, team and status. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

List recorded Attention calls with transcripts, filterable by date, participant, team and status.

> [!NOTE]
>
> Tool ID: `attention_list_conversations`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_list_conversations',
  {
    "fromDateTime": "2026-01-15T12:00:00Z",
    "toDateTime": "2026-01-15T12:00:00Z",
    "page": 123
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_list_conversations --input '{
  "fromDateTime": "2026-01-15T12:00:00Z",
  "toDateTime": "2026-01-15T12:00:00Z",
  "page": 123
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "data": [
      {
        "type": "conversations",
        "id": "id_123"
      }
    ],
    "links": {
      "self": "example",
      "related": "example"
    },
    "meta": {
      "pageCount": 123,
      "totalRecords": 123,
      "pageNumber": 123
    }
  }
}
```

Use `deepline describe attention_list_conversations --json` for the latest machine-readable contract.

## Input reference

Retrieves a paginated list of conversations with their transcriptions. Supports various filtering options to narrow down the results based on date ranges, participants, teams, and conversation status.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.fromDateTime` | `string` | No | — | Start date and time for filtering conversations (ISO 8601 format) |
| `payload.toDateTime` | `string` | No | — | End date and time for filtering conversations (ISO 8601 format) |
| `payload.page` | `integer` | No | — | Page number for pagination (starts from 1) |
| `payload.size` | `integer` | No | — | Number of items per page |
| `payload.filter` | `object` | No | — | Filter conversations by owner IDs |
| `payload.detailedTranscript` | `boolean` | No | `false` | Include detailed transcript information in the response |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieves a paginated list of conversations with their transcriptions. Supports various filtering options to narrow down the results based on date ranges, participants, teams, and conversation status.",
    "properties": {
      "fromDateTime": {
        "type": "string",
        "description": "Start date and time for filtering conversations (ISO 8601 format)"
      },
      "toDateTime": {
        "type": "string",
        "description": "End date and time for filtering conversations (ISO 8601 format)"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination (starts from 1)"
      },
      "size": {
        "type": "integer",
        "description": "Number of items per page"
      },
      "filter": {
        "type": "object",
        "description": "Filter conversations by owner IDs",
        "properties": {
          "owner.id": {
            "type": "array",
            "description": "Filter conversations by owner IDs",
            "items": {
              "type": "string"
            }
          },
          "owner.email": {
            "type": "array",
            "description": "Filter conversations by owner email addresses",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "description": "Filter conversations by title using case-insensitive partial matching"
          },
          "participants.email": {
            "type": "array",
            "description": "Filter conversations by participant email addresses",
            "items": {
              "type": "string"
            }
          },
          "external_opportunity.id": {
            "type": "array",
            "description": "Filter conversations by external opportunity IDs",
            "items": {
              "type": "string"
            }
          },
          "crm_field.entity_code": {
            "type": "string",
            "description": "CRM platform entity code to filter linked CRM records (e.g. companies, contacts, deals, owners, pipelines, users, account, contact, lead, opportunity, user)",
            "enum": [
              "companies",
              "contacts",
              "deals",
              "owners",
              "pipelines",
              "users",
              "account",
              "contact",
              "lead",
              "opportunity",
              "user"
            ]
          },
          "crm_field.field_name": {
            "type": "string",
            "description": "CRM record field name (from org_crm_records.record_data) to match on linked CRM records"
          },
          "crm_field.values": {
            "type": "array",
            "description": "Exact values to match for the given CRM field. Values are OR'ed together.",
            "items": {
              "type": "string"
            }
          },
          "team.id": {
            "type": "array",
            "description": "Filter conversations by team IDs",
            "items": {
              "type": "string"
            }
          },
          "hide_internal": {
            "type": "boolean",
            "description": "Exclude internal conversations from results"
          },
          "hide_non_analyzed": {
            "type": "boolean",
            "description": "Exclude conversations that haven't been analyzed"
          },
          "analyzed": {
            "type": "boolean",
            "description": "Filter conversations by analysis status (deprecated, use filter[hide_non_analyzed] instead)"
          },
          "hide_pending": {
            "type": "boolean",
            "description": "Exclude conversations that are pending processing"
          },
          "hide_transcript": {
            "type": "boolean",
            "description": "Exclude conversations without transcripts"
          },
          "hide_failed": {
            "type": "boolean",
            "description": "Exclude conversations that failed processing"
          },
          "include_internal_participants": {
            "type": "boolean",
            "description": "Include internal participants in the response"
          },
          "include_zoom_metadata": {
            "type": "boolean",
            "description": "Include Zoom-specific metadata in the response"
          },
          "include_import_metadata": {
            "type": "boolean"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "detailedTranscript": {
        "type": "boolean",
        "description": "Include detailed transcript information in the response",
        "default": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].type` | `"conversations"` | No | — | Allowed: `conversations`. |
| `result.data.data[].id` | `string` | No | — | — |
| `result.data.data[].attributes` | `object` | No | — | — |
| `result.data.data[].attributes.uuid` | `string` | No | — | — |
| `result.data.data[].attributes.transcript` | `record` | No | — | — |
| `result.data.data[].attributes.boards` | `array` | No | — | — |
| `result.data.data[].attributes.boards[].uuid` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board` | `object` | No | — | — |
| `result.data.data[].attributes.boards[].board.uuid` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board.name` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns` | `array` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns[].id` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns[].title` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns[].children` | `array` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns[].children[].uuid` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns[].children[].keywords` | `array` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns[].children[].response` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board.columns[].children[].text` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].board.team` | `object` | No | — | Represents a team in the system with its properties and hierarchical structure |
| `result.data.data[].attributes.boards[].board.team.uuid` | `string` | No | — | Unique identifier of the team |
| `result.data.data[].attributes.boards[].board.team.name` | `string` | No | — | Name of the team |
| `result.data.data[].attributes.boards[].board.team.phrases` | `array` | No | — | List of keywords or phrases associated with the team |
| `result.data.data[].attributes.boards[].board.team.slackConnection` | `object` | No | — | Represents the Slack integration details for a team |
| `result.data.data[].attributes.boards[].board.team.slackConnection.id` | `string` | No | — | Slack connection identifier |
| `result.data.data[].attributes.boards[].board.team.slackConnection.info` | `object` | No | — | Information about a connected Slack team |
| `result.data.data[].attributes.boards[].board.team.slackConnection.info.id` | `string` | No | — | Slack team identifier |
| `result.data.data[].attributes.boards[].board.team.slackConnection.info.name` | `string` | No | — | Name of the Slack team |
| `result.data.data[].attributes.boards[].board.team.domain` | `string` | No | — | Domain associated with the team |
| `result.data.data[].attributes.boards[].board.team.organizerJoinInternalMeetings` | `boolean` | No | — | Whether team organizers can join internal meetings |
| `result.data.data[].attributes.boards[].board.team.consentEmailEnabled` | `boolean` | No | — | Whether email consent is enabled for the team |
| `result.data.data[].attributes.boards[].board.team.parentTeamUUID` | `string` | No | — | UUID of the parent team if this team is part of a hierarchy |
| `result.data.data[].attributes.boards[].board.team.organizationUUID` | `string` | No | — | UUID of the organization this team belongs to |
| `result.data.data[].attributes.boards[].board.team.children` | `array` | No | — | List of child teams if this team has a hierarchical structure |
| `result.data.data[].attributes.boards[].board.teamUUID` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].battlecards` | `array` | No | — | — |
| `result.data.data[].attributes.boards[].battlecards[].uuid` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].battlecards[].activatedBattlecardID` | `string` | No | — | — |
| `result.data.data[].attributes.boards[].battlecards[].hidden` | `boolean` | No | — | — |
| `result.data.data[].attributes.boards[].battlecards[].feedbackAction` | `string` | No | — | — |
| `result.data.data[].attributes.finishedAt` | `string` | No | — | Format: `date-time`. |
| `result.data.data[].attributes.title` | `string` | No | — | — |
| `result.data.data[].attributes.liveStreamStartedAt` | `string` | No | — | Format: `date-time`. |
| `result.data.data[].attributes.liveStreamEndedAt` | `string` | No | — | Format: `date-time`. |
| `result.data.data[].attributes.talktracks` | `array` | No | — | — |
| `result.data.data[].attributes.talktracks[].uuid` | `string` | No | — | — |
| `result.data.data[].attributes.talktracks[].items` | `array` | No | — | — |
| `result.data.data[].attributes.talktracks[].items[].uuid` | `string` | No | — | — |
| `result.data.data[].attributes.talktracks[].items[].activatedItemId` | `string` | No | — | — |

The table shows the first 50 fields. Use the live contract below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe attention_list_conversations --json`.

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Attention provider guide](https://deepline.com/docs/providers/attention/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.