Integration

Verification types

Integration

Verification types

Everything you can ask users to prove. Each credential in a user's wallet supports one or more requirements, and you can combine requirements from different credentials in one session.

Proof pricing across methods#

Verifications are priced identically once issued into the user vault: 0.5¢ (€0.005) per proof reuse (less than a cent), with your first 500 successful proof reuses free. When a user does not yet hold a required credential, LKP passes through the exact wholesale cost of initial issuance (no markup, no more, no less). First-time proofs are always paid to cover wholesale provider costs; your 500 free allowance applies to reuses.

Proof Method	Supported Checks	Initial Issuance (At Cost)	Proof Reuse
Facial Age Estimation	AGE_OVER (18+, 21+) via 1 to 2s selfie	€0.10	€0.005
Government ID Document	AGE_OVER, COUNTRY_EQUALS, sybil uniqueness	€0.33	€0.005
Phone Number OTP	Ownership of phone, carrier country code	€0.06	€0.005
Email Address OTP	Ownership of email, corporate/school domain	€0.01	€0.005
Social & Developer Accounts	GitHub org, follower thresholds, X, TikTok, Instagram	€0.00	€0.005
Open Banking Account	Account holder name, balance threshold	€0.15	€0.005

For age verification, businesses can configure kycWorkflow on session creation to choose age_estimation (€0.10 first check, €0.005 reuse), full_id (€0.33 first check, €0.005 reuse), or either (user picks).

Government ID#

LiveIssued via Didit · 7 credentials · source government_id

Facts printed on a passport, ID card or residence permit, checked with liveness: age, nationality (citizenship), name, sex, document details, and the address country on the document when it has one. This is verified identity, not current physical location.

AGE_OVER

The holder is at least this many years old today.

minAge: 1 to 150 years. Users see: “18 years or older”.

{"kind":"AGE_OVER","minAge":18}

COUNTRY_EQUALS

The nationality (citizenship) printed on the document, not current physical location. Pass several countries to accept any of them (France or the UK).

countryIsoNumeric: ISO 3166-1 numeric, or an array of up to 16. Users see: “Nationality: Netherlands”.

{"kind":"COUNTRY_EQUALS","countryIsoNumeric":528}

AGE_AT_MOST

The holder is at most this many years old today. Combine with a minimum age for a range.

maxAge: 0 to 150 years. Users see: “25 years or younger”.

{"kind":"AGE_AT_MOST","maxAge":25}

SEX_EQUALS

The sex printed on the document.

sex: "F" | "M" | "X", or an array of up to 16. Users see: “Sex on document: Female”.

{"kind":"SEX_EQUALS","sex":"F"}

DOCUMENT_VALID_FOR

The identity document stays valid for at least this many more days.

minDays: 0 to 3650 days. Users see: “ID document valid for at least 90 days”.

{"kind":"DOCUMENT_VALID_FOR","minDays":90}

DOCUMENT_TYPE_EQUALS

The kind of document the holder verified with.

documentType: "passport" | "id_card" | "residence_permit" | "drivers_license", or an array of up to 16. Users see: “Verified with a passport”.

{"kind":"DOCUMENT_TYPE_EQUALS","documentType":"passport"}

ISSUING_COUNTRY_EQUALS

The country that issued the document.

countryIsoNumeric: ISO 3166-1 numeric, or an array of up to 16. Users see: “ID issued by: Netherlands”.

{"kind":"ISSUING_COUNTRY_EQUALS","countryIsoNumeric":528}

FULL_NAME_EQUALS

The holder's given names and surname as printed on the document. Case and accents are ignored.

fullName: string, up to 100 characters, or an array of up to 16. Users see: “Name on ID: JAN DE VRIES”.

{"kind":"FULL_NAME_EQUALS","fullName":"JAN DE VRIES"}

DOCUMENT_NUMBER_EQUALS

The number of the document the holder verified with.

documentNumber: string, up to 100 characters, or an array of up to 16. Users see: “ID document number NX1234567”.

