Skip to main content

Validate a Verifiable Presentation

Validates the Verifiable Presentation. This means that the signature, the format and the validity (expiration and revocation status) are valid in the presentation and the credential within. Notice that the object provided in the example will be provided to you through callbackurl. As an entity acting as issuer or verifier, you will not generate this object since it is signed by the holder.

Request Body — REQUIRED

W3C Verifiable Presentation

@context string[] — REQUIRED

An ordered set where the first item is a URI https://www.w3.org/2018/credentials/v1. It is used to define terms and help to express specific identifiers in a compact manner.

type string[] — REQUIRED

Type of the object or the datatype of the typed value.

verifiableCredential — REQUIRED

VerifiableCredential is composed of one or more verifiable credentials presented.

holder uri

URI of the entity that is generating the presentation.

proof object

Cryptographic proofs that can be used to detect tampering and verify the authorship of a credential or presentation. An embedded proof is a mechanism where the proof is included in the data, such as a Linked Data Signature.

type string — REQUIRED

Type of the object or the datatype of the typed value.

created date-time — REQUIRED

Date and time at which proof has been created.

proofPurpose string — REQUIRED

It expresses the purpose of the proof and ensures the information is protected by the signature.

verificationMethod string — REQUIRED

Specifies the public key that can be used to verify the digital signature. Dereferencing a public key URL reveals information about the controller of the key, which can be checked against the issuer of the credential.

jws string — REQUIRED

JSON Web Signature

Responses
204

Valid Presentation

400

Bad Request

Schema
type uri

An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.

title string

A short summary of the problem type.

status int32

Possible values: 400 ≤ value < 600

The HTTP status code generated by the origin server for this occurrence of the problem.

detail string

A human readable explanation specific to this occurrence of the problem.

instance uri

An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

500

Internal Server Error

Schema
type uri

An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.

title string

A short summary of the problem type.

status int32

Possible values: 400 ≤ value < 600

The HTTP status code generated by the origin server for this occurrence of the problem.

detail string

A human readable explanation specific to this occurrence of the problem.

instance uri

An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.