DCQL: Issue the Test Credentials
Each DCQL example asks a holder wallet for credentials that it already holds. This page creates the credential definitions and issues the test credentials that the examples use, so that you only need to do it once. You only need the credentials of the examples that you want to run:
Step 1: Get the API Key (Issuer Admin)
To obtain your API key, sign in to the dashboard and go to Account > Developer APIs > Create API Key (see Get API Keys). Once you have your API key, enter it in the field below and click the Set API Key button to save it for future use.
x509 key of your organisation: a key with a certificate chain. After you set the API key, the page fills in such a key. To choose another key, click the key label next to a signing key field in a request, for example cryptographicKeyIdentifier. To create a key, attach a certificate or see your keys, follow the key management guide. To add your certificate to the NXD trust list, see trust list registration.Step 2: Create the Credential Definitions and Issue the Credentials (Issuer/Holder)
Each section below has two requests. The first creates the credential definition: run it with the Run button, or copy the JSON and use it in the body of the API request available here. With cryptographicKeyFormat x509, the cryptographicKeyIdentifier must be a key of your organisation that has a certificate chain; the page fills in such a key after you set the API key, and Select key on the request lets you choose another one (see the key management guide).
The second request issues the credential in the in_time mode. When you run the first request, the credentialDefinitionId field and the credentialConfigurationId field of the credentials entry are autofilled in the second request automatically (and updated whenever the first request is re-run). If you are executing the APIs yourself, replace <credentialDefinitionId> and <credentialConfigurationId> with the values from the first response. Alternatively, you may use the API available here.
After receiving the response, toggle the button provided to dynamically generate a QR code. The EUDI Wallet/Holder can then accept the credential offer using the Data Wallet (or any other EU Digital Identity Wallet) by either scanning the QR code or directly accessing the credential offer on their mobile device (e.g. via a browser).
To receive and accept the credential in your organisation wallet through the API instead, first send the offer.uri from the response as credentialOffer to the Receive Credential API. Once you have the response, copy the credentialId and provide it at Accept Credential API to accept the credential.
Age Verification Attestation (mdoc)
The EU age verification attestation (doctype eu.europa.ec.av.1, see Age Verification) carries age_over_NN claims, so that a holder can prove an age threshold without disclosing a date of birth. age_over_18 is mandatory and the other age_over_NN claims are optional. Used by Claim Sets (Selective Disclosure).
Request
Response
Request
Response
PID (SD-JWT VC)
Person Identification Data (PID) is a standardized European identity credential defined under the EU Digital Identity Framework (eIDAS 2.0). It contains essential personal information including family name, given name, date of birth, and address, enabling secure digital identification across EU member states.
This PID uses the credential format dc+sd-jwt and includes a residential address. Used by Credential Sets (Alternatives) and Values Constraint.
Request
Response
Request
Response
PID (mdoc)
Person Identification Data (PID) is a standardised European identity credential defined under the EU Digital Identity Framework (eIDAS 2.0). It contains essential personal information including family name, given name, date of birth and address, enabling secure digital identification across EU member states.
This PID uses the credential format mso_mdoc. Used by Mandatory and Optional Sets.
Request
Response
Request
Response
Passport
The Passport credential is a digital representation of a physical passport, issued according to the EU Digital Travel Credential (DTC) specifications and International Civil Aviation Organization (ICAO) standards. As part of the EU Digital Identity framework, it allows holders to use their digital identity for secure border crossings and online identification by extracting verifiable data from the electronic Machine-Readable Travel Document (eMRTD).
Used by Credential Sets (Alternatives).
Request
Response
Request
Response
Photo ID
Photo ID is based on an electronic Machine-Readable Travel Document (eMRTD), is issued and verified as a digital credential under the EU Digital Travel Credential (DTC) framework and the EU Digital Identity Framework (eIDAS Regulation). For more technical details, please refer to EWC RFC 013: Issue Photo ID.
Used by Credential Sets (Alternatives) and Combined Credential Sets.
Request
Response
Request
Response
Bank Statement (KYC)
A Bank Statement credential provides verified financial information including account details, transaction history, and balance information. It serves as a proof of financial stability and is commonly used for KYC (Know Your Customer) verification processes in accordance with European Anti-Money Laundering directives.
This Bank Statement includes the address of the account holder. Used by Combined Credential Sets.
Request
Response
Request
Response
Bank Statement (Loan Application)
A Bank Statement credential provides verified financial information including account details, transaction history and balance information. It serves as a proof of financial stability and is commonly required for loan applications and financial assessments in accordance with European banking regulations and Anti-Money Laundering directives.
This Bank Statement includes the statement period. Used by Multiple Credential Instances.
Request
Response
Note: The loan application example asks for several recent bank statements. After the first request autofills the IDs, run the issue request below once for each bank statement, updating the claims as needed, and accept each credential in the holder wallet.
Request
Response
Utility Bill
A Utility Bill credential contains verified address information from utility service providers such as electricity, water or telecommunications companies. It serves as proof of residence and is commonly required for address verification in accordance with EU identity verification standards.
Used by Combined Credential Sets and Mandatory and Optional Sets.
Request
Response
Request
Response
Student ID
A Student ID credential is an official digital identification document issued by European educational institutions. It contains student information including enrolment status, student number and academic details in accordance with the European Student Card Initiative standards, providing proof of student status for various services and benefits across the European Higher Education Area.
Used by Mandatory and Optional Sets.
Request
Response
Request
Response
Enrolment Letter
An Enrolment Letter credential is an official document from a European educational institution confirming a student's enrolment in a specific program. It includes details such as the program of study, enrolment dates and academic standing, serving as a proof of current student status in compliance with European higher education standards.
Used by Mandatory and Optional Sets.
Request
Response
Request
Response
Rental Agreement
A Rental Agreement credential is a digital version of a legally binding contract between a landlord and tenant, compliant with European housing policies. It contains verified information about the rental property, terms of lease, and tenant details, serving as proof of residence for official purposes across EU member states.
Used by Mandatory and Optional Sets.
Request
Response
Request
Response
University Degrees
The Trusted Authorities example uses three University Degree credentials from two universities. Its query matches a credential only when the certificate chain of the issuer's signing key leads to a CA on the EWC trusted list. All three definitions below sign with a key of your organisation, so to see a match, sign the Aegean definitions with a key whose certificate chain is on the list. A key that is not on the list, as for ABC University, never matches.
Aegean University Degree - Master's
The credential definition for a Master's degree from the University of the Aegean, with the key format x509.
Request
Response
Request
Response
Aegean University Degree - Bachelor's
The credential definition for a Bachelor's degree from the University of the Aegean, with the key format x509.
Request
Response
Request
Response
ABC University Degree - Bachelor's
The credential definition for a Bachelor's degree from ABC University, Australia.