WE BUILD Consortium Attestation Rulebook Explorer

EAASD-JWT VC

Attestation Rulebook for attestations of type Micro-credential

Category: non-qualified EAA

[Based on the WE BUILD Attestation Rulebook Template and the WE BUILD BU5 Micro-credentials Attestation Design.]

Version Date Description
0.2 2026-09-11 Restructured onto the generic WE BUILD attestation rulebook template (11 chapters). No normative content removed.
1.0 2026-10-20 Updated attributes and metadata and fixed index errors. Focus on mandatory attributes for 1.0.

Written against: ARF version 3.0.0, WE BUILD template version 1.0 (generic)

Feedback: GitHub issues, or contact Work Package 4 in WE BUILD.

1 Introduction

1.1 Document scope and purpose

This Rulebook defines the Micro-credential Attestation for use in the European Digital Identity Wallet ecosystem.

The Micro-credential Attestation expresses the real-world fact that a natural person has successfully completed a small, coherent volume of formally assessed learning, delivered under the quality assurance of an educational organisation, and has thereby acquired specific learning outcomes. It follows the definition set out in the Council Recommendation of 16 June 2022 on a European approach to micro-credentials for lifelong learning and employability (2022/C 243/02): a portable, learner-owned record of assessed learning outcomes from a small volume of study, which can be aligned to a curriculum, carries a notional workload, and is issued under institutional quality assurance.

The attestation is intended to be issued by an authentic source acting as a formal education provider, such as a higher education institution (HEI) or vocational education and training (VET) provider, or by an authorised academic identity provider acting on that provider's behalf. The Holder is the natural person who completed the assessed learning. Relying Parties are expected to include universities and other HEIs evaluating admission, credit recognition, or advanced standing; employers assessing skills for recruitment or onboarding; and other organisations that need to rely on verified evidence of formally taught knowledge, skills, and competences.

In practical terms, the attestation enables a learner to present proof of one or more completed micro-credentials through an EUDI Wallet, for example to demonstrate fulfilment of entry requirements or eligibility for recognition of credits when applying to a course or programme in another country. This supports cross-border and domestic academic mobility, provided that the relying party can verify the issuer, credential signature, validity, status where applicable, and the disclosed attributes needed for its decision.

The attestation supports use cases including university admission and enrolment, recognition of prior learning and credit transfer, professional onboarding, and other formally taught knowledge-dependent procedures, in both domestic and cross-border contexts.

1.2 Document structure

This Rulebook follows the generic WE BUILD attestation rulebook template. Chapter 2 states how it complies with the ARF and the applicable Regulations. Chapters 3 and 4 define the attributes and metadata in an encoding-independent manner. Chapter 5 states the formats in which this attestation is issued. Chapters 6 to 9 cover protocols, issuance, revocation and presentation. Chapter 10 sets out the trust framework, and chapter 11 lists references.

1.3 Key words

This document uses the capitalised key words 'SHALL', 'SHOULD' and 'MAY' as specified in [RFC 2119], to indicate requirements, recommendations and options.

In addition, 'must' (non-capitalised) indicates an external constraint, a requirement not mandated by this document but by an external document. The word 'can' indicates a capability. Other words such as 'will', 'is' and 'are' are statements of fact.

1.4 Terminology

This document uses the terminology specified in Annex 1 of the ARF.

In addition, the following domain-specific terms are used:

Term Meaning
Micro-credential Attestation A Verifiable Credential representing a person's completion of a small, coherent volume of formally assessed learning and the associated learning outcomes.
Learner The natural person to whom the completed learning outcomes apply; the Holder of the attestation.
Formal education provider A higher education institution (HEI), vocational education and training (VET) provider, or other organisation providing formally taught learning under institutional quality assurance.
Authorised academic identity provider A system or organisation authorised by a formal education provider to issue or manage micro-credential attestations on its behalf.
Learning outcome What a learner knows, understands, and is able to do on completion of a learning process, as assessed against transparent criteria.
ECTS European Credit Transfer and Accumulation System, used to express notional workload of learning.
EQF European Qualifications Framework, used to express the level of a qualification or learning outcome.
ESCO European Skills, Competences, Qualifications and Occupations classification.
ELM European Learning Model, a multilingual data model for representing learning opportunities, qualifications, and credentials.
Relying Party An organisation or system that verifies the Micro-credential Attestation to make an admission, credit-recognition, recruitment, or other eligibility decision.

2 Compliance

2.1 Compliance statement

This Rulebook complies with the applicable requirements of Topic 12, Attestation Rulebooks, in Annex 2 of the Architecture and Reference Framework, version 3.0.0. It uses the terminology of Annex 1 of the ARF.

This Rulebook is designed to align with the EUDI Wallet architectural approach for Electronic Attestations of Attributes and with the Attestation Rulebook structure defined in the ARF.

The Rulebook supports the following compliance objectives:

This Rulebook does not define a qualified EAA or public-sector EAA profile. It also does not define ISO/IEC 18013-5 mdoc or W3C VCDM encodings in this version, although the ELM/EDC JSON-LD-based representation is noted in Section 3.3 as a potential future basis for a W3C VCDM encoding.

This Rulebook does not define assurance or quality levels for the Micro-credential Attestation. Where a future version of this Rulebook introduces such levels, Chapters 3 and 4 SHALL be updated accordingly.

This Rulebook does not define transactional or payment-related data. Where a Micro-credential Attestation is used in a transaction involving payment, such requirements SHALL be defined in a separate payment attestation, payment profile, or transaction-specific rulebook.

2.2 Regulatory basis

This attestation is not a qualified electronic attestation of attributes. The data described in Annex V points b, c and e of Regulation (EU) 2024/1183 is addressed as required by EW-DM-12-018 and as recommended by EW-DM-12-020 and EW-DM-12-022. Where a recommendation is not followed, the reason is stated below.

2.3 Traceability

Every applicable requirement mapped to the section that satisfies it. Requirements marked not applicable carry a stated reason.

