National Diploma - credential schema
When to use
Use this skill when the ministry, or a national learner registry, issues a
diploma as a verifiable credential to a learner. The diploma is the
qualification evidence a graduate later shares with an employer. It is issued in
the same wallet session as the diploma-fee payment (a dynamic credential
request), so the credential definition sets
supportInteractiveAuthorisationEndpoint: true.
This is a use-case credential, not a public verifiable-data-registry type.
The showcase defines it with the type urn:education:diploma:1 in the
dc+sd-jwt format. It models the W3C VC 2.0 / Open Badges education fields
semantically, carried as an OWS dc+sd-jwt credential so the holder can
selectively disclose each field.
Prerequisites
- An iGrant.io Organisation Wallet Suite (OWS) API key for the issuing
organisation. Keep it on the server, in an environment variable or a secret
manager. The browser never sees it.
- The OWS environment the key belongs to. The default is demo
(
https://demo-api.igrant.io). Use staging
(https://staging-api.igrant.io) only when the integrator asks for it.
- An x509 signing key whose certificate is registered on a trust list (the
showcase uses NXD Pub-EAA). Until it is, wallets show the credential as
unverified. See https://docs.igrant.io/docs/trust-relying-party-registration/.
Ask the integrator first
Ask one question at a time, with a recommended default. Record the answers
before you write code.
- Environment - demo or staging? Default demo.
- API key - the OWS API key for the issuing organisation (the Ministry of
Education sandbox in the showcase).
- Label - the credential definition label. Must be unique in the
organisation and at least 3 characters. Pick a fresh label so you do not
collide with an existing definition (for example
National Diploma).
- Signing key (
cryptographicKeyIdentifier) - the id of the X.509 key to
sign with, and its certificate on the trust list. Default: the default key
of the organisation.
- Revocation - status list on? Recommend on; a diploma has a lifetime.
- Validity -
expirationInDays? The showcase uses 3650 (10 years).
What the claims describe
All nine claims are mandatory and selectively disclosable (dc+sd-jwt).
- Learner and award:
learnerName, qualificationName, qualificationCode,
awardingInstitution, awardDate, programme, result.
- Registry link:
ulid (the learner identifier from the National Learner
Registry) and graduationDecisionHash (the hash of the signed graduation
decision the diploma references).
Claim path pointer document (dc+sd-jwt)
| Fact |
Value |
| Title |
Diploma |
| Format |
dc+sd-jwt |
vct to send |
urn:education:diploma:1 |
validationPath |
$ |
| Claim carrier in the request |
claims |
{
"claims": [
{ "path": ["learnerName"], "mandatory": true, "limitDisclosure": true },
{ "path": ["qualificationName"], "mandatory": true, "limitDisclosure": true },
{ "path": ["qualificationCode"], "mandatory": true, "limitDisclosure": true },
{ "path": ["awardingInstitution"], "mandatory": true, "limitDisclosure": true },
{ "path": ["awardDate"], "mandatory": true, "limitDisclosure": true },
{ "path": ["programme"], "mandatory": true, "limitDisclosure": true },
{ "path": ["result"], "mandatory": true, "limitDisclosure": true },
{ "path": ["ulid"], "mandatory": true, "limitDisclosure": true },
{ "path": ["graduationDecisionHash"], "mandatory": true, "limitDisclosure": true }
]
}
Use with the iGrant.io API
Create the credential definition with
POST /v2/config/digital-wallet/openid/sdjwt/credential-definition. Send the
claims array above inside the single dc+sd-jwt configuration entry.
{
"label": "National Diploma",
"version": "version_01",
"cryptographicKeyFormat": "x509",
"supportInteractiveAuthorisationEndpoint": true,
"display": {
"name": "Diploma",
"description": "Ministry of Education diploma credential",
"backgroundColor": "#1d4e89",
"textColor": "#ffffff"
},
"credentialDefinitions": [
{
"credentialFormat": "dc+sd-jwt",
"vct": "urn:education:diploma:1",
"validationPath": "$",
"claims": {
"claims": [
{ "path": ["learnerName"], "mandatory": true, "limitDisclosure": true },
{ "path": ["qualificationName"], "mandatory": true, "limitDisclosure": true },
{ "path": ["qualificationCode"], "mandatory": true, "limitDisclosure": true },
{ "path": ["awardingInstitution"], "mandatory": true, "limitDisclosure": true },
{ "path": ["awardDate"], "mandatory": true, "limitDisclosure": true },
{ "path": ["programme"], "mandatory": true, "limitDisclosure": true },
{ "path": ["result"], "mandatory": true, "limitDisclosure": true },
{ "path": ["ulid"], "mandatory": true, "limitDisclosure": true },
{ "path": ["graduationDecisionHash"], "mandatory": true, "limitDisclosure": true }
]
},
"supportRevocation": true,
"expirationInDays": 3650
}
]
}
Notes on the request.
label must be unique and at least 3 characters. The platform reserves the
labels Payment User Credential, Payment Card Credential, Payment Account Credential, PID Issuance and Photo ID Issuance; pick another label.
version is required. Its only value is version_01 (OpenID4VCI 1.0), and
you cannot change it after you create the definition.
cryptographicKeyFormat: "x509" signs with the default key of the
organisation and its X.509 certificate chain. Add
cryptographicKeyIdentifier to sign with another key.
supportInteractiveAuthorisationEndpoint: true lets the payment credential be
presented during issuance, so the diploma follows in the same session (the
dynamic credential request). Leave it off if you issue the diploma on its own.
- Keep the
id the response returns. The issue operation matches the claims to
this configuration by that id.
Read igrantio-api-issuer for the issue operation (InTime, pre-authorised code,
and the dynamic credential request with transaction data), the revocation
operation, and the full request reference.
Cross-references
igrantio-api-issuer - create credential definition, issue, and revoke.
igrantio-dcql-query-diploma - the DCQL query that asks a holder for a diploma
(the employer's qualification check).
igrantio-api-verifier - transaction data and the dynamic credential request.
igrantio-ows-overview - architecture and glossary.
1---2name: igrantio-credential-schema-diploma3description: 'Claim path pointer schema for the National Diploma credential (vct urn:education:diploma:1) used by the ITU / GovStack National Learner Registry and Education Wallet showcase. A dc+sd-jwt education credential the Ministry of Education issues to a learner, with the learner name, qualification, awarding institution, award date, programme, result, learner identifier (ULID) and the graduation decision hash. Use this skill when you build the diploma credential definition for the iGrant.io OpenID4VC API.'4license: Apache-2.05metadata:6 source: https://skillmd.com/skills/l3-igrant/igrantio-credential-schema-diploma7 categories: [credential-schema, education]8 provider: iGrant.io9 keywords: diploma, education credential, qualification, National Learner Registry, ULID, awarding institution, credential schema, claim path pointer, SD-JWT VC, EUDIW, GovStack, ITU10 version: 2026.10.0111 source-doc: https://giga-staging.igrant.io/knowledgebase/showcase-credentials12 credential-formats: dc+sd-jwt13 requires-skills: igrantio-api-issuer14---1516# National Diploma - credential schema1718## When to use19Use this skill when the ministry, or a national learner registry, issues a20**diploma** as a verifiable credential to a learner. The diploma is the21qualification evidence a graduate later shares with an employer. It is issued in22the same wallet session as the diploma-fee payment (a dynamic credential23request), so the credential definition sets24`supportInteractiveAuthorisationEndpoint: true`.2526This is a **use-case credential**, not a public verifiable-data-registry type.27The showcase defines it with the type `urn:education:diploma:1` in the28`dc+sd-jwt` format. It models the W3C VC 2.0 / Open Badges education fields29semantically, carried as an OWS `dc+sd-jwt` credential so the holder can30selectively disclose each field.3132## Prerequisites33- An **iGrant.io Organisation Wallet Suite (OWS) API key** for the issuing34 organisation. Keep it on the server, in an environment variable or a secret35 manager. The browser never sees it.36- The **OWS environment** the key belongs to. The default is **demo**37 (`https://demo-api.igrant.io`). Use **staging**38 (`https://staging-api.igrant.io`) only when the integrator asks for it.39- An **x509 signing key** whose certificate is registered on a trust list (the40 showcase uses NXD Pub-EAA). Until it is, wallets show the credential as41 unverified. See <https://docs.igrant.io/docs/trust-relying-party-registration/>.4243## Ask the integrator first44Ask one question at a time, with a recommended default. Record the answers45before you write code.46471. **Environment** - demo or staging? _Default demo._482. **API key** - the OWS API key for the issuing organisation (the Ministry of49 Education sandbox in the showcase).503. **Label** - the credential definition label. Must be unique in the51 organisation and at least 3 characters. Pick a fresh label so you do not52 collide with an existing definition (for example `National Diploma`).534. **Signing key (`cryptographicKeyIdentifier`)** - the id of the X.509 key to54 sign with, and its certificate on the trust list. _Default: the default key55 of the organisation._565. **Revocation** - status list on? _Recommend on; a diploma has a lifetime._576. **Validity** - `expirationInDays`? _The showcase uses 3650 (10 years)._5859## What the claims describe60All nine claims are mandatory and selectively disclosable (`dc+sd-jwt`).6162- **Learner and award**: `learnerName`, `qualificationName`, `qualificationCode`,63 `awardingInstitution`, `awardDate`, `programme`, `result`.64- **Registry link**: `ulid` (the learner identifier from the National Learner65 Registry) and `graduationDecisionHash` (the hash of the signed graduation66 decision the diploma references).6768## Claim path pointer document (`dc+sd-jwt`)6970| Fact | Value |71| --- | --- |72| Title | Diploma |73| Format | `dc+sd-jwt` |74| `vct` to send | `urn:education:diploma:1` |75| `validationPath` | `$` |76| Claim carrier in the request | `claims` |7778```json79{80 "claims": [81 { "path": ["learnerName"], "mandatory": true, "limitDisclosure": true },82 { "path": ["qualificationName"], "mandatory": true, "limitDisclosure": true },83 { "path": ["qualificationCode"], "mandatory": true, "limitDisclosure": true },84 { "path": ["awardingInstitution"], "mandatory": true, "limitDisclosure": true },85 { "path": ["awardDate"], "mandatory": true, "limitDisclosure": true },86 { "path": ["programme"], "mandatory": true, "limitDisclosure": true },87 { "path": ["result"], "mandatory": true, "limitDisclosure": true },88 { "path": ["ulid"], "mandatory": true, "limitDisclosure": true },89 { "path": ["graduationDecisionHash"], "mandatory": true, "limitDisclosure": true }90 ]91}92```9394## Use with the iGrant.io API95Create the credential definition with96`POST /v2/config/digital-wallet/openid/sdjwt/credential-definition`. Send the97`claims` array above inside the single `dc+sd-jwt` configuration entry.9899```json100{101 "label": "National Diploma",102 "version": "version_01",103 "cryptographicKeyFormat": "x509",104 "supportInteractiveAuthorisationEndpoint": true,105 "display": {106 "name": "Diploma",107 "description": "Ministry of Education diploma credential",108 "backgroundColor": "#1d4e89",109 "textColor": "#ffffff"110 },111 "credentialDefinitions": [112 {113 "credentialFormat": "dc+sd-jwt",114 "vct": "urn:education:diploma:1",115 "validationPath": "$",116 "claims": {117 "claims": [118 { "path": ["learnerName"], "mandatory": true, "limitDisclosure": true },119 { "path": ["qualificationName"], "mandatory": true, "limitDisclosure": true },120 { "path": ["qualificationCode"], "mandatory": true, "limitDisclosure": true },121 { "path": ["awardingInstitution"], "mandatory": true, "limitDisclosure": true },122 { "path": ["awardDate"], "mandatory": true, "limitDisclosure": true },123 { "path": ["programme"], "mandatory": true, "limitDisclosure": true },124 { "path": ["result"], "mandatory": true, "limitDisclosure": true },125 { "path": ["ulid"], "mandatory": true, "limitDisclosure": true },126 { "path": ["graduationDecisionHash"], "mandatory": true, "limitDisclosure": true }127 ]128 },129 "supportRevocation": true,130 "expirationInDays": 3650131 }132 ]133}134```135136Notes on the request.137138- `label` must be unique and at least 3 characters. The platform reserves the139 labels `Payment User Credential`, `Payment Card Credential`, `Payment Account140 Credential`, `PID Issuance` and `Photo ID Issuance`; pick another label.141- `version` is required. Its only value is `version_01` (OpenID4VCI 1.0), and142 you cannot change it after you create the definition.143- `cryptographicKeyFormat: "x509"` signs with the default key of the144 organisation and its X.509 certificate chain. Add145 `cryptographicKeyIdentifier` to sign with another key.146- `supportInteractiveAuthorisationEndpoint: true` lets the payment credential be147 presented during issuance, so the diploma follows in the same session (the148 dynamic credential request). Leave it off if you issue the diploma on its own.149- Keep the `id` the response returns. The issue operation matches the claims to150 this configuration by that id.151152Read `igrantio-api-issuer` for the issue operation (InTime, pre-authorised code,153and the dynamic credential request with transaction data), the revocation154operation, and the full request reference.155156## Cross-references157- `igrantio-api-issuer` - create credential definition, issue, and revoke.158- `igrantio-dcql-query-diploma` - the DCQL query that asks a holder for a diploma159 (the employer's qualification check).160- `igrantio-api-verifier` - transaction data and the dynamic credential request.161- `igrantio-ows-overview` - architecture and glossary.