Credential Configurations

Edit online

The Credential Configurations API (/v1.0/diagency/credential_configurations) provides a streamlined way to create credential schemas and definitions. The read-only Credential Configuration Templates API (/v1.0/diagency/credential_configuration_templates) defines a set of predefined static schemas and definitions that you can use to accelerate creating a credential configuration, such as the ISO Mobile Driver’s License (mDL) template.

To create a credential configuration from a template, send the following request:

curl --location "https://${service_url}/v1.0/diagency/credential_configurations" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${issuer1_verifiable_credentials_access_token}" \
  --data '{
    "template_id": "org.iso.18013.5.1.mDL"
  }'

The following table lists all available credential configuration templates:

Template ID	Template Schema
org.iso.18013.5.1.mDL	ISO Mobile Driver’s License (mDL)
org.iso.18013.5.1.mDL.aamva	American Association of Motor Vehicle Administrators (AAMVA) compliant ISO Mobile Driver’s License (mDL)
eu.europa.ec.eudi.pid.1_mdoc	European Union Digital Identity Person Identification Data (EUDI PID) for mDoc
eu.europa.ec.eudi.pid.1_sdjwt	European Union Digital Identity Person Identification Data (EUDI PID) for SD-JWT
org.iso.23220.photoid.1	ISO/IEC TS 23220-2 compliant photo ID
org.iso.23220.1.jp.mnc	ISO/IEC TS 23220-2 compliant Japanese My Number Card (MNC)

After you create a credential configuration with a POST request (with or without a template), its state property is set to draft. In this state, you can update the configuration with PUT requests, including changes to the display, schema, and definitions properties.

When the configuration is complete, send a PUT request that sets the state to published. This action creates the credential schema and credential definition resources defined in the configuration. The response includes the IDs of the created resources in the created_schema_id and created_definition_ids fields.

For more information on the Credential Configurations and Credential Configuration Templates APIs, see API Specification.