Requirement Legacy ID Applies Satisfied in section Note
EW-DM-12-001 ARB_01a yes 5 W3C VCDM is permitted for non-qualified EAA; not defined in this version
EW-DM-12-002 ARB_01b yes 5 SD-JWT VC following HAIP conventions
EW-DM-12-003 ARB_02 no Proximity presentation is not in scope, so mdoc is not required
EW-DM-12-005 ARB_04 no No W3C VCDM encoding is defined in this version
EW-DM-12-006 ARB_05 yes 5 vct https://webuildconsortium.eu/credentials/microcredential/1.0
EW-DM-12-007 ARB_06 yes 3 Attributes defined independently of encoding
EW-DM-12-008 ARB_06a no No mdoc encoding is defined in this version
EW-DM-12-009 ARB_06b yes 5 IANA-registered, public and private claim names
EW-DM-12-010 ARB_07 yes 3 Attributes aligned to the European Learning Model
EW-DM-12-012 ARB_09 yes 3, 4 Mandatory, optional and conditional stated per attribute
EW-DM-12-013 ARB_10 no No domestic namespace is defined
EW-DM-12-014 ARB_11 no Annex V and VII point a apply to QEAA and PuB-EAA
EW-DM-12-015 ARB_12 yes 4.1 EAA indication for a non-qualified EAA
EW-DM-12-016 / EW-DM-12-017 / EW-DM-12-018 ARB_13 / ARB_14 / ARB_15 yes 4.1, 4.2 Point b; EW-DM-12-018 applies to non-qualified EAA
EW-DM-12-019 / EW-DM-12-020 ARB_16 / ARB_17 yes 4.1 Point c; recommendation for non-qualified EAA
EW-DM-12-021 / EW-DM-12-022 ARB_18 / ARB_19 yes 4.2 Point e; recommendation for non-qualified EAA
EW-DM-12-023 / EW-DM-12-024 ARB_20 / ARB_21 yes 4.2, 10 trust_anchor metadata and the trust framework
EW-DM-12-029 ARB_25 yes 4.1 Legal category attribute; see the note recorded in section 4.1
EW-DM-12-030 ARB_26 yes 10 Trust anchor publication for non-qualified EAA
EW-DM-12-031 ARB_27 yes 4.3 cryptographically_bound_to where presented with PID
EW-DM-12-032 ARB_28 yes 4.2, 4.3 cryptographically_bound_to is defined as optional and conditional
EW-DM-12-034 ARB_30 yes 5 Selective disclosability stated per claim
EW-DM-12-035 ARB_31 no No Claim Selective Disclosure Metadata document is used
EW-DM-12-038 ARB_34 yes 7.1 Device binding

3 Attestation attributes

This chapter defines the attributes and metadata that a Micro-credential Attestation may contain. The attributes are defined in an encoding-independent manner. Each attribute is classified as mandatory, optional, or conditional.

The Micro-credential Attestation records a completed, formally assessed learning achievement. Unlike affiliation-based attestations, the underlying fact it attests does not lapse over time; any validity period defined in this Rulebook concerns the technical validity of the credential instance, not the continued truth of the achievement. The attribute set reflects the standard elements for describing micro-credentials set out in the Council Recommendation of 16 June 2022 (2022/C 243/02), as further specified by the European Learning Model (ELM) and the European Digital Credentials for Learning (EDC) application profile, and supports data minimisation by allowing a Holder to disclose only the attributes required for a specific transaction.

3.1 Introduction

The Micro-credential Attestation is defined as a non-qualified Electronic Attestation of Attributes unless a future version of this Rulebook explicitly defines a qualified or public-sector legal category.

The attribute attestation_legal_category SHALL be included and SHALL have the value non-qualified-EAA.

The attestation model consists of the following logical groups:

Note that, consistent with the European Learning Model, the organisation that seals/issues the credential (see issuerCountry) and the organisation that awarded the underlying learning achievement (see awardingBody) may or may not be the same organisation; one organisation may seal credentials on behalf of another.

The attestation is issued as a Verifiable Credential compatible with the EUDI Wallet using SD-JWT VC. The model aligns with the following issuer metadata parameters:

Note on schema artefacts. Section 3.1 of the generic template requires a machine-readable schema artefact for every format marked supported in chapter 5, versioned and immutably addressable. No such artefact exists yet for this attestation under data-schemas/. Adding one is follow-up work, tracked as a known gap rather than resolved here.

3.2 Mandatory attributes

Data Identifier Semantic Reference Definition Data type Example value
attestation_legal_category ARF Topic 12 / Rulebook legal category indication Indicates the legal category of the attestation. string non-qualified-EAA
identifier ELM credential.identifier Unique identifier of the micro-credential instance, assigned by the awarding body. string MC-2026-0007421
title ELM credential.displayParameter.title / Council Recommendation standard element 2 Title of the micro-credential. string Introduction to Applied Data Ethics
givenName ELM credential.credentialSubject.givenName / Council Recommendation standard element 1 Learner given name. string Elena
familyName ELM credential.credentialSubject.familyName / Council Recommendation standard element 1 Learner family name. string Kowalska
issuerCountry ELM credential.issuer.location.address.countryCode.prefLabel / Council Recommendation standard element 3 Country or region of the organisation that sealed/issued the credential. May differ from the awarding body's country. string [code list: country] http://publications.europa.eu/resource/authority/country/SWE
awardingBody ELM credential.credentialSubject.hasClaim[0].awardedBy.awardingBody[0].legalName / Council Recommendation standard element 4 Name of the formal education provider that awarded the micro-credential. object {"legalName":"Linköping University","legalIdentifier":"999852236"}
issuanceDate ELM credential.issued / Council Recommendation standard element 5 Date on which the credential was sealed and issued. Distinct from any validity start date. date (ISO 8601) 2026-06-15
learningOutcomes ELM credential.credentialSubject.hasClaim[0].specifiedBy.learningOutcome / Council Recommendation standard element 7 Description of the learning outcomes acquired by the learner. array of objects [{"title": "The title of the learning outcome", "description": "The actual learning outcome"}]
ECTS ELM credential.credentialSubject.hasClaim[0].specifiedBy.creditPoint[0].point / Council Recommendation standard element 8 ECTS float 3.0
volumeOfLearning ELM credential.credentialSubject.hasClaim[0].specifiedBy.volumeOfLeaning / Council Recommendation standard element 8. Used for non-formal learning. string (ISO 8601) 'PT8H'
typeOfAssessment ELM credential.credentialSubject.hasClaim[0].specifiedBy.provenBy[0].dcType / Council Recommendation standard element 9 Type of assessment used to validate the learning outcomes. array of strings [code list: typeOfAssessment] ["http://data.europa.eu/snb/assessment/6e6cb2cc78","http://data.europa.eu/snb/assessment/6a4db9f11d"]
formOfParticipation ELM credential.credentialSubject.hasClaim[0].specifiedBy.influencedBy[0].mode / Council Recommendation standard element 10 Form of participation in the learning activity. string [code list: formOfParticipation] http://data.europa.eu/snb/learning-assessment/920fbb3cbe
qualityAssurance ELM Accreditation dcType / Council Recommendation standard element 11 Type of quality assurance used to underpin the micro-credential. string institutional-accreditation

