Skip to contentSkip to navigationSkip to topbar

Retrieve an OperatorResult


(information)

Legal information

Conversation Intelligence, including the APIs, may use artificial intelligence or machine learning technologies and is subject to the terms of the Predictive and Generative AI/ML Features Addendum(link takes you to an external page). For more details on AI usage and data, see AI Nutrition Facts for Conversation Intelligence.

Conversation Intelligence is not PCI compliant or a HIPAA Eligible Service and should not be used in workflows that are subject to HIPAA or PCI.

Conversations products are only available in the new Twilio Console(link takes you to an external page). If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.

GET/v3/OperatorResults/{operatorResultId}

Base url: https://intelligence.twilio.com (Twilio Intelligence API)

Request

fetch-operator-result-request page anchor

Authentication

authentication page anchor
Property nameTypeRequiredPIIDescription
operatorResultIdstring
required
Not PII

Operator Result id (TTID)

Example: intelligence_operatorresult_01k6fc25s7epm9qtk8rszbv3q5Pattern: ^intelligence_operatorresult_[0-7][0-9a-z]{25}$

200404429500

Operator Result object.

SchemaExample
View the Swagger documentation for oneOf
Property nameTypeRequiredPIIDescriptionChild properties
outputFormatstring

Optional

The output format set on the Operator that generated this result. Determines the structure of the result object.

Pattern: ^(CLASSIFICATION|TEXT|EXTRACTION|JSON)$

idstring

Optional

A unique identifier for the Operator Result. Assigned by Twilio (TTID).

Example: intelligence_operatorresult_01k6fc25s7epm9qtk8rszbv3q5Pattern: ^intelligence_operatorresult_[0-7][0-9a-z]{25}$

accountIdstring

Optional

The ID of the Account that created the Language Operator.

Pattern: ^AC[a-zA-Z0-9]{32}$

intelligenceConfigurationobject

Optional

Reference to the Intelligence Configuration that generated the Operator Result.


conversationIdstring

Optional

The id of the Conversation attached to the Operator Result.

Example: conv_conversation_01k1etk2y5f1y9fpe2epfdtvv2Pattern: ^conv_conversation_[0-7][0-9a-z]{25}$

operatorobject

Optional

Reference to the Language Operator that generated the Operator Result.


dateCreatedstring<date-time>

Optional

Timestamp for when the Operator Result was created.


referenceIdsarray[string]

Optional

The ids of objects related to this Operator Result.


executionDetailsobject

Optional

Details about the conditions under which the Operator executed.


metadataobject

Optional


resultobject

Optional

The actual result from executing the Language Operator with TEXT output format.

Retrieve an OperatorResultLink to code sample: Retrieve an OperatorResult
1
// Download the helper library from https://www.twilio.com/docs/node/install
2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4
// Find your Account SID and Auth Token at twilio.com/console
5
// and set the environment variables. See http://twil.io/secure
6
const accountSid = process.env.TWILIO_ACCOUNT_SID;
7
const authToken = process.env.TWILIO_AUTH_TOKEN;
8
const client = twilio(accountSid, authToken);
9
10
async function fetchOperatorResult() {
11
const operatorResult = await client.intelligence.v3
12
.operatorResults("intelligence_operatorresult_01k6fc25s7epm9qtk8rszbv3q5")
13
.fetch();
14
15
console.log(operatorResult.outputFormat);
16
}
17
18
fetchOperatorResult();

Response

Note about this response
1
{
2
"id": "intelligence_operatorresult_01k6fc25s7epm9qtk8rszbv3q5",
3
"accountId": "AC00000000000000000000000000000000",
4
"outputFormat": "JSON",
5
"intelligenceConfiguration": {
6
"id": "intelligence_configuration_01kermhm82e5mr98nbeh1hpmbn",
7
"ruleId": "intelligence_configurationrule_01kermhm81fwfvy7j0f7h7v5mr",
8
"version": 1
9
},
10
"conversationId": "conv_conversation_01k1etk2y5f1y9fpe2epfdtvv2",
11
"operator": {
12
"id": "intelligence_operator_01kcgy1ew0e9x8re6jq542zt8b",
13
"version": 1,
14
"parameters": {
15
"scale": 5
16
}
17
},
18
"dateCreated": "2026-01-15T10:45:30Z",
19
"referenceIds": [
20
"conv_communication_01k1etk2y5f1y9fpe2epfdtvv2",
21
"conv_participant_01k1etx3jbfx88476ccja0889c"
22
],
23
"executionDetails": {
24
"trigger": {
25
"on": "CONVERSATION_END",
26
"timestamp": "2026-01-15T10:45:25Z"
27
},
28
"communications": {
29
"first": "conv_communication_01k1etk2y5f1y9fpe2epfdtvv2",
30
"last": "conv_communication_01k1etk2y5f1y9fpe2epfdtvv9"
31
},
32
"channels": [
33
"VOICE"
34
],
35
"participants": [
36
{
37
"id": "conv_participant_01k1etx3jbfx88476ccja0889c",
38
"profileId": "mem_profile_01k6fbz0v4f4e9qtk8p8z7y3w1",
39
"type": "CUSTOMER"
40
},
41
{
42
"id": "conv_participant_01k1etx3jbfx88476ccja0889d",
43
"type": "HUMAN_AGENT"
44
}
45
],
46
"resolvedContext": {
47
"memory": {
48
"profileId": "mem_profile_00000000000000000000000000",
49
"memoryStoreId": "mem_store_00000000000000000000000000"
50
},
51
"knowledge": {
52
"sources": [
53
{
54
"baseId": "know_knowledgebase_00000000000000000000000000",
55
"sourceId": "know_knowledge_00000000000000000000000000"
56
}
57
]
58
}
59
}
60
},
61
"result": {
62
"score": 5,
63
"explanation": "The agent followed the script closely and addressed all key points effectively."
64
}
65
}