Programmatically Issue a Credential

General steps to implement based on events in applications and onchain

Programmatically Issue Verifiable Credentials (VCs)

Issue Verifiable Credentials (VCs) programmatically when certain events occur, such as when a user completes specific actions, swaps a token, completes a level in a game, or mints an NFT. VCs can be issued to a user's ETH address or DID. The options are endless and only bound by your imagination!

Prerequisite

Generate a did:web to ensure credentials are signed with keys that you control

How it works

1. Select event(s) that will result in credential issuance

2. Leverage our API endpoint and set up logic in your platform to issue credentials

   • Determine conditions for issuing credentials to a users

   • Send POST requests to the API to issue the credentials

3. User receives credentials

API Endpoint

Programmatically issue one verifiable credential

Generate and return a signed Credential. This will also write the Credential the recipient's data backpack in Disco's Verifiable Data Registry. The JSON body should contain required Credential values for the schema type used. Available schemas and their specifications can be found at https://github.com/discoxyz/disco-schemas.

POST/v1/credential

Body

application/json

The JSON body should contain specific credential schema values required for the Credential type used. Available schemas can be found at https://github.com/discoxyz/disco-schemas.

schemaUrlschemaUrl

The URL of the verifiable crednetial schema. Available schemas can be found at https://github.com/discoxyz/disco-schemas

Example: "https://raw.githubusercontent.com/discoxyz/disco-schemas/main/json/MembershipCredential/1-0-0.json"

recipientDIDrecipientDID

The DID address of the credential's claimant

Example: "did:3:Example987xyz"

subjectDatasubjectData

The fields and values for the credential (based on its schema)

Example: "{\n \"memberId\": \"Goldstar Member\",\n \"membershipDescription\": \"Demo membership to showcase Disco API\",\n \"membershipLevel\": \"Permanent\",\n \"membershipType\": \"Developer\",\n \"organization\": \"Disco.xyz\"\n }"

expirationDateexpirationDate

The date for the credential to expire for the claimant. Leave empty if there's no expiration.

Example: ""

suitesuite

Optional - supported values are "JWT" and "712".

Example: ""

issuerissuer

The DID address of the credential's issuer.

Example: "did:web:api.disco.xyz/v1/disco"

skipSignskipSign

To sign or not to sign - hint you should sign! Either leave out or assign false.

Example: "false"

Response

200401500

Success

Body

application/json

_idDatabase ID

Internal ID used by data storage system

vcvc

Verifiable Credential payload

Example: "See https://www.w3.org/TR/vc-data-model/#example-a-simple-example-of-a-verifiable-credential"

jwtJWT

JSON Web Token per RFC 7519

Example: "eyJhbGciOiJIUzI1N........"

isPublicPublic/Private Flag

If true anyone can read the credential. If false, only the issuer and the claimant can read the credential.

Example: "true"

issuerVerifiable Credential Issuer

JSON Web Token per RFC 7519

Example: ""

recipientHolder or claimant of Verifiable Credential

The DID value for the recipient of Verifiable Credential.

subjectSubject of Credential

Subject is what the credential claim is made about.

schemaschema

The URL of the verifiable crednetial schema. Available schemas can be found at https://github.com/discoxyz/disco-schemas

Example: "https://raw.githubusercontent.com/discoxyz/disco-schemas/main/json/MembershipCredential/1-0-0.json"

genIdUnique Verifiable Credential ID

updatedAtLatest update date and time

isDeletedSoft-delete flag

historyList of changes to the credential, if any.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/v1/credential', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200401500

{
  "_id": "text",
  "vc": "See https://www.w3.org/TR/vc-data-model/#example-a-simple-example-of-a-verifiable-credential",
  "jwt": "eyJhbGciOiJIUzI1N........",
  "isPublic": "true",
  "issuer": "",
  "recipient": "text",
  "subject": "text",
  "schema": "https://raw.githubusercontent.com/discoxyz/disco-schemas/main/json/MembershipCredential/1-0-0.json",
  "genId": "text",
  "updatedAt": "text",
  "isDeleted": false,
  "history": []
}

Usage example

Curl

curl --location 'https://api.disco.xyz/v1/credential' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Authorization: Bearer <your Disco API key>' \
--data '{
    "issuer": "did:3:123abcexample",
    "schemaUrl": "https://raw.githubusercontent.com/discoxyz/disco-schemas/main/json/MembershipCredential/1-0-0.json",
    "recipientDID": "did:3:456defexample",
    "subjectData": {
        "memberId": "123XYZ",
        "membershipDescription": "Demo membership to showcase Disco API",
        "membershipLevel": "Permanent",
        "membershipType": "Developer",
        "organization": "Disco.xyz"
    },
    "expirationDate": ""
}'

JavaScript

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Accept", "*/*");
myHeaders.append("Authorization", "Bearer <your Disco API key>");

var raw = JSON.stringify({
  "issuer": "did:3:123abcexample",
  "schemaUrl": "https://raw.githubusercontent.com/discoxyz/disco-schemas/main/json/MembershipCredential/1-0-0.json",
  "recipientDID": "did:3:456defexample",
  "subjectData": {
    "memberId": "123XYZ",
    "membershipDescription": "Demo membership to showcase Disco API",
    "membershipLevel": "Permanent",
    "membershipType": "Developer",
    "organization": "Disco.xyz"
  },
  "expirationDate": ""
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://api.disco.xyz/v1/credential", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));