Skip to main content
GET
/
conversations
/
list
List Conversations (Optimized)
curl --request GET \
  --url https://api.attention.tech/v2/conversations/list \
  --header 'Authorization: <api-key>'
{
  "data": [],
  "links": {
    "self": "/v2/conversations?page=1",
    "related": "/v2/conversations?page=2"
  },
  "meta": {
    "totalRecords": 150
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.attention.com/llms.txt

Use this file to discover all available pages before exploring further.

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)

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

Exclude conversations without transcripts

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[]
Example:
{
"self": "https://api.attention.tech/v2/conversations/123",
"related": "https://api.attention.tech/v2/conversations/123/participants"
}
meta
object
Example:
{
"pageCount": 5,
"totalRecords": 100,
"pageNumber": 1,
"pageSize": 20
}