List Client Credentials (VCs) | humanity protocol

List Verifiable Credentials

get

List all Verifiable Credentials (VCs) issued. If holderDid is provided, returns credentials for that specific holder, otherwise returns all credentials issued by the API key.

Authorizations

Query parameters

holderDidstringOptional

The DID of the credential holder

Example: did:ethr:0x3f82d75236f45b584000498314ac48daba0155fc

Responses

application/json

objectOptional

application/json

get

GET /credentials/list HTTP/1.1
Host: issuer.humanity.org
X-API-Token: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "@context": [
        "https://www.w3.org/ns/credentials/v2"
      ],
      "type": [
        "VerifiableCredential"
      ],
      "issuer": "did:key:zUC72jLAC7CFjxk9FDM4fBwx5fYDdesDSn3dT8i38ZEcq6iGdBRGFcBUGczVjbHQbEHvY9rhSBpAuvjjqrze9o7cxtpbJ7Vbi4eDdjyGFMCaexgpeRABVX1uDUoxrkeQjN14k2C",
      "validFrom": "2025-02-24T14:47:27.457Z",
      "validUntil": "",
      "credentialSubject": {
        "id": "did:ethr:0x3f82d75236f45b584000498314ac48daba0155fc",
        "kyc": "passed",
        "age": 22,
        "custom_claim": "value"
      },
      "id": "urn:uuid:a90c4593-376a-4dd1-b68b-06994b4d0256",
      "credentialStatus": {
        "type": "T3RevocationRegistry",
        "chain_id": "1942999413",
        "revocation_registry_contract_address": "0xB7676D6881f3642b27dF77a4f2e2060F4CBa2594",
        "did_registry_contract_address": "0x9ec4D6B69926e80316Bf9c1E0A2b2Ae4b8bde707"
      },
      "proof": {
        "type": "DataIntegrityProof",
        "cryptosuite": "bbs-2023",
        "created": "2025-02-24T14:47:28.019Z",
        "verificationMethod": "did:key:zUC72jLAC7CFjxk9FDM4fBwx5fYDdesDSn3dT8i38ZEcq6iGdBRGFcBUGczVjbHQbEHvY9rhSBpAuvjjqrze9o7cxtpbJ7Vbi4eDdjyGFMCaexgpeRABVX1uDUoxrkeQjN14k2C",
        "proofPurpose": "assertionMethod",
        "proofValue": "2V0ChVhwtJwduH92wZUvifETQz16LDdRPI2jUr7fO7yYO7loNXJiAp1cAb0IyAGrepZXd2k_YUHlKfzccE4m7waZyoLEkBLFiK2g54Q2i-CdtYBgDdkUDsoULSBMcH1MwGHwdjfXpldFNFrHFx_IAvLVniyeMVhAGyUImnA5UiL0kAfNmVbNd_oy8s6aeF-4e5b13uJ-RyEoMmJQRJU_Rh2oGUF37CyZeu5ynVDj6-FTjdN5tjpdI1hghTmtt-ysKbIxRPmJgCUDX1gMWH_XKd3fwgY5NXXNlwIDTo8qcnQ5Wsa_Hl6u4UuQE_srwQGxP8M3k9_M1zFrw39muVsXXuaFQM2hTTOoSUehu9biK4SnJqdgkYj606DpWCDjqVcBP56jimKaOniUAxoDNqHx-WmuJ39ESp37WVdGi4ZJL0Bjb250ZXh0Qy9pZEcvaXNzdWVyRS90eXBlSi92YWxpZEZyb21LL3ZhbGlkVW50aWw"
      }
    }
  ]
}