Identity resolution metrics
Identity resolution metrics describe the profiles and identities produced by successful identity resolutions in the current workspace.
Metrics are recorded only when a resolution succeeds. Running or failed resolutions do not replace the latest successful result. The recorded counts may differ from the current identity counts after later imports or other changes.
Identity counts are deduplicated across pipelines for the same source connection and identity ID. Retrieving stored metrics does not query the data warehouse or start an identity resolution.
Get daily identity resolution metrics
Returns daily successful identity resolution metrics from start up to, but not including, end, ordered by UTC date.
Each day uses the latest successful result recorded for that day. If no new result is available, the most recent earlier result is carried forward, including a result recorded before start. Days before the first known result are omitted.
The requested interval must not exceed 60,000 days.
Request
-
:start
date RequiredThe first UTC date to include, in
YYYY-MM-DDformat. It must be earlier thanendand no earlier than1970-01-01. -
:end
date RequiredThe first UTC date not to include, in
YYYY-MM-DDformat. It must be later thanstart, no later than2262-04-11, and no later than the day after the current UTC date.
Response
Zero counts represent a successful resolution with zero results and are carried forward like other results. If no successful result is known before end, the response is an empty array.
In the example, the first successful result is recorded on October 18, so the preceding days are omitted.
The response is an array of objects with the following properties:
-
day
dateThe UTC day represented by this entry, in
YYYY-MM-DDformat. -
identities
64 bit intThe total number of identities in the successful resolution result used for this day.
-
profiles
64 bit intThe total number of profiles. It is the sum of
profilesAnonymousandprofilesRecognized. -
profilesAnonymous
64 bit intThe number of profiles containing only anonymous identities.
-
profilesRecognized
64 bit intThe number of profiles containing at least one recognized identity.
-
identitiesPerProfile
floatThe average number of identities per profile, calculated as
identities / profiles. It is zero when the profile total is zero. -
linkedIdentitiesRate
floatThe share of identities belonging to profiles with more than one identity, expressed as a ratio from 0 to 1. It is zero when
identitiesis zero.
curl https://example.com/v1/metrics/identity-resolution/dates/2026-10-16/2026-10-19 \ -H "Authorization: Bearer api_xxxxxxx" [
{
"day": "2026-10-18",
"identities": 60,
"profiles": 20,
"profilesAnonymous": 3,
"profilesRecognized": 17,
"identitiesPerProfile": 3,
"linkedIdentitiesRate": 0.75
}
]Get latest identity resolution metrics
Returns the latest stored successful identity resolution result for the current workspace, including anonymous and recognized counts and the profile composition.
The composition groups profiles by their number of identities. Its six bucket counts sum to profiles.total.
Request
No parameters.Response
The response is null when no successful identity resolution result has been recorded. A successful resolution with zero counts returns an object with zero counts and ratios.
-
observedAt
datetimeThe UTC timestamp when the successful identity resolution completed.
-
identities
objectThe identity counts produced by the resolution.
-
identities.total
64 bit intThe total number of identities in the successful resolution. It is the sum of
anonymousandrecognized. -
identities.anonymous
64 bit intThe number of anonymous identities, including those belonging to recognized profiles.
-
identities.recognized
64 bit intThe number of recognized identities.
-
-
profiles
objectThe profile counts produced by the resolution.
-
profiles.total
64 bit intThe total number of profiles in the successful resolution. It is the sum of
anonymousandrecognized. -
profiles.anonymous
64 bit intThe number of profiles containing only anonymous identities.
-
profiles.recognized
64 bit intThe number of profiles containing at least one recognized identity.
-
-
composition
objectThe profile counts grouped by their number of identities.
-
composition.one
64 bit intThe number of profiles containing exactly one identity.
-
composition.two
64 bit intThe number of profiles containing exactly two identities.
-
composition.three
64 bit intThe number of profiles containing exactly three identities.
-
composition.fourToTen
64 bit intThe number of profiles containing from four to ten identities, inclusive.
-
composition.elevenToTwenty
64 bit intThe number of profiles containing from eleven to twenty identities, inclusive.
-
composition.moreThanTwenty
64 bit intThe number of profiles containing twenty-one or more identities.
-
-
identitiesPerProfile
floatThe average number of identities per profile, calculated as
identities.total / profiles.total. It is zero when the profile total is zero. -
linkedIdentitiesRate
floatThe share of identities belonging to profiles with more than one identity, calculated as
(identities.total - composition.one) / identities.total. It is a ratio from 0 to 1 and is zero when the identity total is zero.
curl https://example.com/v1/metrics/identity-resolution/latest \ -H "Authorization: Bearer api_xxxxxxx" {
"observedAt": "2026-10-18T09:42:51Z",
"identities": {
"total": 60,
"anonymous": 20,
"recognized": 40
},
"profiles": {
"total": 20,
"anonymous": 3,
"recognized": 17
},
"composition": {
"one": 15,
"two": 1,
"three": 1,
"fourToTen": 1,
"elevenToTwenty": 1,
"moreThanTwenty": 1
},
"identitiesPerProfile": 3,
"linkedIdentitiesRate": 0.75
}