The identities endpoint is used to retrieve the underlying identity (PII) of an Entity. The Identity endpoint requires an Entity to have at least a name and phone number.

For an active entity or entities with a matched identity (verification.identity.matched) the identity endpoint will return a single identity with the PII.

For all other entities the identity endpoint could return multiple identities as the provided PII was not enough to disambiguate and match a single identity.

The Identity endpoint is restricted to most teams. Contact your Method CSM for more information.

The Identity endpoint is available as a:

TypeUse-Case
ProductRetrieve the full Identity (PII) for any Entity

Identity Objects

id
string

Unique identifier for the Identity.

entity_id
string

The ID of the associated Entity.

status
enum

Status of the Identity.

identities
object[] | null

An array of identity objects.

error
object | null

An object representing an error that occurred while processing this Identity. See Identity errors.

created_at
string

Timestamp of when the Identity was created.

updated_at
string

Timestamp of when the Identity was last updated.