Verify a verifiable presentation

Verifies a provided verifiable presentation that adheres to the W3C Verifiable Credential Data Model:

Ensures the presentation conforms to the VC Data model.
For each verifiableCredential objects:
- Issuer DID can be resolved.
- JSON-LD context is valid for subject claims.
- Proof is valid & the credential has not been tampered with.
- Is not in a revoked status on a RevocationList2020.
- The proof is valid for each subjectDID to prove ownership.
- Valid proof exists for the presentation holderDID.

The request must include a presentation object that adheres to the W3C Verifiable Credential Data Model.

If a challenge and/or domain is provided they are used for credential verification. Otherwise, the challenge and/or domain within the presentation proof is used instead.

Analytics Events

PRESENTATION_WEB_SEMANTIC_VERIFY_STARTPRESENTATION_WEB_SEMANTIC_VERIFY_SUCCESSPRESENTATION_WEB_SEMANTIC_VERIFY_FAIL

Roles

adminverifier

POST/v2/credentials/web-semantic/presentations/verify

Authorization

AuthorizationBearer <token>

In: header

Request Body

Presentation to verify

presentationobject

challenge?string

domain?string

Response Body

curl -X POST "https://example.vii.au01.mattr.global/v2/credentials/web-semantic/presentations/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "presentation": {
      "@context": [
        {}
      ],
      "type": [
        {}
      ],
      "verifiableCredential": [
        {
          "@context": [
            "https://www.w3.org/2018/credentials/v1",
            "https://www.w3.org/2018/credentials/examples/v1"
          ],
          "type": [
            "VerifiableCredential",
            "AlumniCredential"
          ],
          "issuanceDate": "2020-05-02T12:06:29.156Z",
          "credentialSubject": {
            "givenName": "Jamie",
            "familyName": "Doe",
            "alumniOf": "Example University"
          },
          "proof": {}
        }
      ],
      "id": "string",
      "holder": "string",
      "proof": [
        {
          "type": "string",
          "created": "string",
          "challenge": "string",
          "domain": "string",
          "jws": "string",
          "proofPurpose": "string",
          "verificationMethod": "string"
        }
      ]
    }
  }'

curl -X POST "https://example.vii.au01.mattr.global/v2/credentials/web-semantic/presentations/verify" \  -H "Content-Type: application/json" \  -d '{    "presentation": {      "@context": [        {}      ],      "type": [        {}      ],      "verifiableCredential": [        {          "@context": [            "https://www.w3.org/2018/credentials/v1",            "https://www.w3.org/2018/credentials/examples/v1"          ],          "type": [            "VerifiableCredential",            "AlumniCredential"          ],          "issuanceDate": "2020-05-02T12:06:29.156Z",          "credentialSubject": {            "givenName": "Jamie",            "familyName": "Doe",            "alumniOf": "Example University"          },          "proof": {}        }      ],      "id": "string",      "holder": "string",      "proof": [        {          "type": "string",          "created": "string",          "challenge": "string",          "domain": "string",          "jws": "string",          "proofPurpose": "string",          "verificationMethod": "string"        }      ]    }  }'

{
  "verified": true
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}