Skip to content

GuidesEvery fact

Every fact you can ask someone to prove.

Each one is a yes or no that the person proves on their phone in the Prson app, signed by Prson. You learn the answer, not the data behind it: “18 or older: yes”, never the date of birth.

Age

How old the person is, from the date of birth on their passport or ID card chip. You learn only yes or no, never the date.

How to verify: age
  • At least a given age

    Available

    For example:18 or olderage_gte_18

    The person is at least this many years old.

    What it doesn’t prove, and where it comes from

    From: The date of birth on their passport or ID card chip.

    Worked out from the chip's date of birth at the moment Prson signs the answer. If only a birth year is known and the person could be on either side of the age, Prson gives no answer rather than guess, so the request can't be fulfilled.

  • At most a given age

    Available

    For example:17 or youngerage_lte_17

    The person is at most this many years old (age_lte_17 is under 18).

    What it doesn’t prove, and where it comes from

    From: The date of birth on their passport or ID card chip.

    Worked out from the chip's date of birth at the moment Prson signs the answer. If only a birth year is known and the person could be on either side of the age, Prson gives no answer rather than guess, so the request can't be fulfilled.

  • Between two ages

    Available

    For example:Between 18 and 30 years oldage_between_18_30

    The person is between these two ages, both included.

    What it doesn’t prove, and where it comes from

    From: The date of birth on their passport or ID card chip.

    Worked out from the chip's date of birth at the moment Prson signs the answer. If only a birth year is known and the person could be on either side of the age, Prson gives no answer rather than guess, so the request can't be fulfilled.

Document

The identity document whose chip they verified in Prson: its kind, the country that issued it and how long it is valid.

How to verify: document

Nationality

Their nationality as written in the document whose chip they verified: one country, or the EU, the EEA or the Schengen Area.

How to verify: nationality
  • Citizen of a country

    Available

    For example:Citizen of Germanynationality_eq_DEU

    Their nationality is this country.

    What it doesn’t prove, and where it comes from

    From: Their passport or ID card chip, checked by Prson.

    The nationality written in the document whose chip they verified in Prson (level 5 or 6). A person with two nationalities is matched on the one in that document: a no doesn't mean they hold no other.

  • EU citizen

    Available

    For example:EU citizennationality_in_eu

    Holder is an EU citizen.

    What it doesn’t prove, and where it comes from

    From: Their passport or ID card chip, checked by Prson.

    The nationality written in the document whose chip they verified in Prson (level 5 or 6). A person with two nationalities is matched on the one in that document: a no doesn't mean they hold no other.

  • Citizen of an EU or EEA country

    Available

    For example:Citizen of an EU or EEA countrynationality_in_eea

    Holder is an EEA citizen.

    What it doesn’t prove, and where it comes from

    From: Their passport or ID card chip, checked by Prson.

    The nationality written in the document whose chip they verified in Prson (level 5 or 6). A person with two nationalities is matched on the one in that document: a no doesn't mean they hold no other.

  • Citizen of a Schengen country

    Available

    For example:Citizen of a Schengen countrynationality_in_schengen

    Holder is a citizen of a Schengen country.

    What it doesn’t prove, and where it comes from

    From: Their passport or ID card chip, checked by Prson.

    The nationality written in the document whose chip they verified in Prson (level 5 or 6). A person with two nationalities is matched on the one in that document: a no doesn't mean they hold no other.

Where they live

Where their postal address is (country, region, city or postcode), proved with a code in a letter posted to it.

