Jump to

• Request
• Response
• Examples

Get facts generated by the contact validation insight template

get

/crmRestApi/crmSalesIntelligenceApi/11.13.18.05/facts/contactValidation

This method is used to get the record level facts generated using the contact validation insight template for the a lead or opportunity.

Request

Query Parameters

• q: string
  To identify: A CRM object record by ObjectType and ObjectId values. Example: ObjectType=opportunity;ObjectId=999999999

There's no request body for this operation.

Security

• BasicAuthentication: http
  Type: http

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Headers

• Server-Time-In-Millis:
  The server time comnsumed by the API to complete execution.

Body ()

Root Schema : ActivityEffectivenessFacts

Type: object

Title: ActivityEffectivenessFacts

The activityEffectiveness API response.

Show Source

• count: integer
  The count of items in current response.
• hasMore: boolean
  A boolean flag which indicates the availability of more matching records at server.
• items: array items
  The activity effectiveness facts array.
• limit: integer
  The limit applied to the query.
• links: array links
  The links.
• offset: integer
  The offset applied to the query.

{
    "title":"ActivityEffectivenessFacts",
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "description":"The activity effectiveness facts array.",
            "items":{
                "$ref":"#/components/schemas/ContactValidationFactItems"
            }
        },
        "offset":{
            "type":"integer",
            "description":"The offset applied to the query."
        },
        "limit":{
            "type":"integer",
            "description":"The limit applied to the query."
        },
        "hasMore":{
            "type":"boolean",
            "description":"A boolean flag which indicates the availability of more matching records at server."
        },
        "count":{
            "type":"integer",
            "description":"The count of items in current response."
        },
        "links":{
            "type":"array",
            "description":"The links.",
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"The activityEffectiveness API response."
}

Nested Schema : items

Type: array

The activity effectiveness facts array.

Show Source

• Array of: object ActivityEffectivenessFactItems
  Title: ActivityEffectivenessFactItems

  The facts about the activity effectiveness of a record generated using the object and record level metrics.

{
    "type":"array",
    "description":"The activity effectiveness facts array.",
    "items":{
        "$ref":"#/components/schemas/ContactValidationFactItems"
    }
}

Nested Schema : links

Type: array

The links.

Show Source

• Array of: object Link
  Title: Link

  The link item.

{
    "type":"array",
    "description":"The links.",
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : ActivityEffectivenessFactItems

Type: object

Title: ActivityEffectivenessFactItems

The facts about the activity effectiveness of a record generated using the object and record level metrics.

Show Source

• CreatedBy: string
  Indicates the user who created the row.
• CreationDate: string (date-time)
  Indicates the date and time of the creation of the row.
• ExplanationText: string
  The explanation for the record classification .
• InsightFactId: integer
  The auto-generated unique identifier for an insight fact.
• InsightTemplateUuid: string (uuid)
  The auto-generated unique Identifier for an insight template
• InsightTypeCode: string
  A unique code assigned to an insight template.
• LastUpdateDate: string (date-time)
  Indicates the date and time of the last update of the row.
• LastUpdatedBy: string
  Indicates the user who last updated the row.
• LastUpdateLogin: string
  Indicates the session login associated to the user who last updated the row.
• ObjectId: integer
  The PK attribute value of the CRM record
• ObjectType: string
  The object type name of the CRM entity.
• RecordClassification: string
  The classification text of the record based on the facts generated.
• RecordClassificationCode: string
  The classification code of the record based on the facts generated.
• RecordFacts: array RecordFacts
  The record level facts generated by comparing record query result against object metrics.

{
    "title":"ActivityEffectivenessFactItems",
    "type":"object",
    "properties":{
        "InsightFactId":{
            "type":"integer",
            "description":"The auto-generated unique identifier for an insight fact."
        },
        "InsightTypeCode":{
            "type":"string",
            "description":"A unique code assigned to an insight template."
        },
        "LastUpdatedBy":{
            "type":"string",
            "description":"Indicates the user who last updated the row."
        },
        "LastUpdateLogin":{
            "type":"string",
            "description":"Indicates the session login associated to the user who last updated the row."
        },
        "InsightTemplateUuid":{
            "type":"string",
            "description":"The auto-generated unique Identifier for an insight template",
            "format":"uuid"
        },
        "CreationDate":{
            "type":"string",
            "description":"Indicates the date and time of the creation of the row.",
            "format":"date-time"
        },
        "RecordClassificationCode":{
            "type":"string",
            "description":"The classification code of the record based on the facts generated."
        },
        "RecordClassification":{
            "type":"string",
            "description":"The classification text of the record based on the facts generated."
        },
        "LastUpdateDate":{
            "type":"string",
            "description":"Indicates the date and time of the last update of the row.",
            "format":"date-time"
        },
        "ExplanationText":{
            "type":"string",
            "description":"The explanation for the record classification ."
        },
        "CreatedBy":{
            "type":"string",
            "description":"Indicates the user who created the row."
        },
        "RecordFacts":{
            "type":"array",
            "description":"The record level facts generated by comparing record query result against object metrics.",
            "items":{
                "$ref":"#/components/schemas/ContactValidationFact"
            }
        },
        "ObjectId":{
            "type":"integer",
            "description":"The PK attribute value of the CRM record"
        },
        "ObjectType":{
            "type":"string",
            "description":"The object type name of the CRM entity."
        }
    },
    "description":"The facts about the activity effectiveness of a record generated using the object and record level metrics."
}

Nested Schema : RecordFacts

Type: array

The record level facts generated by comparing record query result against object metrics.

Show Source

• Array of: object ContactValidationFact
  Title: ContactValidationFact

  The fact data about the contact validation.

{
    "type":"array",
    "description":"The record level facts generated by comparing record query result against object metrics.",
    "items":{
        "$ref":"#/components/schemas/ContactValidationFact"
    }
}

Nested Schema : ContactValidationFact

Type: object

Title: ContactValidationFact

The fact data about the contact validation.

Show Source

• ContactsCount: string
  The total number of the contacts for this record.
• DecisionMakerCount: string
  The total number of decision makers for this record.
• InsightSubTypeCode: string
  The insight sub type code.
• ObjectAverage: string
  The object level average.

{
    "title":"ContactValidationFact",
    "type":"object",
    "properties":{
        "ContactsCount":{
            "type":"string",
            "description":"The total number of the contacts for this record."
        },
        "InsightSubTypeCode":{
            "type":"string",
            "description":"The insight sub type code."
        },
        "ObjectAverage":{
            "type":"string",
            "description":"The object level average."
        },
        "DecisionMakerCount":{
            "type":"string",
            "description":"The total number of decision makers for this record."
        }
    },
    "description":"The fact data about the contact validation."
}

Nested Schema : Link

Type: object

Title: Link

The link item.

Show Source

• href: string
  The link href.
• kind: string
  The link kind.
• name: string
  The link name.
• rel: string
  The link relation.

{
    "title":"Link",
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"The link name."
        },
        "kind":{
            "type":"string",
            "description":"The link kind."
        },
        "href":{
            "type":"string",
            "description":"The link href."
        },
        "rel":{
            "type":"string",
            "description":"The link relation."
        }
    },
    "description":"The link item."
}

