Skip to content
Console(opens in a new tab)

VerificationTier

A verification tier groups the verification evidence that Enigma has for a legal entity, together with the signals that set the tier.

Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.

A verification tier groups the verification evidence that Enigma has for a legal entity, together with the signals that set the tier. Each tier shows how independent the evidence is, and how hard it is to manipulate. A higher tier needs evidence that comes from an independent third party and that is harder to fabricate.

Your application sets its own policy for each tier. For example, it decides which tier is enough for onboarding, and which tier starts a manual review. The response gives the signals of each tier together with the overall tier. Your application can use the tier directly, or it can apply its own logic to the signals.

verificationTier is the highest tier for which the legal entity has at least one positive signal.

Tier Meaning
tier_3 At least one signal is present that is hard to manipulate and that comes from an independent third party. Examples are a verified open operating location and a record from a government agency. Other examples are card transactions with positive revenue over twelve months, and a long, dense history of customer reviews across active locations.
tier_2 Signals are present that an actor can fabricate, but only with meaningful effort. Examples are customer reviews across active operating locations, and a working website for one of the brands of the legal entity.
tier_1 Only signals are present that an actor can produce quickly and with little effort. Examples are a corporate registration and an Employer Identification Number (EIN).
none Reserved. The API does not return this value today. Only legal entities with an active registration are in scope, so each result reaches at least tier_1.

Shortest path from a primary entity: Brand → legalEntities → LegalEntity → verificationTiers → VerificationTier.

Field Label Type Description
firstObservedDate First Observed Date String The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only.
lastObservedDate Last Observed Date String The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate.
verificationTier Verification Tier String Strongest tier of evidence for the legal entity.
rank Rank Int Determines the display order of the attribute, with lower values shown first
tier1Signals Tier 1 Signals JSON Tier 1 evidence: corporate registration and EIN.
tier2Signals Tier 2 Signals JSON Tier 2 evidence: reviews at active locations and working websites.
tier3Signals Tier 3 Signals JSON Tier 3 evidence: Open locations, sustained card transactions with positive revenue, substantial review history at active locations, and government records.
internalId String A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number.
internalLegalEntityId String The internalId of the legal entity that this attribute describes.
id ID UUID! The unique identifier of this object.

Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.

query {
search(searchInput: {
entityType: BRAND
name: "Safeway"
conditions: { limit: 1 }
}) {
... on Brand {
id
legalEntities(first: 1) {
edges { node {
verificationTiers(first: 1) {
edges { node {
id
firstObservedDate
lastObservedDate
verificationTier
rank
} }
}
} }
}
}
}
}

Response, as returned:

{
"data": {
"search": [
{
"id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a",
"legalEntities": {
"edges": [
{
"node": {
"verificationTiers": {
"edges": [
{
"node": {
"id": "427504df-a47a-bf1f-0000-10c000000000",
"firstObservedDate": "1989-01-04 00:00:00+00",
"lastObservedDate": "2026-09-20 00:00:00+00",
"verificationTier": "tier_3",
"rank": 0
}
}
]
}
}
}
]
}
}
]
}
}