3.3 Optional attributes

Data Identifier Semantic Reference Definition Data type Example value
dateOfBirth ELM credential.credentialSubject.dateOfBirth Learner date of birth. date 1998-11-02
placeOfBirth ELM credential.credentialSubject.placeOfBirth.address[0].fullAddress.noteLiteral Learner place of birth. string Kraków, Poland
citizenshipCountry ELM credential.credentialSubject.citizenshipCountry.prefLabel Learner country of citizenship. string (ISO 3166-1 alpha-2) PL
nationalID ELM credential.credentialSubject.nationalID.notation National or other government-issued identifier of the learner. string issuer-defined
registeredAddress ELM credential.credentialSubject.location.address[0].fullAddress.noteLiteral Learner's registered or contact address. string issuer-defined
mail RFC 5322 mailbox / ELM credential.credentialSubject.contactPoint.emailAddress Learner email address. string elena.kowalska@example.edu
level ELM credential.credentialSubject.hasClaim[0].specifiedBy.eqfLevel.prefLabel Level of the learning outcomes, expressed against the EQF or an applicable national or sectoral framework, where applicable. string EQF-6
nationalQualificationsFrameworkLevel ELM credential.credentialSubject.hasClaim[0].specifiedBy.nqfLevel[0].prefLabel Level expressed against a national or regional qualifications framework, where used instead of or alongside the EQF. string issuer-defined
educationLevelDescriptor ELM credential.credentialSubject.hasClaim[0].specifiedBy.educationLevel Framework-independent descriptor of the learning experience level. string intermediate
learningOutcomeSummary ELM credential.credentialSubject.hasClaim[0].specifiedBy.learningOutcomeSummary Free-text collective description of the learning outcomes, complementing the structured learningOutcomes list. string Applies ethical reasoning to real-world data science scenarios.
fieldOfEducation ISCED-F 2013 Field of education or training classification code. string 0613
escoReference ELM credential.credentialSubject.hasClaim[0].specifiedBy.learningOutcome[0].relatedESCOSkill[0].prefLabel One or more references to the ESCO classification of the skill or competence attested. array of strings ["http://data.europa.eu/esco/skill/abc12345"]
learningActivityType ELM credential.credentialSubject.hasClaim[0].specifiedBy.influencedBy[0].dcType Categorisation of the learning activity, e.g. classroom coursework, e-learning, internship, volunteering. string e-learning
languageOfAssessment ELM / BCP 47 Language in which the assessment was conducted. string (BCP 47) en
idVerificationMethod ELM credential.credentialSubject.hasClaim[0].specifiedBy.provenBy[0].idVerification Method used to supervise the assessment and verify the identity of the learner during assessment. string proctored-online-exam
grade ELM credential.credentialSubject.hasClaim[0].provenBy[0].grade Grade or result obtained in the assessment, where the type of assessment produces one. string Pass
gradingScheme ELM Grading Scheme property Description of the grading scheme, enabling a third party to interpret the disclosed grade. string Pass/Fail
entryRequirements ELM credential.credentialSubject.hasClaim[0].specifiedBy.entryRequirement Prerequisites the learner needed to fulfil to enrol in the learning activity. array of strings ["Beginner-level Python programming"]
stackable ELM hasClaim[0].hasPart / isPartOf relationship indicator Indicates whether the micro-credential is designed to stack towards a larger qualification or award. boolean true
partOfQualification ELM isPartOf relationship indicator Identifier or title of the larger qualification or credential that this micro-credential can contribute towards. string BSc Data Science, Linköping University
accreditation ELM Accreditation class Structured accreditation details underpinning qualityAssurance: title, type, accrediting agent, decision, decision date, review date, and any field/jurisdiction/EQF-level limits on the accreditation's scope. object { "title": "Institutional Accreditation 2024", "type": "institutional-accreditation", "accreditingAgent": "Swedish Higher Education Authority", "decision": "approved", "decisionDate": "2024-01-15", "reviewDate": "2029-01-15" }
awardingBodyAddress ELM awardingBody[0].location[0].address[0].fullAddress.noteLiteral Registered or contact address of the awarding body. string issuer-defined
awardingBodyHomepage ELM awardingBody[0].homepage Homepage URL of the awarding body. string https://liu.se
awardingBodyIdentifier ELM awardingBody[0].identifier[0].notation Additional identifier(s) for the awarding body, e.g. a national registry or ROR identifier. string issuer-defined
additionalNote ELM additionalNote (generic) Free-text field for information not covered by another attribute in this Rulebook. string issuer-defined

3.4 Conditional attributes

