Verify Verifiable Accreditation

Users are able to issue Verifiable Accreditations to determine the validity of the accreditation, as well to traverse the trust chain to a root of trust.

Step 1: Issue Accreditation

Make sure you have already created at least one Verifiable Accreditation that you are able to query in the verify API.

Issue Verifiable Accreditation

Issue a Verifiable Accreditation as a DID-Linked Resource from an "issuer" DID to a recipient "subject" DID.

Step 2: Use the Verify Accreditation API

Verify a verifiable accreditation for a DID.

Generate and publish a Verifiable Accreditation for a subject DID as a DID Linked resource.

POST/trust-registry/accreditation/verify

Authorization

ApiKeyAuth

Query parameters

Body

application/x-www-form-urlencodedapplication/json

subjectDid*string

DID of the Verifiable Accreditation holder/subject. This needs to be a `did:key` DID.

Example: "did:cheqd:testnet:5efa5126-c070-420f-a9c2-d22ae6eefb92"

didUrlstring

DID URL of the Verifiable Accreditation to be verified as a VC-JWT string or a JSON object.

Example: "did:cheqd:testnet:7c2b990c-3d05-4ebf-91af-f4f4d0091d2e?resourceName=cheqd-issuer-logo&resourceType=CredentialArtwork"

didstring

DID of the Verifiable Accreditation holder/subject

Example: "did:cheqd:testnet:7c2b990c-3d05-4ebf-91af-f4f4d0091d2e"

resourceIdstring

Unique resource identifier of the Verifiable Accreditation

Example: "398cee0a-efac-4643-9f4c-74c48c72a14b"

resourceNamestring

Resource name of the Verifiable Accreditation

Example: "cheqd-issuer-logo"

resourceTypestring

Resource type of the Verifiable Accreditation

Example: "CredentialArtwork"

schemasarray of object

The list of schemas the subject DID is accredited for.

policiesobject

Custom verification policies to execute when verifying Accreditation.

Response

200400401500

The request was successful.

Body

application/json

@contextarray of string

typearray of string

expirationDatestring (date-time)

Example: "2023-06-08T13:49:28.000Z"

issuerobject

credentialSubjectobject

credentialStatusobject

issuanceDatestring (date-time)

Example: "2023-06-08T13:49:28.000Z"

proofobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/trust-registry/accreditation/verify', {
    method: 'POST',
    headers: {
      "Content-Type": "application/x-www-form-urlencoded"
    },
    body: JSON.stringify({
      "subjectDid": "did:cheqd:testnet:5efa5126-c070-420f-a9c2-d22ae6eefb92"
    }),
});
const data = await response.json();

Response

200

{
  "@context": [
    "https://www.w3.org/2018/credentials/v1",
    "https://schema.org",
    "https://veramo.io/contexts/profile/v1"
  ],
  "credentialSubject": {
    "gender": "male",
    "id": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK",
    "name": "Bob"
  },
  "credentialStatus": {
    "id": "https://resolver.cheqd.net/1.0/identifiers/did:cheqd:testnet:7c2b990c-3d05-4ebf-91af-f4f4d0091d2e?resourceName=cheqd-suspension-1&resourceType=StatusList2021Suspension#20",
    "statusIndex": 20,
    "statusPurpose": "suspension",
    "type": "StatusList2021Entry"
  },
  "issuanceDate": "2023-06-08T13:49:28.000Z",
  "issuer": {
    "id": "did:cheqd:testnet:7bf81a20-633c-4cc7-bc4a-5a45801005e0"
  },
  "proof": {
    "jwt": "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJkaWQ6Y2hlcWQ6dGVzdG5ldDo3YmY4MWEyMC02MzNjLTRjYzctYmM0YS01YTQ1ODAxMDA1ZTAiLCJuYmYiOjE2ODYyMzIxNjgsInN1YiI6ImRpZDprZXk6ejZNa2hhWGdCWkR2b3REa0w1MjU3ZmFpenRpR2lDMlF0S0xHcGJubkVHdGEyZG9LIiwidmMiOnsiQGNvbnRleHQiOlsiaHR0cHM6Ly93d3cudzMub3JnLzIwMTgvY3JlZGVudGlhbHMvdjEiLCJodHRwczovL3NjaGVtYS5vcmciLCJodHRwczovL3ZlcmFtby5pby9jb250ZXh0cy9wcm9maWxlL3YxIl0sImNyZWRlbnRpYWxTdWJqZWN0Ijp7ImdlbmRlciI6Im1hbGUiLCJuYW1lIjoiQm9iIn0sInR5cGUiOlsiVmVyaWZpYWJsZUNyZWRlbnRpYWwiLCJQZXJzb24iXX19.wMfdR6RtyAZA4eoWya5Aw97wwER2Cm5Guk780Xw8H9fA3sfudIJeLRLboqixpTchqSbYeA7KbuCTAnLgXTD_Cg",
    "type": "JwtProof2020"
  },
  "type": [
    "VerifiableCredential",
    "Person"
  ]
}