Igrantio Credential Schema Age Verification

Age Verification credential schema

When to use

Use this skill when you issue or ask for an Age Verification attestation. The credential proves that the holder is over an age limit. It carries no name, no date of birth, and no document number. The holder shows one boolean and keeps the rest of the credential hidden.

The registry publishes this schema in one format only: mso_mdoc. The metadata sets isMsoMdoc to true, and isSdJwt and isJwt to false. There is no SD-JWT VC form and no JWT form of this schema in the registry.

This page describes registry version 2026.4.1, the latest version of the template.

Claim path pointer document - mso_mdoc

{
  "claims": [
    {
      "path": ["eu.europa.ec.av.1", "age_over_14"],
      "mandatory": false,
      "limitDisclosure": true
    },
    {
      "path": ["eu.europa.ec.av.1", "age_over_16"],
      "mandatory": false,
      "limitDisclosure": true
    },
    {
      "path": ["eu.europa.ec.av.1", "age_over_18"],
      "mandatory": true,
      "limitDisclosure": true
    },
    {
      "path": ["eu.europa.ec.av.1", "age_over_21"],
      "mandatory": false,
      "limitDisclosure": true
    },
    {
      "path": ["eu.europa.ec.av.1", "age_over_65"],
      "mandatory": false,
      "limitDisclosure": true
    }
  ]
}

How to read the fields

Each item of the claims array is one claim path pointer.

• path is an array that selects one claim. Each element is a string for an object key, an integer for an array index, or null for every element of an array. For mso_mdoc, the first element is the mDoc namespace. Here the namespace is eu.europa.ec.av.1, and it is the same as the doctype. Every path of the configuration must start with that same element.
• mandatory says if the claim must hold a value when you issue. The issuer reads a missing mandatory as true. In this schema only age_over_18 is mandatory. The other four age limits are optional: send the ones that your use case needs.
• limitDisclosure says if the holder can disclose the claim on its own. Every claim of this schema sets it to true, so the holder can show age_over_18 and keep age_over_65 hidden.

Every claim value is a boolean.

Use with the iGrant.io API

Create a credential definition with:

POST /v2/config/digital-wallet/openid/sdjwt/credential-definition

Put one entry in credentialDefinitions[] and copy the claims array of the schema document into that entry.

• Set version to version_01 at the top level of the request.
• Set credentialFormat to mso_mdoc.
• Set doctype to eu.europa.ec.av.1.
• Put the array in claims.claims.
• Set validationPath to $.
• Add cose_key to credentialBindingMethods if the wallet binds the mdoc with a COSE key.

{
  "label": "Issue Age Verification",
  "version": "version_01",
  "credentialDefinitions": [
    {
      "credentialFormat": "mso_mdoc",
      "doctype": "eu.europa.ec.av.1",
      "validationPath": "$",
      "claims": {
        "claims": [
          {
            "path": ["eu.europa.ec.av.1", "age_over_18"],
            "mandatory": true,
            "limitDisclosure": true
          },
          {
            "path": ["eu.europa.ec.av.1", "age_over_21"],
            "mandatory": false,
            "limitDisclosure": true
          }
        ]
      }
    }
  ]
}

The example shows two claims. Send the full array when you want the full schema.

label is free text and does not change the schema. The platform reserves some labels. If the create call fails with HTTP 400 because of the label, choose another one.

When you issue, the top key of claims in the issue request is the doctype namespace eu.europa.ec.av.1.

Read igrantio-api-issuer for the full operation reference: every request field, the display options, revocation, and the issue operation that fills these claims. Read igrantio-api-verifier for the DCQL query that asks for one age limit.

Source is the registry

This skill mirrors the claim path pointer template in the iGrant.io verifiable data registry. If this skill and the registry file disagree, the registry wins. Fetch the source before you rely on a claim path:

• Template: https://github.com/decentralised-dataexchange/verifiable-data-registry/tree/main/credentialSchemas/claimPathPointer/ageVerification
• Raw schema: https://raw.githubusercontent.com/decentralised-dataexchange/verifiable-data-registry/main/credentialSchemas/claimPathPointer/ageVerification/2026.4.1/mso_mdoc.schema.json
• Raw metadata: https://raw.githubusercontent.com/decentralised-dataexchange/verifiable-data-registry/main/credentialSchemas/claimPathPointer/ageVerification/2026.4.1/mso_mdoc.schema.metadata.json

A newer version directory can appear in the registry. Check the directory listing for a version above 2026.4.1 and use the newest one.