DotAlign Cloud API data points
Updated
by
Jaspreet Bakshi
Introduction
DotAlign privately analyzes email, calendar, and contact card data, to provide productivity and relationship intelligence. It also allows colleagues inside a firm to share the list of People and Company relationships with each other, and allows that information to be exported for integration into other enterprise applications. This document describes the data available via the API.
To get information about which endpoints are available, you can open the Swagger console for your deployment and see a list of all endpoints and the inputs they require, and can even try them out.
Data points
Company
For each company extracted by DotAlign, the following types of data are available.
Name | Description |
Identities | A list of strings that are considered identifiers for the company |
Firm Score | An aggregated relationship score, representing how well DotAlign users inside the firm know this company |
Aliases | A list of names that the company is known by |
Domains | A list of domain urls that are associated with the company |
Interaction Details | Information about the earliest interaction of each type (e.g. event, inbound email, outbound email) and most recent interaction of each type, as well as statistics including the total number of touchpoints by type |
Relationships | A list of relationships between DotAlign users inside the firm and contacts affiliated with the target company. Depending on the context, relationships may be focused on the overall relationship with each contact, each user's overall relationship with the company, or granular relationship pairs between specific contacts and users. |
Sample json
{
"WeKnowCompanyScore": 92,
"CompanyNameText": "Acme Laboratories LLC",
"BestUrlText": "acmelaboratories.com",
"Stats": {
"FirstInboundMsg": "2012-05-22T21:12:53Z",
"FirstMeeting": "2016-07-18T14:00:00Z",
"FirstOutboundMsg": "2012-05-22T18:23:40Z",
"LastInboundMsg": "2020-08-12T14:06:48Z",
"LastMeeting": "2020-08-12T14:00:00Z",
"LastOutboundMsg": "2020-08-12T13:06:13Z",
"NumInboundMsgs": 28811,
"NumMeetings": 23426,
"NumOutboundMsgs": 32384,
"SourceTally": 1,
"LastMeetingContactName": "Viola Rahman",
"LastOutboundMsgContactName": "Viola Rahman",
"LastInboundMsgContactName": "Viola Rahman",
"FirstMeetingContactName": "Barry Robinson",
"FirstOutboundMsgContactName": "Barry Robinson",
"FirstInboundMsgContactName": "Barry Robinson",
"LastMeetingUserName": "Grace Lai",
"LastOutboundMsgUserName": "Grace Lai",
"LastInboundMsgUserName": "Grace Lai",
"FirstMeetingUserName": "Marco Caldwell",
"FirstOutboundMsgUserName": "Marco Caldwell",
"FirstInboundMsgUserName": "Marco Caldwell"
},
"Urls": {
"data": [
{
"CoUrl": "acmelaboratories.com",
"CurrentAsOf": "2020-08-12T14:06:48Z"
}
],
"total_item_count": 1,
"page_start": 1,
"page_end": 1,
"are_more": false
},
"Aliases": {
"data": [
{
"CoNameAlias": "Acme Laboratories LLC",
"CurrentAsOf": "2019-06-13T12:09:55Z"
}
],
"total_item_count": 1,
"page_start": 1,
"page_end": 1,
"are_more": false
},
"Connections": {
"data:" [
{
"UserKnowsEmployeeScore": 70,
"UserKnowsPersonScore": 100,
"LastJobEvidence": "2020-08-12T14:06:48Z",
"ContactName": "Viola Rahman",
"ContactBestJobCorpLevelCompanyName": "Acme Laboratories LLC",
"ContactBestJobMatchedCompanyName": "Acme Laboratories LLC",
"ContactBestJobTitleText": "CEO",
"ContactBestJobCurrentAsOf": "2020-08-12T14:06:48Z",
"WeKnowPersonScore": 100,
"IntroducerName": "Marco Caldwell",
"IntroducerBestJobCorpLevelCompanyName": "Our Company",
"IntroducerBestJobMatchedCompanyName": "Our Company",
"IntroducerBestJobTitleText": "CEO",
"JobTitleText": "CEO",
"JobCoNameText": "Acme Laboratories LLC"
},
{
"UserKnowsEmployeeScore": 11,
"UserKnowsPersonScore": 49,
"IsFormerJob": true,
"LastJobEvidence": "2019-03-22T13:57:39Z",
"ContactName": "Barry Robinson",
"ContactBestJobCorpLevelCompanyName": "B.T. Robinson Ventures",
"ContactBestJobCurrentAsOf": "2020-08-07T12:00:00Z",
"WeKnowPersonScore": 49,
"IntroducerName": "Marco Caldwell",
"IntroducerBestJobCorpLevelCompanyName": "Our Company",
"IntroducerBestJobMatchedCompanyName": "Our Company",
"IntroducerBestJobTitleText": "CEO",
"JobTitleText": "Chief Operating Officer",
"JobCoNameText": "Acme Laboratories LLC"
}
],
"page_start": 1,
"page_end": 2,
"total_item_count": 2,
"are_more": false
}
}Person
For each person extracted by DotAlign, the following types of data are available.
Name | Description |
Identities | A list of strings that are considered identifiers for the person |
Firm Score | An aggregated relationship score, representing how well DotAlign users inside the firm know this person |
Names | A list of names that the person is known by |
Emails | A list of email addresses associated with the person |
Phones | A list of phone numbers associated with the person |
Jobs | A list of the companies a person has been associated with, as well as data such as their most recent title there and information indicating how current or former/stale the affiliation is |
Interaction Details | Information about the earliest interaction of each type (e.g. event, inbound email, outbound email) and most recent interaction of each type, as well as statistics including the total number of touchpoints by type |
Introducers | A list of relationships between DotAlign users inside the firm and the specified contact. |
Sample json
{
"WeKnowPersonScore": 49,
"PersonNameText": "Barry Robinson",
"BestJobCorpLevelCompanyName": "B.T. Robinson Ventures",
"BestEmailAddrText": "barry@btrobinson.vc",
"BestEmailCurrentAsOf": "2020-08-07T12:00:00Z",
"BestPhoneText": "+12125551234",
"BestPhoneType": "Work",
"BestPhoneCurrentAsOf": "2020-08-07T12:00:00Z",
"Stats": {
"FirstInboundMsg": "2012-05-22T21:12:53Z",
"FirstMeeting": "2016-07-18T14:00:00Z",
"FirstOutboundMsg": "2012-05-22T18:23:40Z",
"LastInboundMsg": "2020-08-07T12:00:00Z",
"LastInteraction": "2020-08-10T21:45:04Z",
"LastMeeting": "2020-07-17T13:00:00Z",
"LastOutboundMsg": "2020-08-10T21:47:23Z",
"NumInboundMsgs": 37,
"NumMeetings": 12,
"NumOutboundMsgs": 48,
"SourceTally": 1,
"LastMeetingUserName": "Marco Caldwell",
"LastOutboundMsgUserName": "Marco Caldwell",
"LastInboundMsgUserName": "Marco Caldwell",
"FirstMeetingUserName": "Marco Caldwell",
"FirstOutboundMsgUserName": "Marco Caldwell",
"FirstInboundMsgUserName": "Marco Caldwell"
},
"Phones": {
"data": [
{
"CurrentAsOf": "2020-08-07T12:00:00Z",
"StandardizedPhoneNumber": "+12125551234",
"PhoneType": "Work"
},
{
"CurrentAsOf": "2020-01-27T13:02:24Z",
"StandardizedPhoneNumber": "+16465559876",
"PhoneType": "Mobile"
}
],
"total_item_count": 2,
"page_start": 1,
"page_end": 2,
"are_more": false
},
"Emails": {
"data": [
{
"AddressText": "barry@btrobinson.vc",
"CurrentAsOf": "2020-08-07T12:00:00Z",
},
{
"AddressText": "brobinson@acmelaboratories.com",
"CurrentAsOf": "2019-03-22T13:57:39Z",
}
],
"total_item_count": 2,
"page_start": 1,
"page_end": 2,
"are_more": false
},
"Names": {
"data": [
{
"StandardizedName": "Barry Robinson",
"CurrentAsOf": "2020-08-07T12:00:00Z"
}
],
"total_item_count": 1,
"page_start": 1,
"page_end": 1,
"are_more": false
},
"Introducers": {
"data": [
{
"ScorePoints": 49,
"IntroducerName": "Marco Caldwell",
"IntroducerBestJobCorpLevelCompanyName": "Our Company",
"IntroducerBestJobMatchedCompanyName": "Our Company",
"IntroducerBestJobTitleText": "CEO"
}
],
"total_item_count": 1,
"page_start": 1,
"page_end": 1,
"are_more": false
},
"Jobs": {
"data": [
{
"JobCorpLevelName": "B.T. Robinson Ventures",
"JobCurrentAsOf": "2020-08-07T12:00:00Z"
},
{
"JobCoName": "Acme Laboratories LLC",
"JobCorpLevelName": "Acme Laboratories LLC",
"JobCurrentAsOf": "2019-03-22T13:57:39Z",
"JobTitleText": "Chief Operating Officer",
"JobIsFormer": true
},
],
"total_item_count": 1,
"page_start": 2,
"page_end": 2,
"are_more": false
}
}