GET
/
conversations
List Conversations
curl --request GET \
  --url http://api.attention.tech/v2/conversations \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "type": "conversations",
      "id": "<string>",
      "attributes": {
        "uuid": "<string>",
        "transcript": {},
        "boards": [
          {
            "uuid": "<string>",
            "board": {
              "uuid": "<string>",
              "name": "<string>",
              "columns": [
                {
                  "id": "<string>",
                  "title": "<string>",
                  "children": [
                    {
                      "uuid": "<any>",
                      "keywords": "<any>",
                      "response": "<any>",
                      "text": "<any>"
                    }
                  ]
                }
              ],
              "team": {
                "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
                "name": "Engineering",
                "phrases": [
                  "engineering",
                  "tech",
                  "development"
                ],
                "slackConnection": {
                  "id": "T1234567890",
                  "info": {
                    "id": "<any>",
                    "name": "<any>"
                  }
                },
                "domain": "attention.tech",
                "organizerJoinInternalMeetings": true,
                "consentEmailEnabled": true,
                "parentTeamUUID": "2ccf9bde-68e3-4de4-bc4e-51b927336665",
                "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
                "children": [
                  {}
                ]
              },
              "teamUUID": "<string>"
            },
            "battlecards": [
              {
                "uuid": "<string>",
                "activatedBattlecardID": "<string>",
                "hidden": true,
                "feedbackAction": "<string>"
              }
            ]
          }
        ],
        "finishedAt": "2023-11-07T05:31:56Z",
        "title": "<string>",
        "liveStreamStartedAt": "2023-11-07T05:31:56Z",
        "liveStreamEndedAt": "2023-11-07T05:31:56Z",
        "talktracks": [
          {
            "uuid": "<string>",
            "items": [
              {
                "uuid": "talk_123",
                "activatedItemId": "item_456",
                "done": true
              }
            ]
          }
        ],
        "createdAt": "2023-11-07T05:31:56Z",
        "userUUID": "<string>",
        "user": {
          "uuid": "123e4567-e89b-12d3-a456-426614174000",
          "email": "user@example.com",
          "firstName": "John",
          "lastName": "Doe",
          "transcriptLang": "en-US",
          "joinOutsideHostMeetings": true,
          "realTimeCapabilities": false,
          "settings": {
            "realTimeCapabilitiesOFF": true,
            "autoCalculateCRMFields": true,
            "joinWhenIAmHostAndAlone": true,
            "joinWhenIAmHostWithPeers": true,
            "joinWhenPeerIsHost": true,
            "joinWhenUnlicensedPeerIsHost": true,
            "dealsEnabled": true
          },
          "botName": "MyBot",
          "botImageURL": "https://example.com/bot.png",
          "primaryTeamUUID": "primary-team-uuid-12345",
          "organizationRoleUUID": "org-role-uuid-56789",
          "roles": [
            {
              "uuid": "84e67f54-5157-442b-a2b3-8b9c728b2fef",
              "name": "Admin",
              "type": "ADMIN"
            }
          ],
          "showReferralScreen": false,
          "seatType": "admin",
          "teams": [
            {
              "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
              "name": "Engineering",
              "phrases": [
                "engineering",
                "tech",
                "development"
              ],
              "slackConnection": {
                "id": "T1234567890",
                "info": {
                  "id": "<any>",
                  "name": "<any>"
                }
              },
              "domain": "attention.tech",
              "organizerJoinInternalMeetings": true,
              "consentEmailEnabled": true,
              "parentTeamUUID": "2ccf9bde-68e3-4de4-bc4e-51b927336665",
              "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
              "children": [
                {}
              ]
            }
          ]
        },
        "team": {
          "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
          "name": "Engineering",
          "phrases": [
            "engineering",
            "tech",
            "development"
          ],
          "slackConnection": {
            "id": "T1234567890",
            "info": {
              "id": "<any>",
              "name": "<any>"
            }
          },
          "domain": "attention.tech",
          "organizerJoinInternalMeetings": true,
          "consentEmailEnabled": true,
          "parentTeamUUID": "2ccf9bde-68e3-4de4-bc4e-51b927336665",
          "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
          "children": [
            {}
          ]
        },
        "teamUUID": "<string>",
        "extractedIntelligence": {},
        "confirmedExtractedIntelligence": {},
        "externalIntelligenceOpportunityID": "<string>",
        "crmExportStatus": "PENDING",
        "archived": true,
        "externalOpportunity": {
          "uuid": "<string>",
          "title": "<string>"
        },
        "videoUID": "<string>",
        "videoStatus": "PENDING",
        "bots": [
          {
            "uuid": "<string>",
            "status": {
              "code": "BOT_READY",
              "message": "Bot is ready to process requests",
              "createdAt": "2024-03-20T10:00:00Z"
            }
          }
        ],
        "transcriptStatus": "<string>",
        "participants": [
          {
            "id": "<string>",
            "email": "<string>",
            "organizer": true,
            "name": "<string>",
            "status": "<string>"
          }
        ],
        "referenceable": true,
        "private": true,
        "mediaStorageStatus": "PENDING",
        "importStatus": "NONE",
        "scorecardResults": [
          {
            "uuid": "<string>",
            "title": "<string>",
            "summary": {
              "min": 123,
              "max": 123,
              "averageScore": 123,
              "summaryText": "<string>"
            },
            "items": [
              {
                "uuid": "<string>",
                "title": "<string>",
                "status": "CALCULATED",
                "type": "NUMERIC",
                "position": 123,
                "numericResult": {
                  "min": 123,
                  "max": 123,
                  "score": 123
                },
                "description": "<string>",
                "evidences": [
                  "<string>"
                ]
              }
            ]
          }
        ],
        "labels": {},
        "labelTagsToFilterIfNA": [
          "<string>"
        ],
        "deprecatedLabelCategories": [
          "<string>"
        ],
        "isInternal": true,
        "mediaDuration": 123,
        "dealUUID": "<string>",
        "emailTemplateID": "<string>",
        "linkedCrmRecords": [
          {
            "id": "<string>",
            "code": "<string>"
          }
        ],
        "isEmpty": true,
        "zoomMetadata": {
          "calleeName": "<string>",
          "calleeNumber": "<string>",
          "callerName": "<string>",
          "callerNumber": "<string>"
        }
      },
      "links": {
        "self": "https://api.attention.tech/v2/conversations/123",
        "related": "https://api.attention.tech/v2/conversations/123/participants"
      }
    }
  ],
  "links": {
    "self": "https://api.attention.tech/v2/conversations/123",
    "related": "https://api.attention.tech/v2/conversations/123/participants"
  },
  "meta": {
    "pageCount": 5,
    "totalRecords": 100,
    "pageNumber": 1,
    "pageSize": 20
  }
}

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

​
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[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 haven't 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

​
detailedTranscript
boolean
default:false

Include detailed transcript information in the response

Response

Successfully retrieved conversations

​
data
object[]
​
links
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
}