light-mode-image
Learn
API ReferenceJSON

Verify a verifiable presentation

Roles

adminverifier

Analytics Events

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

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.

Analytic events

  • PRESENTATION_WEB_SEMANTIC_VERIFY_START
  • PRESENTATION_WEB_SEMANTIC_VERIFY_SUCCESS
  • PRESENTATION_WEB_SEMANTIC_VERIFY_FAIL

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

Presentation to verify

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v2/credentials/web-semantic/presentations/verify" \  -H "Content-Type: application/json" \  -d '{    "presentation": {      "@context": [        {}      ],      "type": [        {}      ],      "verifiableCredential": [        {          "@context": [            "string"          ],          "type": [            "string"          ],          "issuanceDate": "2019-08-24T14:15:22Z",          "credentialSubject": {},          "proof": {}        }      ],      "id": "string",      "holder": "string",      "proof": [        {          "type": "string",          "created": "string",          "challenge": "string",          "domain": "string",          "jws": "string",          "proofPurpose": "string",          "verificationMethod": "string"        }      ]    }  }'

{  "verified": true}

How would you rate this page?