Skip to Content
Platform.Ontology

Digital Credentials API (mDL and wallet IDs)

Lets a site ask for a government ID or other credential from a digital wallet.

Asks you firstSign in and identityWalletWeb browsersWhile you use it

In one line

Can ask for facts from your digital ID, only the ones you approve

Lets a site ask for a government ID or other credential from a digital wallet.

Requests only fields the person approves (age over 21, name, address) from a wallet such as Google Wallet or Apple Wallet, with a browser prompt.

What it can and can't do

What the user does: You tap Verify with ID and approve each item in your wallet

It can

  • Ask your wallet for one fact such as age over 21, name or address
  • Receive only the fields you approve in the wallet
  • Prove you are an adult or a resident without handing over the whole ID

It cannot

  • See your full ID card or photo when you approve only one field
  • Get anything without your approval in the wallet
  • Work in Firefox or Safari on most devices today
  • Keep the ID facts after the check unless the site chooses to store them

How it differs between platforms: Chrome and Edge support it. Safari support is partial. Firefox does not.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported1412025-09-30None
EdgeSupported1412025-10-03None
FirefoxNot supportedNot availableNot listedNone
SafariPartial262025-09-15mdoc only
Safari on iPhonePartial262025-09-15mdoc only
Chrome on AndroidSupported1412025-09-30Play services 24.0+
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APInavigator.credentials.get({digital:{requests:[{protocol:'openid4vp-v1-unsigned'|'org-iso-mdoc', data}]}}), DigitalCredential.userAgentAllowsProtocol()
Permissions policydigital-credentials-get
Browser compat keysapi.DigitalCredential
How access is grantedprompt
What the user seesBrowser wallet picker plus per field consent in the wallet
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. Page receives the result

Data you get

What comes back: Lets a site ask for a government ID or other credential from a digital wallet.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
protocolenumNoneopenid4vp-v1-unsigned, org-iso-mdocNot listed
dataobjectNoneverifiable presentation or mdoc responsefields chosen by the person

Technical limits

  • Android needs Play services 24.0 or newer; desktop uses QR plus BLE proximity
  • Firefox no stable support
  • Spec still a W3C Working Draft

The story

What it is

A site can ask your phone wallet for a government ID, with you approving what is shared.

For you

A prompt appears on your computer or phone asking if you agree to share things like 'over 21' from your wallet ID. You scan a code or tap and approve with Face ID. Nothing is shared until you agree.

For makers

Makers use it for age checks, account opening and fraud checks without collecting photos of ID. It lowers risk and cost, and they store less data about the person.

Where you see it

TypeExampleApps
shoppingAn online liquor or vape shop asks wallet ID to prove 'over 21' without storing a driver's license photo.None named
bankingA bank opens an account online by asking the wallet for a verified name and address instead of an upload.None named
gamesA game or betting site proves a player is an adult with a single wallet approval, with no ID scan.None named
travelA car rental site verifies a driver's license from the wallet before it releases the booking.Hertz
socialA social or dating site uses a wallet age check to keep kids out, sharing only the yes or no.None named
securityA site checks that the ID is signed by a real government issuer, which stops forged scans.None named

Risks

  • Oversharing if you approve too much
  • Wallet vendor sees the request

What the platform says

Good uses and abuse

Legitimate uses

  • Age verification
  • KYC
  • Account recovery

Known abuse

  • Over collection of personal data by relying parties

Scores

ScoreValueMeaning
Sensitivity5 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2025-09, Chrome 141: Digital Credentials ships (OpenID4VP and ISO 18013-7 Annex C)
  • 2025-09, Safari 26: Safari 26 supports only org-iso-mdoc
  • 2026-09, Safari 27: DigitalCredentialRequest renamed DigitalCredentialGetRequest

Sources

How well checked: Checked against real behavior.

On this page