How to verify: where they live
  • Has a verified postal address

    Where enabled

    For example:Postal address verifiedaddress_verified

    Postal address is verified.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

  • Lives in a country

    Where enabled

    For example:Postal address in Portugaladdress_country_eq_PT

    Their verified postal address is in this country.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    Any country where the letter can be delivered: see Coverage by country. A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

  • Lives in an EU country

    Where enabled

    For example:Postal address in an EU countryaddress_country_in_eu

    Postal address is in the EU.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    Any country where the letter can be delivered: see Coverage by country. A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

  • Lives in an EU or EEA country

    Where enabled

    For example:Postal address in an EU or EEA countryaddress_country_in_eea

    Postal address is in the EEA.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    Any country where the letter can be delivered: see Coverage by country. A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

  • Lives in a Schengen country

    Where enabled

    For example:Postal address in a Schengen countryaddress_country_in_schengen

    Postal address is in the Schengen Area.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    Any country where the letter can be delivered: see Coverage by country. A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

  • Lives in a region, state or province

    Where enabled

    For example:Postal address in California, United Statesaddress_region_eq_US_california

    Their verified postal address is in this region of this country.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    The region is written lower case, accents removed, words joined by hyphens ("São Paulo" becomes sao-paulo), and compared with what the person wrote on their address, so local spellings matter: lisboa, not lisbon. No answer if their address has no region; an address in another country is a no. A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

  • Lives in a city

    Where enabled

    For example:Postal address in Lisboa, Portugaladdress_city_eq_PT_lisboa

    Their verified postal address is in this city of this country.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    The city is written lower case, accents removed, words joined by hyphens ("São Paulo" becomes sao-paulo), and compared with what the person wrote on their address, so local spellings matter: lisboa, not lisbon. No answer if their address has no city; an address in another country is a no. A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

  • Lives in a postcode area

    Where enabled

    For example:Postal address in Portugal, postcode starting 1000address_postcode_prefix_PT_1000

    Their verified postal address has a postcode starting with these letters and digits.

    What it doesn’t prove, and where it comes from

    From: A code in a letter posted to their address.

    Compares letters and digits only, in upper case: spaces and dashes are removed from their postcode (1000-001 becomes 1000001), so write the prefix the same way. An address in another country is a no. A letter with a one-time code was posted to the address (by Pingen) and the person typed the code in the app. It proves a letter reached them there on the day they verified, not that they live there now, own it, or are the only person there. An address verification lasts 365 days.

Residence permit

A residence permit read from its chip, and which country issued it.

How to verify: residence permit
  • Residence permit from a country

    Available

    For example:Residence permit from Portugalresidence_permit_from_PRT

    They verified a residence permit issued by this country.

    What it doesn’t prove, and where it comes from

    From: The chip of a residence permit they verified in Prson, checked by Prson.

    Needs a residence permit whose chip the person verified in Prson (document type residence_permit); it says which country issued it. It doesn't say what the permit allows (work, study, family) or whether it was revoked; add doc_not_expired to know it hasn't expired. Someone who verified a passport or ID card instead answers no: that isn't evidence they have no permit.

  • Residence permit from an EU country

    Available

    For example:Residence permit from an EU countryresidence_permit_in_eu

    Holds a residence permit issued by an EU country.

    What it doesn’t prove, and where it comes from

    From: The chip of a residence permit they verified in Prson, checked by Prson.

    Needs a residence permit whose chip the person verified in Prson (document type residence_permit); it says which country issued it. It doesn't say what the permit allows (work, study, family) or whether it was revoked; add doc_not_expired to know it hasn't expired. Someone who verified a passport or ID card instead answers no: that isn't evidence they have no permit.

  • Residence permit from an EU or EEA country

    Available

    For example:Residence permit from an EU or EEA countryresidence_permit_in_eea

    Holds a residence permit issued by an EU or EEA country.

    What it doesn’t prove, and where it comes from

    From: The chip of a residence permit they verified in Prson, checked by Prson.

    Needs a residence permit whose chip the person verified in Prson (document type residence_permit); it says which country issued it. It doesn't say what the permit allows (work, study, family) or whether it was revoked; add doc_not_expired to know it hasn't expired. Someone who verified a passport or ID card instead answers no: that isn't evidence they have no permit.

  • Residence permit from a Schengen country

    Available

    For example:Residence permit from a Schengen countryresidence_permit_in_schengen

    Holds a residence permit issued by a Schengen country.

    What it doesn’t prove, and where it comes from

    From: The chip of a residence permit they verified in Prson, checked by Prson.

    Needs a residence permit whose chip the person verified in Prson (document type residence_permit); it says which country issued it. It doesn't say what the permit allows (work, study, family) or whether it was revoked; add doc_not_expired to know it hasn't expired. Someone who verified a passport or ID card instead answers no: that isn't evidence they have no permit.

Phone

A phone number they proved with an SMS code: that it is verified, a mobile, or from a country.

