MATTR VII PlatformIssuance
Issue a verifiable credential
Issues a credential to a holder upon presentation of a valid access token, as per OpenID4VCI.
The valid access token must be provided in the following header format: Authorization: Bearer <access_token>
.
Analytics Events
OPENID_CREDENTIAL_STARTOPENID_CREDENTIAL_SUCCESSOPENID_CREDENTIAL_FAIL
POST
/v1/openid/credential
AuthorizationBearer <token>
In: header
formatstring
Credential format, always ldp_vc
for JSON credentials.
Value in
"ldp_vc"
credential_definitionobject
proof?object
JSON object containing proof of possession of the key material the issued Credential shall be bound to.
formatstring
Credential format, always cwt
for CWT credentials.
Value in
"cwt"
typestring
formatstring
Credential format, always cwt_vc
for Semantic CWT credentials.
Value in
"cwt_vc"
typesarray<string>
formatstring
Credential format, always mso_mdoc
for mDocs.
Value in
"mso_mdoc"
doctypestring
The document type identifier for the credential, as defined in ISO/IEC 18013-5:2021.
proof?object
JSON object containing proof of possession of the key material the issued credential shall be bound to.
Response Body
curl -X POST "https://example.vii.au01.mattr.global/v1/openid/credential" \ -H "Content-Type: application/json" \ -d '{ "format": "ldp_vc", "credential_definition": { "type": [ "VerifiableCredential", "AlumniCredential" ], "@context": [ "https://www.w3.org/2018/credentials/v1" ] }, "proof": { "proof_type": "jwt", "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." } }'
{
"credential": {
"@context": [
"https://www.w3.org/2018/credentials/v1",
"https://www.w3.org/2018/credentials/examples/v1"
],
"type": [
"VerifiableCredential",
"AlumniCredential"
],
"issuer": {
"id": "did:web:organization.com",
"name": "Example University",
"logoUrl": "https://example.edu/img/logo.png",
"iconUrl": "https://example.edu/img/icon.png"
},
"credentialBranding": {
"backgroundColor": "#B00AA0",
"watermarkImageUrl": "https://example.edu/img/watermark.png"
},
"issuanceDate": "2020-05-02T12:06:29.156Z",
"credentialStatus": {
"id": "https://tenant.vii.mattr.global/v1/revocation-lists/cc641396-3750-43c8-b8b8-f30d74eb3fb3#1",
"type": "RevocationList2020Status",
"revocationListIndex": 1,
"revocationListCredential": "https://tenant.vii.mattr.global/v1/revocation-lists/cc641396-3750-43c8-b8b8-f30d74eb3fb3"
},
"credentialSubject": {
"givenName": "Jamie",
"familyName": "Doe",
"alumniOf": "Example University"
},
"proof": {
"type": "Ed25519Signature2018",
"created": "2020-05-02T12:06:29Z",
"jws": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
"proofPurpose": "assertionMethod",
"verificationMethod": "did:web:organization.com"
},
"name": "Alumni Credential",
"description": "This credential shows that the person has attended the mentioned university."
},
"format": "ldp_vc"
}
How would you rate this page?