{"kind":"DOCUMENT_NUMBER_EQUALS","documentNumber":"NX1234567"}

RESIDENCE_COUNTRY_EQUALS

The country of the address printed on the document, when it has one. This is not proof that the holder currently lives there.

countryIsoNumeric: ISO 3166-1 numeric, or an array of up to 16. Users see: “Address country on ID: Netherlands”.

{"kind":"RESIDENCE_COUNTRY_EQUALS","countryIsoNumeric":528}

Phone number#

LiveIssued via Didit · 2 credentials · source phone

Ownership of a phone number, checked with a one-time code. Each number backs only one wallet.

PHONE_VERIFIED

The holder owns a phone number. Each number backs only one wallet.

lineType: "any" | "not_virtual" | "mobile". Users see: “Has a verified phone number”.

{"kind":"PHONE_VERIFIED","lineType":"any"}

PHONE_COUNTRY_EQUALS

The country the phone number belongs to.

countryIsoNumeric: ISO 3166-1 numeric, or an array of up to 16. Users see: “Phone number from: Netherlands”.

{"kind":"PHONE_COUNTRY_EQUALS","countryIsoNumeric":528}

PHONE_NUMBER_EQUALS

The holder owns exactly this number, in international format.

phoneNumber: E.164 string, e.g. +31612345678, or an array of up to 16. Users see: “Owns phone number +31612345678”.

{"kind":"PHONE_NUMBER_EQUALS","phoneNumber":"+31612345678"}

Work or school email#

LiveIssued via Didit · 2 credentials · source email

Ownership of an email address at an organisation's domain, checked with a one-time code.

EMAIL_VERIFIED

The holder owns an email address of this kind. Work means an organisation's own domain, not a free mailbox.

type: "any" | "work_or_school" | "school". Users see: “Has a verified work or school email address”.

{"kind":"EMAIL_VERIFIED","type":"work_or_school"}

EMAIL_DOMAIN_EQUALS

The address belongs to this organisation. Subdomains count: student.uva.nl matches uva.nl.

domain: domain string, e.g. company.com, or an array of up to 16. Users see: “Email address at example.com”.

{"kind":"EMAIL_DOMAIN_EQUALS","domain":"example.com"}

EMAIL_ADDRESS_EQUALS

The holder owns exactly this email address.

email: email address string, or an array of up to 16. Users see: “Owns jane@example.com”.

{"kind":"EMAIL_ADDRESS_EQUALS","email":"jane@example.com"}

Instagram#

LiveIssued via TLSNotary · 2 credentials · source instagram

Ownership of an Instagram account, its username, follower and post counts and verified badge, notarized from Instagram's own servers.

FOLLOWERS_AT_LEAST

The holder's Instagram account has at least this many followers.

minFollowers: integer ≥ 0 followers. Users see: “At least 1,000 Instagram followers”.

{"kind":"FOLLOWERS_AT_LEAST","minFollowers":1000}

INSTAGRAM_USERNAME_EQUALS

The holder owns this Instagram account.

username: string, up to 64 characters, or an array of up to 16. Users see: “Instagram account @lkp”.

{"kind":"INSTAGRAM_USERNAME_EQUALS","username":"lkp"}

INSTAGRAM_POSTS_AT_LEAST

The Instagram account has published at least this many posts.

minPosts: integer ≥ 0 posts. Users see: “At least 10 Instagram posts”.

{"kind":"INSTAGRAM_POSTS_AT_LEAST","minPosts":10}

INSTAGRAM_VERIFIED

The Instagram account has Instagram's verified badge.

No parameters. Users see: “Verified Instagram account”.

{"kind":"INSTAGRAM_VERIFIED"}

X#

LiveIssued via X · 3 credentials · source x

Ownership of an X account via X's own login: username, followers, posts, account age and verification.

X_FOLLOWERS_AT_LEAST

The holder's X account has at least this many followers.