How to verify: phone
  • Has a verified phone number

    Where enabled

    For example:Phone number verifiedphone_verified

    Phone number is verified.

    What it doesn’t prove, and where it comes from

    From: A code sent by SMS to their phone.

    They signed in with a code sent by SMS to that number, so they could receive its texts when they verified. A phone verification lasts 365 days. It doesn't say whose name the line is in.

  • Phone number is a mobile

    Where enabled

    For example:Phone number is a mobilephone_is_mobile

    Phone number is a mobile number.

    What it doesn’t prove, and where it comes from

    From: A code sent by SMS to their phone.

    The line type comes from the international numbering plan, not a live lookup with the carrier: a number moved to another network keeps its original range's type. Where the plan doesn't separate mobiles from landlines (the US, Canada and a few others) Prson gives no answer, so the request can't be fulfilled with a yes or no there. Internet (VoIP) numbers are a no. They signed in with a code sent by SMS to that number, so they could receive its texts when they verified. A phone verification lasts 365 days. It doesn't say whose name the line is in.

  • Phone number from a country

    Where enabled

    For example:Phone number from Portugalphone_country_eq_PT

    Their verified phone number belongs to this country's numbering plan.

    What it doesn’t prove, and where it comes from

    From: A code sent by SMS to their phone.

    The country comes from the number itself (the international numbering plan), not a live lookup with the carrier: it says nothing about where the person is. They signed in with a code sent by SMS to that number, so they could receive its texts when they verified. A phone verification lasts 365 days. It doesn't say whose name the line is in.

  • Phone number from an EU country

    Where enabled

    For example:Phone number from an EU countryphone_country_in_eu

    Phone number is from an EU country.

    What it doesn’t prove, and where it comes from

    From: A code sent by SMS to their phone.

    The country comes from the number itself (the international numbering plan), not a live lookup with the carrier: it says nothing about where the person is. They signed in with a code sent by SMS to that number, so they could receive its texts when they verified. A phone verification lasts 365 days. It doesn't say whose name the line is in.

Email

An email address they proved with a code: that it is verified, a work address, at a given domain, or not a throwaway one.

How to verify: email
  • Has a verified email address

    Available

    For example:Email address verifiedemail_verified

    Email address is verified.

    What it doesn’t prove, and where it comes from

    From: A code sent to their email address.

    They typed a code sent to that address, so they could read that inbox when they verified. An email verification lasts 180 days. It doesn't say who owns or runs the address.

  • Work email address

    Available

    For example:Work email address (not a free or throwaway provider)email_work

    Email address is at an organisation's own domain, not a free or throwaway provider.

    What it doesn’t prove, and where it comes from

    From: A code sent to their email address.

    Yes means the domain isn't on Prson's list of free or throwaway providers (gmail.com, outlook.com, yahoo, gmx and others; mailinator.com and others). It doesn't prove an employer or a job title, or that a company runs the domain: a personal domain counts. To ask about one organisation, use email_domain_eq_{domain}. They typed a code sent to that address, so they could read that inbox when they verified. An email verification lasts 180 days. It doesn't say who owns or runs the address.

  • Email address at a domain

    Available

    For example:Email address at example.comemail_domain_eq_example.com

    Their verified email address is at exactly this domain.

    What it doesn’t prove, and where it comes from

    From: A code sent to their email address.

    The domain must match exactly: mail.example.com and example.com are different. They could read an inbox at that domain when they verified; it doesn't prove they still work or study there, or their role. They typed a code sent to that address, so they could read that inbox when they verified. An email verification lasts 180 days. It doesn't say who owns or runs the address.

  • Email address isn't a throwaway one

    Available

    For example:Email address is not a throwaway oneemail_not_disposable

    Email address is not at a throwaway provider.

    What it doesn’t prove, and where it comes from

    From: A code sent to their email address.

    Yes means the domain isn't on a short list of throwaway inbox services. The list isn't complete: a rare throwaway service can still pass. They typed a code sent to that address, so they could read that inbox when they verified. An email verification lasts 180 days. It doesn't say who owns or runs the address.

  • School or university email address

    Coming soon

    For example:School or university email addressemail_domain_academic

    Email address is at a university or school.

    What it doesn’t prove, and where it comes from

    From: A list of academic domains (not available yet).

    Coming soon: Prson can't verify this yet, so asking for it is refused.

Website

A website's domain they proved they control with a DNS record.

How to verify: website
  • Controls a website

    Available

    For example:Controls the website example.comwebsite_domain_eq_example.com

    They proved control of this domain's DNS.

    What it doesn’t prove, and where it comes from

    From: A DNS record they added to the domain, checked by Prson.

    They added a DNS TXT record at _prson-challenge.{domain} that Prson looked up, so they controlled the domain's DNS at that time. It lasts up to 365 days, never past the domain's registration expiry. It doesn't prove who legally owns the domain or the company behind it. The domain must match exactly: www.example.com and example.com are different.

Identity level

How far their identity was checked. Level 5 or more is what Prson calls a verified human: a passport or ID card chip checked by Prson.

