Diploma qualification check - DCQL query
When to use
Use this skill when an employer, or any relying party, verifies a person's
education qualification. The request asks for two credentials in one exchange:
- the PID for the applicant's identity (given name, family name, email), and
- the National Diploma (
urn:education:diploma:1) for the qualification
(learner name, qualification, code, awarding institution, award date).
The wallet discloses only these fields and nothing else. In the showcase this is
the CivicWorks Careers "Apply with your wallet" step. It carries no transaction
data.
Prerequisites
- An iGrant.io Organisation Wallet Suite (OWS) API key for the verifying
organisation (the employer sandbox in the showcase). Server-side only.
- The OWS environment the key belongs to (default demo,
https://demo-api.igrant.io).
- An x509 verifier certificate registered on a trust list (the showcase uses
NXD WRPAC), so the wallet trusts the request. See
https://docs.igrant.io/docs/trust-relying-party-registration/.
- The diploma credential type must exist as a credential definition first - see
igrantio-credential-schema-diploma.
Ask the integrator first
- Environment - demo or staging? Default demo.
- API key - the OWS API key for the verifying organisation.
- Label - a unique presentation definition label (at least 3 characters),
for example
Diploma qualification check.
- Signing key (
cryptographicKeyIdentifier) - the X.509 verifier key and
its certificate on the trust list. Default: the default key of the
organisation.
- Fields - the identity and diploma claims to request. Default: the five
diploma fields below plus three PID fields; ask for no more than you need.
The DCQL query
Two credential queries, one PID and one diploma, in a single request.
{
"credentials": [
{
"id": "pid",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:eu.europa.ec.eudi:pid:1"] },
"claims": [
{ "path": ["given_name"] },
{ "path": ["family_name"] },
{ "path": ["email"] }
]
},
{
"id": "diploma",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:education:diploma:1"] },
"claims": [
{ "path": ["learnerName"] },
{ "path": ["qualificationName"] },
{ "path": ["qualificationCode"] },
{ "path": ["awardingInstitution"] },
{ "path": ["awardDate"] }
]
}
]
}
Use with the iGrant.io API
Create the presentation definition with
POST /v2/config/digital-wallet/openid/sdjwt/presentation-definition, then send
it at request time with the V3 verification send operation
(POST /v3/config/digital-wallet/openid/sdjwt/verification/send with
{ presentationDefinitionId, requestByReference: true }).
{
"label": "Diploma qualification check",
"version": "version_01",
"responseType": "vp_token",
"responseMode": "direct_post",
"clientIdScheme": "x509_hash",
"cryptographicKeyFormat": "x509",
"dcqlQuery": {
"credentials": [
{
"id": "pid",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:eu.europa.ec.eudi:pid:1"] },
"claims": [
{ "path": ["given_name"] },
{ "path": ["family_name"] },
{ "path": ["email"] }
]
},
{
"id": "diploma",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:education:diploma:1"] },
"claims": [
{ "path": ["learnerName"] },
{ "path": ["qualificationName"] },
{ "path": ["qualificationCode"] },
{ "path": ["awardingInstitution"] },
{ "path": ["awardDate"] }
]
}
]
}
}
Notes on the request.
label must be unique and at least 3 characters. Pick a fresh label so you do
not collide with an existing presentation definition.
version is required. Use version_01 (OpenID4VP 1.0).
- Both queries are required by default, so the wallet must hold both a PID and a
diploma. Read the verification result with
GET /v3/config/digital-wallet/openid/sdjwt/verification/history/{presentationExchangeId}.
clientIdScheme: "x509_hash" and cryptographicKeyFormat: "x509" sign the
request with the verifier certificate, so the wallet shows the request as
trusted.
Read igrantio-api-verifier for the full DCQL reference (claim sets, credential
sets, trusted authorities, transaction data) and the send and history
operations.
Cross-references
igrantio-credential-schema-diploma - the diploma credential definition this
query reads.
igrantio-dcql-query-pid - the PID query on its own (the learner sign-in).
igrantio-api-verifier - create presentation definition, send, and read
history.
igrantio-ows-overview - architecture and glossary.
1---2name: igrantio-dcql-query-diploma3description: 'DCQL query for the diploma qualification check used by the ITU / GovStack Education Wallet showcase. One OpenID4VP presentation definition that asks a job applicant for a Person Identification Data (PID) credential (given name, family name, email) and the National Diploma credential (vct urn:education:diploma:1: learner name, qualification, qualification code, awarding institution and award date). Use this skill when an employer or relying party verifies an education qualification with selective disclosure.'4license: Apache-2.05metadata:6 source: https://skillmd.com/skills/l3-igrant/igrantio-dcql-query-diploma7 categories: [dcql-query, education]8 provider: iGrant.io9 keywords: DCQL, presentation definition, OpenID4VP, diploma, qualification check, employer, selective disclosure, PID, National Learner Registry, EUDIW, GovStack, ITU10 version: 2026.10.0111 source-doc: https://giga-staging.igrant.io/knowledgebase/showcase-credentials12 requires-skills: igrantio-api-verifier13---1415# Diploma qualification check - DCQL query1617## When to use18Use this skill when an **employer**, or any relying party, verifies a person's19education qualification. The request asks for two credentials in one exchange:2021- the **PID** for the applicant's identity (given name, family name, email), and22- the **National Diploma** (`urn:education:diploma:1`) for the qualification23 (learner name, qualification, code, awarding institution, award date).2425The wallet discloses only these fields and nothing else. In the showcase this is26the CivicWorks Careers "Apply with your wallet" step. It carries no transaction27data.2829## Prerequisites30- An **iGrant.io Organisation Wallet Suite (OWS) API key** for the verifying31 organisation (the employer sandbox in the showcase). Server-side only.32- The **OWS environment** the key belongs to (default demo,33 `https://demo-api.igrant.io`).34- An **x509 verifier certificate** registered on a trust list (the showcase uses35 NXD WRPAC), so the wallet trusts the request. See36 <https://docs.igrant.io/docs/trust-relying-party-registration/>.37- The diploma credential type must exist as a credential definition first - see38 `igrantio-credential-schema-diploma`.3940## Ask the integrator first411. **Environment** - demo or staging? _Default demo._422. **API key** - the OWS API key for the verifying organisation.433. **Label** - a unique presentation definition label (at least 3 characters),44 for example `Diploma qualification check`.454. **Signing key (`cryptographicKeyIdentifier`)** - the X.509 verifier key and46 its certificate on the trust list. _Default: the default key of the47 organisation._485. **Fields** - the identity and diploma claims to request. _Default: the five49 diploma fields below plus three PID fields; ask for no more than you need._5051## The DCQL query52Two credential queries, one PID and one diploma, in a single request.5354```json55{56 "credentials": [57 {58 "id": "pid",59 "format": "dc+sd-jwt",60 "meta": { "vct_values": ["urn:eu.europa.ec.eudi:pid:1"] },61 "claims": [62 { "path": ["given_name"] },63 { "path": ["family_name"] },64 { "path": ["email"] }65 ]66 },67 {68 "id": "diploma",69 "format": "dc+sd-jwt",70 "meta": { "vct_values": ["urn:education:diploma:1"] },71 "claims": [72 { "path": ["learnerName"] },73 { "path": ["qualificationName"] },74 { "path": ["qualificationCode"] },75 { "path": ["awardingInstitution"] },76 { "path": ["awardDate"] }77 ]78 }79 ]80}81```8283## Use with the iGrant.io API84Create the presentation definition with85`POST /v2/config/digital-wallet/openid/sdjwt/presentation-definition`, then send86it at request time with the V3 verification `send` operation87(`POST /v3/config/digital-wallet/openid/sdjwt/verification/send` with88`{ presentationDefinitionId, requestByReference: true }`).8990```json91{92 "label": "Diploma qualification check",93 "version": "version_01",94 "responseType": "vp_token",95 "responseMode": "direct_post",96 "clientIdScheme": "x509_hash",97 "cryptographicKeyFormat": "x509",98 "dcqlQuery": {99 "credentials": [100 {101 "id": "pid",102 "format": "dc+sd-jwt",103 "meta": { "vct_values": ["urn:eu.europa.ec.eudi:pid:1"] },104 "claims": [105 { "path": ["given_name"] },106 { "path": ["family_name"] },107 { "path": ["email"] }108 ]109 },110 {111 "id": "diploma",112 "format": "dc+sd-jwt",113 "meta": { "vct_values": ["urn:education:diploma:1"] },114 "claims": [115 { "path": ["learnerName"] },116 { "path": ["qualificationName"] },117 { "path": ["qualificationCode"] },118 { "path": ["awardingInstitution"] },119 { "path": ["awardDate"] }120 ]121 }122 ]123 }124}125```126127Notes on the request.128129- `label` must be unique and at least 3 characters. Pick a fresh label so you do130 not collide with an existing presentation definition.131- `version` is required. Use `version_01` (OpenID4VP 1.0).132- Both queries are required by default, so the wallet must hold both a PID and a133 diploma. Read the verification result with134 `GET /v3/config/digital-wallet/openid/sdjwt/verification/history/{presentationExchangeId}`.135- `clientIdScheme: "x509_hash"` and `cryptographicKeyFormat: "x509"` sign the136 request with the verifier certificate, so the wallet shows the request as137 trusted.138139Read `igrantio-api-verifier` for the full DCQL reference (claim sets, credential140sets, trusted authorities, transaction data) and the send and history141operations.142143## Cross-references144- `igrantio-credential-schema-diploma` - the diploma credential definition this145 query reads.146- `igrantio-dcql-query-pid` - the PID query on its own (the learner sign-in).147- `igrantio-api-verifier` - create presentation definition, send, and read148 history.149- `igrantio-ows-overview` - architecture and glossary.