Data Identifier Semantic Reference Definition Data type Example value
ECTS ELM credential.credentialSubject.hasClaim[0].specifiedBy.creditPoint[0].point SHALL NOT be included where volumeOfLearning if present. SHALL be included for formal learning. float 3.0
volumeOfLearning ELM credential.credentialSubject.hasClaim[0].specifiedBy.volumeOfLearning SHALL NOT be included where ECTS if present. SHALL be included for non-formal learning. string 'PT8H'
dateOfBirth ELM credential.credentialSubject.dateOfBirth SHALL be included only where needed for holder matching, or another justified relying-party purpose. If included, it SHALL represent the subject's birth date and SHALL NOT be in the future. date 1998-11-02
level ELM eqfLevel SHALL be included where the learning experience leading to the micro-credential can be positioned within the EQF or an applicable national or sectoral level framework; MAY be omitted where no such framework applies. string EQF-6
grade ELM provenBy[0].grade SHALL be included where typeOfAssessment produces a grade or result, and SHALL be omitted where the assessment is pass/fail-only without a graded outcome. Where grade is present, gradingScheme SHOULD also be included. string Pass
escoReference ELM relatedESCOSkill SHOULD be included where the attested learning outcomes can be mapped to one or more ESCO skills or competences. array of strings ["http://data.europa.eu/esco/skill/abc12345"]
stackable ELM hasPart / isPartOf SHOULD be included where the awarding body has defined a stacking pathway for this micro-credential towards a larger qualification. boolean true
partOfQualification ELM isPartOf SHOULD be included where stackable is true. string BSc Data Science, Linköping University

4 Metadata

Metadata describes the attestation rather than its subject.

4.1 Mandatory metadata

Data Identifier Semantic Reference Definition Data type Example value
vct SD-JWT VC Verifiable Credential Type identifying this attestation type. string https://webuildconsortium.eu/credentials/microcredential/1.0
iss SD-JWT VC / JWT Identifier of the issuer of the credential. string https://issuer.example-university.edu
iat JWT Time at which the credential was issued. integer 1781740800
cnf SD-JWT VC / JOSE Confirmation claim binding the credential to key material controlled by the Holder or Wallet Unit, where holder binding is used. object { "jwk": { ... } }

Legal category. This Rulebook states in section 3.1 that the attribute attestation_legal_category SHALL be included with the value non-qualified-EAA.

Open point for the quality assurance group. Section 4.1 of the generic template states that attestation_legal_category is superseded by the category attribute of [ETSI TS 119 472-1] and SHALL NOT be used, and that a non-qualified EAA carries category with the value eaa:eu:non-qualified. Unlike PID, a migration target does therefore exist for this attestation. The attribute has been left as the authors wrote it, because renaming it would also change the normative claim tables and the worked examples in chapter 5, which is an authoring decision rather than a restructuring one. Note also that EW-DM-12-029 (legacy ARB_25) of ARF v3.0.0 is a SHALL that still requires attestation_legal_category, so the template and the ARF currently disagree.

4.2 Optional metadata

Data Identifier Semantic Reference Definition Data type Example value
exp JWT Expiration time of the credential instance. Where present, this reflects the technical validity of the credential instance rather than the continued truth of the underlying achievement. integer 1970361600
nbf JWT Time before which the credential MUST NOT be accepted. integer 1781740800
jti JWT Unique identifier of the credential instance. string urn:uuid:9a3f6b2e-1c44-4b8a-9e21-6f0a2d7c5b31
status SD-JWT VC status mechanism, where used Status information enabling revocation or correction checks. object { "status_list": { ... } }
trust_anchor ARF Topic 12 Location or identifier of the machine-readable trust anchor or trust framework entry used to verify issuer authorisation. string https://trust.example.eu/education/institutions/example-university

4.3 Conditional metadata

Data Identifier Semantic Reference Definition Data type Example value
status SD-JWT VC status mechanism, where used SHOULD be present where the awarding body needs the ability to revoke or correct a Micro-credential Attestation after issuance, for example due to an issuance error or academic integrity finding. object { "status_list": { ... } }
cryptographically_bound_to ARF Topic 12 / ARB_28 MUST be present where the Micro-credential Attestation must be presented together with PID or another identity attestation for strong holder matching. string urn:eudi:pid:1

4.4 Code lists

Field name Allowed values Meaning Source / vocabulary Notes / extensibility
country Identifier from the item in the list A country https://op.europa.eu/en/web/eu-vocabularies/concept-scheme/-/resource?uri=http://publications.europa.eu/resource/authority/country —
typeOfAssessment Identifier from the item in the list Type of assessment used to validate learning outcomes. https://op.europa.eu/en/web/eu-vocabularies/concept-scheme/-/resource?uri=http://data.europa.eu/snb/assessment/25831c2 Issuers SHOULD reuse an existing value before introducing a new one.
formOfParticipation Mode in which the learner participated in the learning activity. https://op.europa.eu/en/web/eu-vocabularies/concept-scheme/-/resource?uri=http://data.europa.eu/snb/learning-assessment/25831c2 —
level EQF-1 through EQF-8 Level of the learning outcomes against the EQF. European Qualifications Framework (EQF) controlled vocabulary Where a national or sectoral framework is used instead, use nationalQualificationsFrameworkLevel and/or educationLevelDescriptor.
educationLevelDescriptor beginner, intermediate, advanced, issuer-defined Framework-independent level descriptor. Issuer-defined, informed by ELM —
notionalWorkload.unit ECTS, hours Unit in which the notional workload is expressed. ECTS (EQF Recommendation Annex V) / issuer-defined HEIs SHOULD use ECTS where possible; other providers MAY use hours or another documented unit.
learningActivityType classroom-coursework, e-learning, internship, volunteering, issuer-defined Category of learning activity. EU "Learning activity type" multilingual controlled vocabulary, or issuer-defined —
idVerificationMethod proctored-online-exam, in-person-supervision, identity-verified-remote-exam, issuer-defined Method used to supervise assessment and verify learner identity. EU "Method of supervision and verification" multilingual controlled vocabulary, or issuer-defined —
qualityAssurance / accreditation.type institutional-accreditation, programme-accreditation, national-quality-agency, sectoral-quality-assurance, issuer-defined Type of quality assurance underpinning the micro-credential. Issuer-defined, informed by ELM Accreditation class and DEQAR —
fieldOfEducation ISCED-F 2013 codes Field of education or training. ISCED-F 2013 —
attestation_legal_category non-qualified-EAA, QEAA, PuB-EAA Indicates the legal category of the attestation. ARF Topic 12 / Rulebook template This Rulebook uses non-qualified-EAA.

4.5 Integrity rules

