List Client Credentials (VCs)

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

200

Successfully retrieved credentials

application/json

400

Invalid request

application/json

401

Unauthorized

application/json

get

HTTPcURLJavaScriptPython

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"
      }
    }
  ]
}