List Conversations (Optimized)

curl --request GET \
  --url https://api.attention.tech/v2/conversations/list \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.attention.tech/v2/conversations/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.attention.tech/v2/conversations/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.attention.tech/v2/conversations/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.attention.tech/v2/conversations/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [],
  "links": {
    "self": "/v2/conversations?page=1",
    "related": "/v2/conversations?page=2"
  },
  "meta": {
    "totalRecords": 150
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

Conversation

List Conversations (Optimized)

Optimized alias for GET /conversations. Uses a batch query path that pre-fetches edges in a single pass, making it significantly faster for large result sets. Behavioural differences from /conversations: (1) extractedIntelligence and confirmedExtractedIntelligence are omitted by default — pass with_crm_records=true to include them; (2) empty conversations are not excluded; All filter parameters are identical to /conversations. Including private conversation metadata requires enablement by Attention for your organization; see filter[include_private].

GET

conversations

list

curl --request GET \
  --url https://api.attention.tech/v2/conversations/list \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.attention.tech/v2/conversations/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.attention.tech/v2/conversations/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.attention.tech/v2/conversations/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.attention.tech/v2/conversations/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [],
  "links": {
    "self": "/v2/conversations?page=1",
    "related": "/v2/conversations?page=2"
  },
  "meta": {
    "totalRecords": 150
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

Authorizations

Authorization

string

header

required

Query Parameters

fromDateTime

string

Start date and time for filtering conversations (ISO 8601 format)

toDateTime

string

End date and time for filtering conversations (ISO 8601 format)

fromUpdatedAtDateTime

string

Filter by last-updated lower bound (RFC 3339, e.g. 2026-04-01T00:00:00Z; fractional seconds and numeric UTC offsets accepted). Matches conversations whose updatedAt (when the conversation was last updated) is greater than or equal to this value. Only conversations that have an updatedAt are matched; updatedAt reflects changes to the conversation itself, not to related records such as scorecard results or CRM data. When set, results are ordered by updatedAt ascending and paged with cursor, and meta.totalRecords is a lower bound. For incremental sync, start with a full unfiltered pull, then pass the time of the previous sync minus a few minutes and deduplicate by id.

toUpdatedAtDateTime

string

Filter by last-updated upper bound (RFC 3339, e.g. 2026-04-10T23:59:59Z; fractional seconds and numeric UTC offsets accepted). Matches conversations whose updatedAt (when the conversation was last updated) is less than or equal to this value. Only conversations that have an updatedAt are matched. When set, results are ordered by updatedAt ascending and paged with cursor, and meta.totalRecords is a lower bound.

cursor

string

Opaque cursor returned as nextCursor by a previous call with the same filters. Omit on the first page. Requires fromUpdatedAtDateTime or toUpdatedAtDateTime; page is ignored when set.

page

integer

Page number for pagination (starts from 1)

size

integer

Number of items per page (max 50)

filter[owner.id]

string[]

Filter conversations by owner IDs

filter[owner.email]

string[]

Filter conversations by owner email addresses

filter[title]

string

Filter conversations by title using case-insensitive partial matching

filter[participants.email]

string[]

Filter conversations by participant email addresses

filter[external_opportunity.id]

string[]

Filter conversations by external opportunity IDs

filter[crm_field.entity_code]

enum<string>

CRM platform entity code to filter linked CRM records

Available options:

companies,

contacts,

deals,

owners,

pipelines,

users,

account,

contact,

lead,

opportunity,

user

filter[crm_field.field_name]

string

CRM record field name (from org_crm_records.record_data) to match on linked CRM records

filter[crm_field.values]

string[]

Exact values to match for the given CRM field. Values are OR-ed together. Maximum 10 entries.

filter[team.id]

string[]

Filter conversations by team IDs

filter[hide_internal]

boolean

Exclude internal conversations from results

filter[hide_non_analyzed]

boolean

Exclude conversations that have not been analyzed

filter[analyzed]

boolean

Filter conversations by analysis status (deprecated, use filter[hide_non_analyzed] instead)

filter[hide_pending]

boolean

Exclude conversations that are pending processing

filter[hide_transcript]

boolean

Omit the transcript field from each conversation in the response. Conversations are not filtered; totals and pagination are unchanged.

filter[include_private]

boolean

default:false

Requires organization enablement: Attention must enable this filter for your organization. Contact your Attention account manager before relying on it for synchronization. When not enabled, this parameter is ignored and private conversations remain excluded. When enabled, true also returns private conversations and requires an organization-level API key or an admin user. A private conversation carries only id, type, links and the attributes uuid, createdAt, finishedAt, updatedAt, userUUID, private and isInternal (isInternal is omitted when false). finishedAt, liveStreamStartedAt and liveStreamEndedAt read 0001-01-01T00:00:00.000Z when unset; every other attribute is empty, null or omitted. Public conversation rows retain their normal response shape. Combine with fromUpdatedAtDateTime to detect conversations that became private after a previous sync. When enabled and true, cannot be combined with filter[title], filter[label.name], filter[label.values], filter[participants.email], filter[external_opportunity.id], filter[crm_field.*], filter[hide_non_analyzed] or filter[analyzed].

filter[hide_failed]

boolean

Exclude conversations that failed processing

filter[include_internal_participants]

boolean

Include internal participants in the response

filter[include_zoom_metadata]

boolean

Include Zoom-specific metadata in the response

filter[include_import_metadata]

boolean

Include import metadata in the response

detailedTranscript

boolean

default:false

Include detailed transcript information in the response

withCrmRecords

boolean

default:false

Include CRM records in the response. Also re-enables extractedIntelligence and confirmedExtractedIntelligence fields that are otherwise stripped on this endpoint.

withIntelligenceItems

boolean

default:false

Include intelligence items in the response

Response

Successfully retrieved conversations

data

object[]

Show child attributes

links

object

Show child attributes

Example:

{
  "self": "https://api.attention.tech/v2/conversations/123",
  "related": "https://api.attention.tech/v2/conversations/123/participants"
}

Authentication

General Insights

Conversation

Team

API Key

User

Email

Tool

Scorecard

Organization

Calendar

Chat

Scim

Library

Super Agent

CRM

Integration

Knowledge Base

Label

Field Configuration

RecorderMetrics

Proactive

List Conversations (Optimized)

Authorizations

Query Parameters

Response