Rule ID Rule statement Why it exists Where enforced Verifier / issuer behavior on failure
MC-IR-01 identifier, title, givenName, familyName, issuerCountry, awardingBody, issuanceDate, learningOutcomes, notionalWorkload, typeOfAssessment, formOfParticipation, and qualityAssurance SHALL be present. Ensures the credential contains all standard elements required by the Council Recommendation on micro-credentials. Issuer business rules, schema validation, verifier business validation. Issuer SHALL reject incomplete credential data. Verifier SHALL treat the attestation as invalid or insufficient if mandatory claims are missing.
MC-IR-02 If dateOfBirth is included, it SHALL represent the subject's birth date and SHALL NOT be in the future. Prevents invalid identity data and supports correct holder-matching checks. Issuer business rules and verifier business validation. Issuer SHALL reject invalid dates. Verifier SHALL reject or ignore an invalid dateOfBirth claim depending on the transaction.
MC-IR-03 issuanceDate SHALL NOT be in the future and SHALL NOT precede the completion of the assessment underlying the micro-credential. Ensures the awarded date reflects a genuinely completed and assessed learning activity. Issuer business rules. Issuer SHALL reject issuance where this cannot be confirmed.
MC-IR-04 If grade is present, typeOfAssessment SHALL indicate an assessment type capable of producing a graded outcome, and gradingScheme SHOULD also be present. Prevents inconsistent or uninterpretable grading information. Issuer business rules and verifier business validation. Issuer SHALL NOT include grade inconsistent with the assessment type. Verifier MAY disregard an inconsistent or unexplained grade claim.
MC-IR-05 If escoReference values are included, each SHALL resolve to a valid ESCO skill or competence URI. Ensures semantic interoperability of skill references. Issuer business rules and schema validation. Issuer SHOULD validate references before issuance. Verifier MAY ignore unresolvable references.
MC-IR-06 ECTS SHALL be a positive number, and ECTS SHALL NOT be used together with volumeOfLearning Ensures workload information is meaningful and consistently interpretable. Issuer business rules and schema validation. Issuer SHALL reject the credential if ECTS and volumeOfLearning both are present.
MC-IR-07 volumeOfLearning SHALL be a string in the ISO 8601 standard, and volumeOfLearning SHALL NOT be used together with ECTS Ensures workload information is meaningful and consistently interpretable. Issuer business rules and schema validation. Issuer SHALL reject the credential if ECTS and volumeOfLearning both are present.
MC-IR-08 If stackable is true, partOfQualification SHOULD be present. Ensures a stated stacking intent is backed by an identifiable target qualification. Issuer business rules. Issuer SHOULD include the target qualification. Verifier MAY treat an unsupported stackability claim with reduced confidence.
MC-IR-09 If accreditation is present, its type value SHALL be consistent with the top-level qualityAssurance value. Prevents contradictory quality-assurance information within a single credential. Issuer business rules and schema validation. Issuer SHALL ensure consistency before issuance. Verifier MAY disregard an internally inconsistent accreditation claim.
MC-IR-10 Selective disclosure SHALL allow the Holder to reveal only the attributes required for the transaction. Supports privacy and data minimisation. Issuer credential construction and Wallet presentation logic. Verifier SHALL request only necessary claims. Wallet SHOULD allow the Holder to review the disclosed claims.

5 Formats

Format Supported Identifier Specification Notes
ISO/IEC 18013-5 mdoc no [ISO/IEC 18013-5] Not defined in this version; see section 5.2
SD-JWT VC yes vct https://webuildconsortium.eu/credentials/microcredential/1.0 [SD-JWT VC], [HAIP] Follows SD-JWT VC and HAIP conventions
W3C VCDM no [W3C VCDM v2.0] Not defined in this version; see section 5.3

5.1 SD-JWT VC-based encoding

The Micro-credential Attestation SHALL be issued as an SD-JWT VC.

The Verifiable Credential Type (vct) for this attestation type is:

https://webuildconsortium.eu/credentials/microcredential/1.0

The credential claims defined in this section SHALL follow SD-JWT VC and HAIP conventions where applicable. Claim names are either IANA-registered JWT claims, public or reusable names, or private names specific to this attestation type.

For all claims, this Rulebook specifies whether an Attestation Provider MUST, MAY, or MUST NOT make the claim selectively disclosable.

5.1.1 IANA-registered and standard JWT / SD-JWT VC claims

Data Identifier Attribute identifier Encoding format Reference/Notes Disclosable
iss iss string JWT issuer identifier. MUST NOT
iat iat integer Issued-at timestamp. MUST NOT
nbf nbf integer Not-before timestamp, where used. MUST NOT
exp exp integer Expiration timestamp, where used. Reflects technical validity of the credential instance only. MUST NOT
jti jti string Unique credential instance identifier, where used. MUST NOT
cnf cnf object Holder binding confirmation claim, where used. MUST NOT
status status object Status or revocation information, where used. MUST NOT
vct vct string SD-JWT VC type. Value SHALL be https://webuildconsortium.eu/credentials/microcredential/1.0. MUST NOT

5.1.2 Public or reusable claims

Data Identifier Attribute identifier Encoding format Reference/Notes Disclosable
givenName givenName string Learner given name. ELM Person class property. MUST
familyName familyName string Learner family name. ELM Person class property. MUST
dateOfBirth dateOfBirth string Date of birth formatted as ISO 8601 date, where disclosed. MAY
mail mail string Email address, where disclosed. MAY

5.1.3 Private claims specific to the Micro-credential Attestation

