Presentation

Entity Studio SSI API base URL: https://api.entity.hypersign.id

POST/api/v1/presentation

Authorization

Authorization

Header parameters

Body

application/json

credentialDocuments*array of CredDoc (object)

list of credentials

holderDid*string

list of credentials

Example: "did:hid:testnet:............"

challenge*string

Challenge can be used to match the response to a request

Example: "skfdhldklgjh-gaghkdhgaskda-aisgkjheyi"

domain*string

domain that will receive verifiable presentation

Example: "example.com"

Response

200404

Response of presentation

Body

application/json

presentation*all of

Detail of presentaion that has created

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/presentation', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "credentialDocuments": [
        {
          "@context": [
            "https://www.w3.org/2018/credentials/v1",
            {
              "hs": "https://api.jagrat.hypersign.id/hypersign-protocol/hidnode/ssi/schema/sch:hid:testnet:...........:1.0:"
            },
            {
              "name": "hs:name"
            },
            "https://w3id.org/security/suites/ed25519-2020/v1"
          ],
          "id": "vc:hid:testnet:......",
          "type": [
            "VerifiableCredential",
            "nameschema"
          ],
          "expirationDate": "2027-12-10T18:30:00Z",
          "issuanceDate": "2027-12-10T18:30:00Z",
          "issuer": "did:hid:testnet:..........",
          "credentialSubject": {
            "id": "did:hid:testnet:..............."
          },
          "credentialSchema": {
            "id": "sch:hid:testnet:...............",
            "type": "JsonSchemaValidator2018"
          },
          "credentialStatus": {
            "id": "https://api.jagrat.hypersign.id/hypersign-protocol/hidnode/ssi/credential/vc:hid:testnet:...............",
            "type": "CredentialStatusList2017"
          },
          "proof": {
            "type": "Ed25519Signature2020",
            "created": "2023-01-25T17:01:02Z",
            "verificationMethod": "did:hid:testnet:...............#key-${id}",
            "proofPurpose": "assertionMethod",
            "proofValue": "z5LairjrBYkc5FtP.......................EXFHm37aDvcMtCvnYfmvQ"
          }
        }
      ],
      "holderDid": "did:hid:testnet:............",
      "challenge": "skfdhldklgjh-gaghkdhgaskda-aisgkjheyi",
      "domain": "example.com"
    }),
});
const data = await response.json();

Response

200404

{
  "presentation": {
    "@context": [
      "https://www.w3.org/2018/credentials/v1"
    ],
    "type": [
      "VerifiablePresentation"
    ],
    "verifiableCredential": [
      {
        "@context": [
          "https://www.w3.org/2018/credentials/v1",
          {
            "hs": "https://api.jagrat.hypersign.id/hypersign-protocol/hidnode/ssi/schema/sch:hid:testnet:...........:1.0:"
          },
          {
            "name": "hs:name"
          },
          "https://w3id.org/security/suites/ed25519-2020/v1"
        ],
        "id": "vc:hid:testnet:......",
        "type": [
          "VerifiableCredential",
          "nameschema"
        ],
        "expirationDate": "2027-12-10T18:30:00Z",
        "issuanceDate": "2027-12-10T18:30:00Z",
        "issuer": "did:hid:testnet:..........",
        "credentialSubject": {
          "id": "did:hid:testnet:..............."
        },
        "credentialSchema": {
          "id": "sch:hid:testnet:...............",
          "type": "JsonSchemaValidator2018"
        },
        "credentialStatus": {
          "id": "https://api.jagrat.hypersign.id/hypersign-protocol/hidnode/ssi/credential/vc:hid:testnet:...............",
          "type": "CredentialStatusList2017"
        },
        "proof": {
          "type": "Ed25519Signature2020",
          "created": "2023-01-25T17:01:02Z",
          "verificationMethod": "did:hid:testnet:...............#key-${id}",
          "proofPurpose": "assertionMethod",
          "proofValue": "z5LairjrBYkc5FtP.......................EXFHm37aDvcMtCvnYfmvQ"
        }
      }
    ],
    "id": "vp:hid:testnet:..........................",
    "holder": "did:hid:testnet:..............",
    "proof": {
      "type": "Ed25519Signature2020",
      "created": "2023-01-25T17:01:02Z",
      "verificationMethod": "did:hid:testnet:...............#key-${id}",
      "proofPurpose": "authentication",
      "challenge": "skfdhldklgjh-gaghkdhgaskda-aisgkjheyi",
      "proofValue": "z5LairjrBYkc5FtPWeDVuLdQUzpMTBULcp3Q5YDnrLh63UuBuY6BpdiQYhTEcKBFW76TEXFHm37aDvcMtCvnYfmvQ"
    }
  }
}