minFollowers: integer ≥ 0 followers. Users see: “At least 1,000 followers on X”.

{"kind":"X_FOLLOWERS_AT_LEAST","minFollowers":1000}

X_USERNAME_EQUALS

The holder owns this X account.

username: string, up to 64 characters, or an array of up to 16. Users see: “X account @lkp”.

{"kind":"X_USERNAME_EQUALS","username":"lkp"}

X_ACCOUNT_AGE_AT_LEAST

The X account was created at least this many days ago.

minDays: 0 to 36500 days. Users see: “X account at least 1 year old”.

{"kind":"X_ACCOUNT_AGE_AT_LEAST","minDays":365}

X_VERIFIED

The X account is verified.

No parameters. Users see: “Verified X account”.

{"kind":"X_VERIFIED"}

X_POSTS_AT_LEAST

The X account has published at least this many posts.

minPosts: integer ≥ 0 posts. Users see: “At least 100 posts on X”.

{"kind":"X_POSTS_AT_LEAST","minPosts":100}

TikTok#

LiveIssued via TikTok · 3 credentials · source tiktok

Ownership of a TikTok account via TikTok's own login: username, followers, likes, videos and verification.

TIKTOK_FOLLOWERS_AT_LEAST

The holder's TikTok account has at least this many followers.

minFollowers: integer ≥ 0 followers. Users see: “At least 1,000 TikTok followers”.

{"kind":"TIKTOK_FOLLOWERS_AT_LEAST","minFollowers":1000}

TIKTOK_USERNAME_EQUALS

The holder owns this TikTok account.

username: string, up to 64 characters, or an array of up to 16. Users see: “TikTok account @lkp”.

{"kind":"TIKTOK_USERNAME_EQUALS","username":"lkp"}

TIKTOK_LIKES_AT_LEAST

The TikTok account's videos have at least this many likes in total.

minLikes: integer ≥ 0 likes. Users see: “At least 10,000 TikTok likes”.

{"kind":"TIKTOK_LIKES_AT_LEAST","minLikes":10000}

TIKTOK_VERIFIED

The TikTok account is verified.

No parameters. Users see: “Verified TikTok account”.

{"kind":"TIKTOK_VERIFIED"}

TIKTOK_VIDEOS_AT_LEAST

The TikTok account has published at least this many videos.

minVideos: integer ≥ 0 videos. Users see: “At least 10 TikTok videos”.

{"kind":"TIKTOK_VIDEOS_AT_LEAST","minVideos":10}

GitHub#

LiveIssued via GitHub · 5 credentials · source github

Ownership of a GitHub account via GitHub's own login: username, followers, account age, two-factor status, repositories, contributions and organisations.

GITHUB_FOLLOWERS_AT_LEAST

The holder's GitHub account has at least this many followers.

minFollowers: integer ≥ 0 followers. Users see: “At least 10 GitHub followers”.

{"kind":"GITHUB_FOLLOWERS_AT_LEAST","minFollowers":10}

GITHUB_USERNAME_EQUALS

The holder owns this GitHub account.

username: string, up to 64 characters, or an array of up to 16. Users see: “GitHub account @lkp”.

{"kind":"GITHUB_USERNAME_EQUALS","username":"lkp"}

GITHUB_ACCOUNT_AGE_AT_LEAST

The GitHub account was created at least this many days ago.

minDays: 0 to 36500 days. Users see: “GitHub account at least 1 year old”.

{"kind":"GITHUB_ACCOUNT_AGE_AT_LEAST","minDays":365}

GITHUB_TWO_FACTOR

The GitHub account has two-factor authentication turned on.

No parameters. Users see: “GitHub account with two-factor sign-in”.

{"kind":"GITHUB_TWO_FACTOR"}

GITHUB_REPOS_AT_LEAST

The GitHub account owns at least this many public repositories.

minRepos: integer ≥ 0 repositories. Users see: “At least 5 public GitHub repositories”.

