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 Required

    The first UTC date to include, in YYYY-MM-DD format. It must be earlier than end and no earlier than 1970-01-01.

  • :end

    date Required

    The first UTC date not to include, in YYYY-MM-DD format. It must be later than start, no later than 2262-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

    date

    The UTC day represented by this entry, in YYYY-MM-DD format.

  • identities

    64 bit int

    The total number of identities in the successful resolution result used for this day.

  • profiles

    64 bit int

    The total number of profiles. It is the sum of profilesAnonymous and profilesRecognized.

  • profilesAnonymous

    64 bit int

    The number of profiles containing only anonymous identities.

  • profilesRecognized

    64 bit int

    The number of profiles containing at least one recognized identity.

  • identitiesPerProfile

    float

    The average number of identities per profile, calculated as identities / profiles. It is zero when the profile total is zero.

  • linkedIdentitiesRate

    float

    The share of identities belonging to profiles with more than one identity, expressed as a ratio from 0 to 1. It is zero when identities is zero.

GET /v1/metrics/identity-resolution/dates/:start/:end
curl https://example.com/v1/metrics/identity-resolution/dates/2026-10-16/2026-10-19 \
-H "Authorization: Bearer api_xxxxxxx"
Response
[
  {
    "day": "2026-10-18",
    "identities": 60,
    "profiles": 20,
    "profilesAnonymous": 3,
    "profilesRecognized": 17,
    "identitiesPerProfile": 3,
    "linkedIdentitiesRate": 0.75
  }
]
Errors
401
Authorization header is missing or invalid
400
requested metrics exceed the maximum: 60001 days is more than 60,000
404
workspace does not exist
404
start is not valid
404
end is not valid
404
start date is too far in the past
404
end date is too far in the future
404
day of the end date must be after the day of the start date
422
organization is disabled

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

    datetime

    The UTC timestamp when the successful identity resolution completed.

  • identities

    object

    The identity counts produced by the resolution.

    • identities.total

      64 bit int

      The total number of identities in the successful resolution. It is the sum of anonymous and recognized.

    • identities.anonymous

      64 bit int

      The number of anonymous identities, including those belonging to recognized profiles.

    • identities.recognized

      64 bit int

      The number of recognized identities.

  • profiles

    object

    The profile counts produced by the resolution.

    • profiles.total

      64 bit int

      The total number of profiles in the successful resolution. It is the sum of anonymous and recognized.

    • profiles.anonymous

      64 bit int

      The number of profiles containing only anonymous identities.

    • profiles.recognized

      64 bit int

      The number of profiles containing at least one recognized identity.

  • composition

    object

    The profile counts grouped by their number of identities.

    • composition.one

      64 bit int

      The number of profiles containing exactly one identity.

    • composition.two

      64 bit int

      The number of profiles containing exactly two identities.

    • composition.three

      64 bit int

      The number of profiles containing exactly three identities.

    • composition.fourToTen

      64 bit int

      The number of profiles containing from four to ten identities, inclusive.

    • composition.elevenToTwenty

      64 bit int

      The number of profiles containing from eleven to twenty identities, inclusive.

    • composition.moreThanTwenty

      64 bit int

      The number of profiles containing twenty-one or more identities.

  • identitiesPerProfile

    float

    The average number of identities per profile, calculated as identities.total / profiles.total. It is zero when the profile total is zero.

  • linkedIdentitiesRate

    float

    The 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.

GET /v1/metrics/identity-resolution/latest
curl https://example.com/v1/metrics/identity-resolution/latest \
-H "Authorization: Bearer api_xxxxxxx"
Response
{
  "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
}
Errors
401
Authorization header is missing or invalid
404
workspace does not exist
422
organization is disabled