400 Response

Bad Request

401 Response

Unauthorized

404 Response

Not Found

405 Response

Method Not Allowed

500 Response

Internal Server Error

Back to Top

Examples

The following example shows how to get facts generated using the contact validation insight template by submitting a get request on the REST resource using cURL.

cURL Command

curl -u <username:password> \ -X GET https://servername.fa.us2.oraclecloud.com/crmRestApi/crmSalesIntelligenceApi/latest/facts/contactValidation?q=ObjectType=lead;ObjectId=100100001758625

Example of Response Body where ObjectType is lead

The following shows an example of the response body in JSON format.

{
    "items": [
        {
            "InsightFactId": 100100300988152,
            "InsightTypeCode": "CONTACT_VALIDATION",
            "LastUpdatedBy": "SALES_ADMIN",
            "LastUpdateLogin": "CAE17C03962CC82FE053AC0AF50ACE73",
            "InsightTemplateUuid": "336d82a2-a707-4564-b618-63db01263aab",
            "CreationDate": "2021-09-07T06:10:55+00:00",
            "RecordClassificationCode": "NOT_AVAILABLE",
            "ObjectType": "lead",
            "RecordClassification": "Not available",
            "LastUpdateDate": "2021-09-07T06:10:55+00:00",
            "ExplanationText": "The Contacts Validation insight is not available for this record ",
            "CreatedBy": "SALES_ADMIN",
            "RecordFacts": [],
            "ObjectId": 100100001758625
        }
    ],
    "offset": 0,
    "limit": 25,
    "hasMore": false,
    "count": 1,
    "links": [
        {
            "name": "self",
            "kind": "collection",
            "href": " https://servername.fa.us2.oraclecloud.com/crmRestApi/crmSalesIntelligenceApi/11.13.18.05/facts/contactValidation",
            "rel": "self"
        }
    ]
}

cURL Command

curl -u <username:password> \ -X https://servername.fa.us2.oraclecloud.com/crmRestApi/crmSalesIntelligenceApi/latest/facts/contactValidation?q=ObjectType=opportunity;ObjectId=300100543297390

Example of Response Body where ObjectType is opportunity

The following shows an example of the response body in JSON format.

{
    "items": [
        {
            "InsightFactId": 100100300988153,
            "InsightTypeCode": "CONTACT_VALIDATION",
            "LastUpdatedBy": "SALES_ADMIN",
            "LastUpdateLogin": "CAE17C03962EC82FE053AC0AF50ACE73",
            "InsightTemplateUuid": "925e39d3-e19f-4acd-be76-4dd1212cf369",
            "CreationDate": "2021-09-07T06:11:25+00:00",
            "RecordClassificationCode": "NOT_AVAILABLE",
            "ObjectType": "opportunity",
            "RecordClassification": "Not available",
            "LastUpdateDate": "2021-09-07T06:11:25+00:00",
            "ExplanationText": "The Contacts Validation insight is not available for this record ",
            "CreatedBy": "SALES_ADMIN",
            "RecordFacts": [],
            "ObjectId": 300100543297390
        }
    ],
    "offset": 0,
    "limit": 25,
    "hasMore": false,
    "count": 1,
    "links": [
        {
            "name": "self",
            "kind": "collection",
            "href": " https://servername.fa.us2.oraclecloud.com/crmRestApi/crmSalesIntelligenceApi/11.13.18.05/facts/contactValidation",
            "rel": "self"
        }
    ]
}

Back to Top