{"kind":"GITHUB_REPOS_AT_LEAST","minRepos":5}

GITHUB_CONTRIBUTIONS_AT_LEAST

The GitHub account made at least this many contributions in the last year.

minContributions: integer ≥ 0 contributions. Users see: “At least 100 GitHub contributions in the last year”.

{"kind":"GITHUB_CONTRIBUTIONS_AT_LEAST","minContributions":100}

GITHUB_ORG_MEMBER

The holder is a member of this GitHub organisation.

organisation: string, up to 100 characters, or an array of up to 16. Users see: “Member of the github GitHub organisation”.

{"kind":"GITHUB_ORG_MEMBER","organisation":"github"}

Bank account#

LiveIssued via Enable Banking · 3 credentials · source bank

A bank account read through open banking: its balance, IBAN and account holder name.

BALANCE_AT_LEAST

The holder's account balance is at least this amount, in euros.

minBalanceCents: integer ≥ 0 (minor currency units). Users see: “Balance of at least €1,000.00”.

{"kind":"BALANCE_AT_LEAST","minBalanceCents":100000}

BANK_ACCOUNT_EQUALS

The holder controls exactly this bank account.

iban: string, up to 100 characters, or an array of up to 16. Users see: “Holds bank account NL91ABNA0417164300”.

{"kind":"BANK_ACCOUNT_EQUALS","iban":"NL91ABNA0417164300"}

BANK_HOLDER_EQUALS

The name the bank has on the account. Case and accents are ignored.

holderName: string, up to 100 characters, or an array of up to 16. Users see: “Bank account in the name of JAN DE VRIES”.

{"kind":"BANK_HOLDER_EQUALS","holderName":"JAN DE VRIES"}

Combining requirements#

Send up to 40 requirements per session (the full catalog). Same-credential checks compile to one proof. The user must prove all of them, in one step, with one anonymous ID.
Minimums of the same kind merge to the strictest: two minimum ages keep the higher one.
Exact matches accept several values: nationality can be { "kind": "COUNTRY_EQUALS", "countryIsoNumeric": [250, 826] } (France or the UK). Repeating the same requirement with different values unions them. The result confirms that one of the values matched, not which one.
Users only share what you ask for. Requiring a minimum age never reveals the birth date or the nationality.
Nationality is citizenship printed on the document, not current physical location. Address country is the address on the document when it has one.
Exact-match requirements (a name, a phone number, an organisation) reveal nothing beyond the match. Users see the exact value you ask about before they share.

The console's integration builder lets you pick requirements visually and generates the request for you.

List them programmatically#

GET/v1/verification-types

Public, no API key needed. Returns every module and requirement with its parameter limits, status and an example, so you can build your own settings UI or validate configuration in CI.

curl https://lkp-verifier.onrender.com/v1/verification-types

Response

{
  "object": "list",
  "maxRequirements": 40,
  "maxProofs": 27,
  "data": [
    {
      "id": "government_id",
      "title": "Government ID",
      "provider": "Didit",
      "status": "live",
      "requirements": [
        {
          "kind": "AGE_OVER",
          "status": "live",
          "combine": "strictest",
          "param": { "name": "minAge", "label": "Minimum age", "input": "integer", "default": 18, "min": 1, "max": 150, "unit": "years" },
          "example": { "kind": "AGE_OVER", "minAge": 18 }
        },
        {
          "kind": "COUNTRY_EQUALS",
          "status": "live",
          "combine": "any_of",
          "maxValues": 16,
          "param": { "name": "countryIsoNumeric", "label": "Country", "input": "country", "default": 528, "min": 1, "max": 999 },
          "example": { "kind": "COUNTRY_EQUALS", "countryIsoNumeric": [250, 826] }
        },
        …
      ]
    },
    …
  ]
}

Need something else?#

We add new verification types regularly. If you need a check that isn't listed, such as a different document attribute, another social platform or a professional licence, tell us what you need and how you'd use it.