How to verify: identity level
  • Verified human

    Available

    For example:Verified human (identity level 5 or higher)verification_level_gte_5

    Prson checked the chip of their passport or ID card (level 5 or more).

    What it doesn’t prove, and where it comes from

    From: Their verification level in Prson (5 and 6: chip checked by Prson).

    Says how far the identity was checked, not who the person is: no name or document detail is shared. Levels 5 and 6 (a passport or ID card chip checked by Prson) are what Prson calls a verified human; 6 adds a face match between a live selfie and the chip photo. Levels 1 to 4 are checks done on the phone and are never called verified human.

  • Verified human, with a face match

    Available

    For example:Verified human (identity level 6 or higher)verification_level_gte_6

    Level 6: chip checked by Prson, plus a face match between a live selfie and the chip photo.

    What it doesn’t prove, and where it comes from

    From: Their verification level in Prson (5 and 6: chip checked by Prson).

    Says how far the identity was checked, not who the person is: no name or document detail is shared. Levels 5 and 6 (a passport or ID card chip checked by Prson) are what Prson calls a verified human; 6 adds a face match between a live selfie and the chip photo. Levels 1 to 4 are checks done on the phone and are never called verified human.

  • Identity level 4 or more

    Available

    For example:Identity verified to level 4 or higherverification_level_gte_4

    At least a photo of an identity document, checked on the phone (never called a verified human).

    What it doesn’t prove, and where it comes from

    From: Their verification level in Prson (5 and 6: chip checked by Prson).

    Says how far the identity was checked, not who the person is: no name or document detail is shared. Levels 5 and 6 (a passport or ID card chip checked by Prson) are what Prson calls a verified human; 6 adds a face match between a live selfie and the chip photo. Levels 1 to 4 are checks done on the phone and are never called verified human.

  • Identity level 3 or more

    Available

    For example:Identity verified to level 3 or higherverification_level_gte_3

    At least a live selfie and Face ID on their phone (never called a verified human).

    What it doesn’t prove, and where it comes from

    From: Their verification level in Prson (5 and 6: chip checked by Prson).

    Says how far the identity was checked, not who the person is: no name or document detail is shared. Levels 5 and 6 (a passport or ID card chip checked by Prson) are what Prson calls a verified human; 6 adds a face match between a live selfie and the chip photo. Levels 1 to 4 are checks done on the phone and are never called verified human.

BankComing soon

Bank account, balance and income. Coming soon: Prson can't verify these yet, and asking for them is refused.

  • Has a verified bank account

    Coming soon

    For example:Has a verified bank accounthas_verified_bank_account

    Has a verified bank account.

    What it doesn’t prove, and where it comes from

    From: Bank linking (not available yet).

    Coming soon: Prson can't verify this yet, so asking for it is refused.

  • Bank account in a country

    Coming soon

    For example:Bank account in Portugalbank_account_country_eq_PRT

    Their bank account is in this country.

    What it doesn’t prove, and where it comes from

    From: Bank linking (not available yet).

    Coming soon: Prson can't verify this yet, so asking for it is refused.

  • Bank account in an EU country

    Coming soon

    For example:Bank account in an EU countrybank_account_in_eu

    Their bank account is in an EU country.

    What it doesn’t prove, and where it comes from

    From: Bank linking (not available yet).

    Coming soon: Prson can't verify this yet, so asking for it is refused.

  • Bank account in an EU or EEA country

    Coming soon

    For example:Bank account in an EU or EEA countrybank_account_in_eea

    Their bank account is in an EU or EEA country.

    What it doesn’t prove, and where it comes from

    From: Bank linking (not available yet).

    Coming soon: Prson can't verify this yet, so asking for it is refused.

  • Bank balance of at least an amount

    Coming soon

    For example:Bank balance of at least €1,000balance_gte_1000_eur

    Their bank balance is at least this amount.

    What it doesn’t prove, and where it comes from

    From: Bank linking (not available yet).

    Coming soon: Prson can't verify this yet, so asking for it is refused.

  • Monthly income of at least an amount

    Coming soon

    For example:Monthly income of at least €2,000income_gte_2000_eur

    Their monthly income is at least this amount.

    What it doesn’t prove, and where it comes from

    From: Bank linking (not available yet).

    Coming soon: Prson can't verify this yet, so asking for it is refused.

Not sure which one to ask for?

The verification guides explain each kind of fact in plain words, with what a yes proves and what it doesn’t. Building a website or an AI agent? The developer docs list the same facts with example requests.