Data Identifier Attribute identifier Encoding format Notes Disclosable
attestation_legal_category attestation_legal_category string SHALL be non-qualified-EAA. MUST NOT
identifier identifier string Unique identifier of the micro-credential instance. MUST
title title string Title of the micro-credential. MUST
issuerCountry issuerCountry string Country/region of the organisation that sealed/issued the credential. MUST
awardingBody awardingBody object Name and identifiers of the formal education provider that awarded the micro-credential. MUST
issuanceDate issuanceDate string Date on which the credential was sealed and issued, formatted as ISO 8601 date. MUST
learningOutcomes learningOutcomes array of objects Structured descriptions of the learning outcomes acquired by the learner. MUST
ECTS ECTS number ECTS workload, where applicable under Section 3.4. MUST/MUST NOT
volumeOfLearning volumeOfLearning string ISO 8601 duration for volume of learning, where applicable under Section 3.4. MUST NOT/MUST
typeOfAssessment typeOfAssessment array of strings Type or types of assessment used to validate the learning outcomes. MUST
formOfParticipation formOfParticipation string Form of participation in the learning activity. MUST
learningActivityType learningActivityType string Category of the learning activity, where disclosed. MAY
qualityAssurance qualityAssurance string Type of quality assurance underpinning the micro-credential. MUST
trust_anchor trust_anchor string Location or identifier of the trust anchor or trust framework entry, where used. MUST NOT
cryptographically_bound_to cryptographically_bound_to string Identifier of another attestation type to which this attestation is bound, where used. MUST NOT

5.1.4 Example minumum JWT claim set

{
  "iss": "https://issuer.example-university.edu",
  "iat": 1781740800,
  "vct": "https://webuildconsortium.eu/credentials/microcredential/1.0",
  "attestation_legal_category": "non-qualified-EAA",
  "identifier": "MC-2026-0007421",
  "title": "Introduction to Applied Data Ethics",
  "givenName": "Elena",
  "familyName": "Kowalska",
  "issuerCountry": "http://publications.europa.eu/resource/authority/country/SWE",
  "awardingBody": {
    "legalName": "Linköping University",
    "legalIdentifier": "999852236"
  },
  "issuanceDate": "2026-06-15",
  "learningOutcomes": [
    {
      "title": "The title of the learning outcome 1", 
      "description": "The actual learning outcome 1"
    },
    {
      "title": "The title of the learning outcome 2", 
      "description": "The actual learning outcome 2"
    }
  ],
  "ECTS": 3.0,
  "typeOfAssessment": [
    "http://data.europa.eu/snb/assessment/6a4db9f11d"
  ],
  "formOfParticipation": "http://data.europa.eu/snb/learning-assessment/920fbb3cbe",
  "qualityAssurance": "institutional-accreditation",
  "trust_anchor": "https://trust.example.eu/education/institutions/example-university",
  "cnf": {
    "jwk": {
      "kty": "EC",
      "crv": "P-256",
      "x": "...",
      "y": "..."
    }
  }
}

5.1.5 Example JWT claim set (not implemented yet)

{
  "iss": "https://issuer.example-university.edu",
  "iat": 1781740800,
  "nbf": 1781740800,
  "jti": "urn:uuid:9a3f6b2e-1c44-4b8a-9e21-6f0a2d7c5b31",
  "vct": "https://webuildconsortium.eu/credentials/microcredential/1.0",
  "attestation_legal_category": "non-qualified-EAA",
  "identifier": "MC-2026-0007421",
  "title": "Introduction to Applied Data Ethics",
  "givenName": "Elena",
  "familyName": "Kowalska",
  "issuerCountry": "http://publications.europa.eu/resource/authority/country/SWE",
  "awardingBody": {
    "legalName": "Linköping University",
    "legalIdentifier": "999852236"
  },
  "awardingBodyHomepage": "https://liu.se",
  "issuanceDate": "2026-06-15",
  "level": "EQF-6",
  "learningOutcomes": [
    {
      "title": "The title of the learning outcome 1", 
      "description": "The actual learning outcome 1"
    },
    {
      "title": "The title of the learning outcome 2", 
      "description": "The actual learning outcome 2"
    }
  ],
  "fieldOfEducation": "0613",
  "escoReference": [
    "http://data.europa.eu/esco/skill/abc12345"
  ],
  "ECTS": 3.0,
  "typeOfAssessment": [
    "http://data.europa.eu/snb/assessment/6a4db9f11d"
  ],
  "formOfParticipation": "http://data.europa.eu/snb/learning-assessment/920fbb3cbe",
  "grade": "Pass",
  "gradingScheme": "Pass/Fail",
  "qualityAssurance": "institutional-accreditation",
  "accreditation": {
    "title": "Institutional Accreditation 2024",
    "type": "institutional-accreditation",
    "accreditingAgent": "Swedish Higher Education Authority",
    "decision": "approved",
    "decisionDate": "2024-01-15",
    "reviewDate": "2029-01-15"
  },
  "stackable": true,
  "partOfQualification": "BSc Data Science, Linköping University",
  "trust_anchor": "https://trust.example.eu/education/institutions/example-university",
  "cnf": {
    "jwk": {
      "kty": "EC",
      "crv": "P-256",
      "x": "...",
      "y": "..."
    }
  }
}

5.1.6 Example issued SD-JWT

The following is a non-normative placeholder example. A production SD-JWT SHALL be generated by the issuer using the applicable signing algorithm, disclosure construction, holder binding, and SD-JWT VC rules.

<issuer-signed-sd-jwt>~<disclosure-1>~<disclosure-2>~<disclosure-n>~<holder-binding-jwt>

5.1.7 Example human-readable disclosed payload

A university admissions office requesting evidence of a completed prerequisite micro-credential for course entry may receive a presentation disclosing the following claims:

{
  "vct": "https://webuildconsortium.eu/credentials/microcredential/1.0",
  "identifier": "MC-2026-0007421",
  "title": "Introduction to Applied Data Ethics",
  "givenName": "Elena",
  "familyName": "Kowalska",
  "issuerCountry": "http://publications.europa.eu/resource/authority/country/SWE",
  "awardingBody": {
    "legalName": "Linköping University",
    "legalIdentifier": "999852236"
  },
  "learningOutcomes": [
    {
      "title": "The title of the learning outcome 1", 
      "description": "The actual learning outcome 1"
    },
    {
      "title": "The title of the learning outcome 2", 
      "description": "The actual learning outcome 2"
    }
  ],
  "ECTS": 3.0,
  "typeOfAssessment": [
    "http://data.europa.eu/snb/assessment/6a4db9f11d"
  ]
}

A verifier that only needs to confirm completion of the micro-credential SHOULD request the minimum claims necessary for that decision and SHOULD NOT request dateOfBirth, mail, nationalID, placeOfBirth, citizenshipCountry, or registeredAddress unless required for the transaction, for example strong holder matching.

