Obsolete Identifiers

Panelists might eventually become obsolete due to various reasons (opting out of sharing their data, for example) and will be removed from the Query endpoints.
When this happens, they are effectively unusable for targeting etc. and might need cleaning out from any data stores that depend on this API to be current.

All obsolete panelists are exposed on one of two endpoints:

• External IDs can be retrieved per identity provider and date of obsoletion.
• Panelist IDs can be retrieved by date of obsoletion (note: Panelist IDs will only be returned if changed after 2022-01-11, as this is the date the API started storing the data).

Obsolete External IDs

To get a list of all external IDs that were made obsolete after a specific date, make the following request specifying the identity provider and date of obsoletion as a JSON object in the request payload. To limit the number of records returned in a single response, use the limit parameter to specify the maximum number of records to return:

HTTP

{
    "identityProvider": "MyIdentityProvider",
    "updatedSince":"2020-01-04",
    "limit": 100
}

The response will contain a list of all Panelists that have been made obsolete since the specified date, similar to the example below:

JSON

{
    "data": [
        {
            "identity": "123-ai345",
            "panelistId": 99903
        }
    ],
    "continuationToken": "f029c911bc05b48c52f9627997658563c3c67c7c",
    "nextUrl": "/ObsoleteIdentities?ContinuationToken=f029c911bc05b48c52f9627997658563c3c67c7c",
}

If there are more records to be retrieved, the next page of results can be returned by making the same request to the URL specified in the nextUrl property.

Obsolete Panelist IDs

To get a list of all Panelists that were made obsolete after a specific date, make the following request specifying the date of obsoletion as a JSON object in the request payload. To limit the number of records returned in a single response, use the limit parameter to specify the maximum number of records to return:

HTTP

{
    "updatedSince":"2020-01-04",
    "limit": 100
}

The response will be similar to the External ID response.