DotAlign Cloud API data points

Updated 8 months ago 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
}
}


How Did We Do?