The issuer identity, credential type, expiry time, signature, holder binding proof, and trust anchor information are not treated as selectively disclosable attributes and SHALL remain available to the verifier for technical validation.

5.2 ISO/IEC 18013-5-compliant encoding

This version of the Rulebook does not define an ISO/IEC 18013-5 mdoc encoding for the Micro-credential Attestation.

The Micro-credential Attestation defined in this Rulebook is specified for SD-JWT VC-based issuance and presentation. If a future version of this Rulebook defines an ISO/IEC 18013-5-compliant mdoc representation, that version SHALL define a unique document type, namespaces, attribute identifiers, CBOR encoding rules, and illustrative mdoc examples.

5.3 W3C Verifiable Credentials Data Model-based encoding

This version of the Rulebook does not define a W3C Verifiable Credentials Data Model encoding for the Micro-credential Attestation.

If a future version defines a W3C VCDM representation, that version SHALL define the credential context, type, credential subject structure, proof type, selective disclosure mechanism, and presentation requirements. Note that the European Learning Model's own JSON-LD-based encoding (as used by the European Digital Credentials for Learning infrastructure) is a W3C VCDM-compatible representation and MAY inform such a future encoding, subject to alignment with the EUDI Wallet's SD-JWT VC-based interoperability requirements.

6 Protocols

6.1 Issuance

The Micro-credential Attestation is issued using OpenID for Verifiable Credential Issuance [OpenID4VCI], with the issuer metadata parameters recorded in section 3.1, including scope MicroCredential and format vc+sd-jwt.

6.2 Presentation

The Micro-credential Attestation is presented using OpenID for Verifiable Presentations [OpenID4VP]. Only remote presentation is in scope, consistent with the formats recorded in chapter 5.

7 Issuance

7.1 Binding

Field Value Source
Device-bound MAY EW-DM-12-038
Cryptographically bound to attestation type or vct value, where used EW-DM-12-032
Relying Party must also verify a PID no EW-DM-12-031
Binding subject natural person The learner to whom the learning achievement relates

Holder binding is expressed through the cnf claim recorded in section 4.1, where it is used. Where the attestation must be presented together with PID or another identity attestation, cryptographically_bound_to is used as recorded in section 4.3.

7.2 Issuance Policy

The issuer SHOULD support revocation or suspension as described in chapter 8.

7.3 Lifecycle management

7.4 Embedded disclosure policy

This attestation defines no embedded disclosure policy.

8 Revocation

The Micro-credential Attestation records a completed, formally assessed learning achievement. Unlike affiliation-based attestations, the underlying fact it attests — that the learner achieved the stated learning outcomes — does not lapse over time and does not need to be periodically re-established. Consequently, revocation of a Micro-credential Attestation is not a mechanism for expressing that the achievement is "no longer valid" in a temporal sense, but a mechanism for correcting the record where the original issuance was defective or the credential instance itself needs to be withdrawn.

The credential expiration time (exp), where present, SHALL be understood as reflecting only the technical validity of the credential instance, for example to encourage periodic re-issuance onto current cryptographic material, and SHALL NOT be interpreted by a Relying Party as an indication that the underlying learning achievement itself has expired.

The issuer SHOULD support revocation or suspension of a Micro-credential Attestation where any of the following applies:

Revocation MAY be handled by one or more of the following mechanisms:

If a status or revocation mechanism is included in the credential, the Relying Party SHALL check the status before accepting the attestation, unless offline operating rules explicitly allow deferred status checking.

Because the Micro-credential Attestation is not time-bound in the same way as an affiliation-based attestation, the issuer SHOULD retain the ability to check and communicate status for as long as the credential can reasonably be expected to be presented, which may extend well beyond a single academic year or enrolment period.

Where a Micro-credential Attestation is revoked and superseded by a corrected version, the issuer SHOULD ensure that the identifier of the superseding credential allows a Relying Party, where necessary and with the Holder's cooperation, to establish the relationship to the revoked credential.

9 Presentation

9.1 Presentation Policy

To verify and validate a received presentation of an attestation of this type, the following steps SHALL be performed:

  1. verify the signature over the attestation using a trust anchor obtained as described in chapter 10;
  2. verify that the attestation is within its validity period;
  3. check revocation status as described in chapter 8, unless the attestation is short-lived; or remaining lifetime of the attestation is below revocation time threshold;
  4. verify device binding where section 7.1 records the attestation as device-bound;
  5. request only those attributes that are necessary for the stated purpose of the transaction, and, where the trust model for this attestation requires Relying Party registration, only those attributes it is registered and authorised to request.

Obligations specific to this attestation type, carried over from the attestation usage chapter of the previous version of this Rulebook:

The Micro-credential Attestation is intended for verifying that a natural person has completed a specific, formally assessed learning achievement and the associated learning outcomes.

Typical usage scenarios include:

Usage covers both:

A Relying Party receiving the attestation SHALL verify:

The Relying Party SHALL distinguish between verification of the attestation and evaluation of whether the attested learning outcomes are sufficient for its purpose. Successful cryptographic or technical verification alone SHALL NOT be treated as sufficient proof that the attested learning outcomes meet the Relying Party's acceptance criteria; the Relying Party SHALL evaluate the attested skill claim against its own defined criteria relevant to the intended use context, for example admission requirements or credit recognition rules.

The Relying Party SHOULD be able to interpret:

The Relying Party SHOULD request and verify a PID or another accepted identity credential where the transaction requires strong identity matching between the Holder and the attestation subject. For low-risk checks, the Relying Party MAY rely on the Micro-credential Attestation alone, provided that the issuer, signature, validity, status, and holder binding checks are successful and this is consistent with the relying party's policy.

The Relying Party SHALL apply data minimisation and SHALL request only the attributes required for the transaction. For example, a credit-recognition decision may only need title, awardingBody, level, learningOutcomes, and notionalWorkload, while an identity-sensitive enrolment process may additionally require givenName, familyName, and strong holder-binding verification via a PID.

The Relying Party SHOULD be able to evaluate the Micro-credential Attestation together with other supporting attestations where combined evidence is required, for example where several micro-credentials are presented to demonstrate cumulative fulfilment of entry requirements.

