- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
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. |
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → legalEntities → LegalEntity → verificationTiers → VerificationTier.
LegalEntity.verificationTiers
Fields
Section titled “Fields”| 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. |
Math fields
Section titled “Math fields”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.
Example
Section titled “Example”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 } } ] } } } ] } } ] }}