EU PID Credential

Use data provided by EU Wallets as a W3C VC, SD-JWT (prior to ARF 1.8.0), or ISO 18013-5 credential, with the help of VC-K.

Be sure to call at.asitplus.wallet.eupid.Initializer.initWithVCK() first thing in your application.

See PID Rulebook from 2025-10-02 for a list of attributes.

These are implemented for ISO:

• family_name
• given_name
• birth_date
• family_name_birth
• given_name_birth
• place_of_birth
• resident_address
• resident_country
• resident_state
• resident_city
• resident_postal_code
• resident_street
• resident_house_number
• sex
• nationality
• issuance_date
• expiry_date
• issuing_authority
• document_number
• issuing_country
• issuing_jurisdiction
• personal_administrative_number
• portrait
• email_address
• mobile_phone_number
• trust_anchor
• location_status

These attributes are removed from the spec, but kept for backwards compatibility with our implementations:

• age_over_12
• age_over_13
• age_over_14
• age_over_16
• age_over_18
• age_over_21
• age_over_25
• age_over_60
• age_over_62
• age_over_65
• age_over_68
• age_in_years
• age_birth_year
• birth_place
• birth_country
• birth_state
• birth_city
• administrative_number
• portrait_capture_date

Changelog

Release 3.3.0:

• VC-K 5.9.0
• Kotlin 2.2.21
• Deprecate age attributes removed from the latest PID rulebook on 2025-10-02
• Remove SD-JWT attribute names

Release 3.2.0:

• VC-K 5.8.0
• Kotlin 2.2.0
• kotlinx-datetime 0.7.1

Release 3.1.0:

• Update to VC-K 5.7.0
• expiry_date and issuance_date are of type LocalDateOrInstant from vc-k acc. to spec "Date (and if possible time) ..."

Release 3.0.1:

• Deprecate SD-JWT claim name mapping introduced in 2.3.0, please migrate to at.asitplus.wallet:eupidcredential-sdjwt, see https://github.com/a-sit-plus/eu-pid-credential-sdjwt/
• Add additional claims age_over_13, age_over_25, age_over_60, age_over_62, age_over_65, age_over_68, portrait_capture_date

Release 3.0.0:

• Update to ARF 1.5.0, deprecating removed claims, adding new claims, changing nationality from single element to collection

Release 2.3.2:

• VC-K 5.3.0

Release 2.3.1:

• Add additional claims personal_administrative_number and portrait (acc. to Implementing Act)

Release 2.3.0:

• Implement mapping to SD-JWT claim names according to eu-digital-identity-wallet/eudi-doc-architecture-and-reference-framework#160

Release 2.2.3:

• VC-K 5.2.2
• Add additional claims: age_over_12, age_over_14, age_over_16, age_over_21

Release 2.2.2:

• VC-K 5.2.1
• Kotlin 2.1.0

Release 2.2.1:

• Fix serialization in ISO format

Release 2.2.0:

• Update to VC-K 5.0.0

Release 2.1.3:

• Update to VC-K 4.1.0

Release 2.1.2:

• Update to vclib 4.0.0

Release 2.1.1:

• Fix required claim names in EuPidScheme to contain age_over_18 and issuing_country

Release 2.1.0:

• Update to vclib 3.8.0
• Use correct namespace, doc type and SD-JWT type

Release 2.0.2:

• Update to vclib 3.7.0
• Koltin 2.0.0

Release 2.0.1:

• Fix publishing, re-releasing 2.0.0

Release 2.0.0:

• Implement metadata, based on PID Rule Book 1.0.0 from November 2023

Release 1.0.0:

• Initial release, based on PID Rule Book 1.0.0 from November 2023

---

The Apache License does not apply to the logos, (including the A-SIT logo and the VC-K logo) and the project/module name(s) (even those used only in badges), as these are the sole property of A-SIT/A-SIT Plus GmbH and may not be used in derivative works without explicit permission!