The Relying Party SHOULD define fallback handling for cases in which the attestation cannot be accepted, including rejection, request for additional evidence, deferred decision, or referral to an alternative process.

The attestation SHOULD be device-bound through holder binding where supported by the EUDI Wallet and the applicable SD-JWT VC profile. The attestation MAY be cryptographically bound to a PID or another accepted identity attestation where strong identity matching is required. Where this binding is used, the metadata attribute cryptographically_bound_to SHOULD contain:

urn:eudi:pid:1

No payment-specific transactional data is defined by this Rulebook. If the Micro-credential Attestation is used as part of a transaction that also involves payment, for example a paid enrolment or examination fee, payment-related requirements SHALL be defined in a separate payment attestation, payment profile, or transaction-specific rulebook; see [Topic 20] of Annex 2 of the ARF.

9.2 Presentation modes

Remote presentation is in scope. Proximity presentation is not in scope in this version, consistent with chapter 5, which records no mdoc encoding.

9.3 Transactional data

This Rulebook does not define transactional or payment-related data. Where a Micro-credential Attestation is used in a transaction involving payment, such requirements are out of scope of this version.

10 Trust Framework

Non-qualified EAA

The trust anchor is not obtained from a Trusted List of qualified trust service providers. A Relying Party obtains it as described in the deployment profile below, and verifies that the Provider is authorised to issue this attestation type by the same means.

A Wallet Unit MAY verify Provider authorisation using the mechanism described in ISSU_34 of Topic 10 of Annex 2 of the ARF.

Trust anchor location

The attribute or metadata carrying the trust anchor location contains at least the URL at which a machine-readable version can be found or looked up.

Coherence check: the attribute named here is trust_anchor, declared in section 4.2.

Deployment profile

A Relying Party SHALL verify that the issuer of the Micro-credential Attestation is authorised to issue this attestation type.

For non-qualified EAA deployments, the Relying Party SHOULD obtain trust anchor information through one or more of the following mechanisms:

Where the metadata attribute trust_anchor is present, it SHOULD identify the location or registry entry from which the Relying Party can obtain the issuer trust anchor or issuer authorisation information.

The Relying Party SHALL use the trust anchor to verify that:

Because the organisation that seals/issues the credential (issuerCountry) may differ from the organisation that awarded the underlying learning achievement (awardingBody), the Relying Party SHALL verify issuer trust based on the sealing organisation's trust anchor, and MAY additionally seek confirmation, for example through the accreditation information in Section 3.3 or through the trust framework entry, that the awarding body was itself entitled to award the micro-credential at the time of issuance.

Wallet Units MAY also use the same trust framework information during issuance to determine whether the provider is authorised to issue this attestation type.

11 References

Item Reference Standard name/details
[Council Recommendation on Micro-credentials] Council Recommendation of 16 June 2022 on a European approach to micro-credentials for lifelong learning and employability (2022/C 243/02). Available: https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex:32022H0627(02)
[DEQAR] Database of External Quality Assurance Results, used as a source controlled list for accreditation decisions in the European Learning Model.
[ELM] European Learning Model, a multilingual data model supporting the interoperable representation of learning opportunities, qualifications, accreditation, and credentials. Available: https://europa.eu/europass/elm-browser/index.html
[EQF Recommendation] Council Recommendation of 22 May 2017 on the European Qualifications Framework for lifelong learning (2017/C 189/03). Available: https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32017H0615(01)
[ESCO] European Skills, Competences, Qualifications and Occupations, the European multilingual classification of skills, competences, qualifications and occupations. Available: https://esco.ec.europa.eu/en/classification/skill_main
[EU Vocabularies] EU multilingual controlled vocabularies published via the EU Vocabularies concept scheme service, including Assessment Type, Mode of Learning and Assessment, Learning Activity Type, and Method of Supervision and Verification, as used by the European Learning Model. Available: https://op.europa.eu/en/web/eu-vocabularies
[European Digital Identity Regulation] Regulation (EU) 2024/1183 of the European Parliament and of the Council of 11 April 2024 amending Regulation (EU) No 910/2014 as regards establishing the European Digital Identity Framework
[HAIP] Yasuda, K. et al, OpenID4VC High Assurance Interoperability Profile, OpenID Foundation
[IANA-JWT-Claims] IANA JSON Web Token Claims Registry. Available: https://www.iana.org/assignments/jwt/jwt.xhtml
[ISCED-F 2013] International Standard Classification of Education, Fields of Education and Training 2013, UNESCO Institute for Statistics.
[ISO/IEC 18013-5] ISO/IEC 18013-5, Personal identification --- ISO-compliant driving licence - Part 5: Mobile driving licence application
[RFC 2119] RFC 2119 - Key words for use in RFCs to Indicate Requirement Levels, S. Bradner, March 1997
[RFC 3339] RFC 3339 - Date and Time on the Internet: Timestamps, G. Klyne et al., July 2002
[RFC 5322] RFC 5322 - Internet Message Format, P. Resnick, October 2008
[RFC 8610] RFC 8610 - Concise Data Definition Language (CDDL): A Notational Convention to Express Concise Binary Object Representation, H. Birkholz et al., June 2019
[RFC 8943] RFC 8943 - Concise Binary Object Representation (CBOR) Tags for Date, M. Jones et al., November 2020
[RFC 8949] RFC 8949 - Concise Binary Object Representation (CBOR), C. Bormann et al., December 2020
[SD-JWT VC] SD-JWT-based Verifiable Credentials. Available: https://datatracker.ietf.org/doc/draft-ietf-oauth-sd-jwt-vc/
[Topic 7] ARF Annex 2 - Topic 7 - Attestation revocation and revocation checking
[Topic 10] ARF Annex 2 - Topic 10 - Issuing a PID or attestation to a Wallet Unit
[Topic 12] ARF Annex 2 - Topic 12 - Attestation Rulebooks
[Topic 20] ARF Annex 2 - Strong User authentication for electronic payments
[W3C VCDM v2.0] Verifiable Credentials Data Model v2.0, W3C Recommendation