humanity protocol
  • Introduction
    • Overview
    • How Humanity Protocol Works
    • Palm Scanner
  • Getting Started
    • Network Configuration
    • Important Links
  • Testnet Info
    • Onboarding Tutorial
    • Testnet Rewards
    • Testnet FAQ
  • Build on Humanity
    • API
      • Issue Credentials (VCs)
      • Verify Credentials (VCs)
      • Revoke Credentials (VCs)
      • List Client Credentials (VCs)
    • Contracts
      • VC contract
      • Rewards contract
    • Contract Integrations Guide
    • Examples
      • Fairdrops
      • Social Media VCs
  • Glossary
  • Community/Support
Powered by GitBook
On this page
  1. Build on Humanity
  2. API

Verify Credentials (VCs)

PreviousIssue Credentials (VCs)NextRevoke Credentials (VCs)

Last updated 1 month ago

Verify a Verifiable Credential

post

Validates the authenticity, integrity, expiration, and revocation status of a Verifiable Credential.

Authorizations
Body
credentialobjectRequired
Responses
application/json
objectOptional
application/json
application/json
post
POST /credentials/verify HTTP/1.1
Host: issuer.humanity.org
X-API-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1534

{
  "credential": {
    "@context": [
      "https://www.w3.org/ns/credentials/v2"
    ],
    "type": [
      "VerifiableCredential"
    ],
    "issuer": "did:key:zUC72jLAC7CFjxk9FDM4fBwx5fYDdesDSn3dT8i38ZEcq6iGdBRGFcBUGczVjbHQbEHvY9rhSBpAuvjjqrze9o7cxtpbJ7Vbi4eDdjyGFMCaexgpeRABVX1uDUoxrkeQjN14k2C",
    "validFrom": "2025-02-23T17:40:40.722Z",
    "validUntil": "",
    "credentialSubject": {
      "id": "did:ethr:0x3f82d75236f45b584000498314ac48daba0155fc",
      "kyc": "passed",
      "age": 22,
      "custom_claim": "value"
    },
    "id": "urn:uuid:2c2053ae-f1ee-4339-8eeb-58d1037ca2db",
    "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-23T17:40:41.280Z",
      "verificationMethod": "did:key:zUC72jLAC7CFjxk9FDM4fBwx5fYDdesDSn3dT8i38ZEcq6iGdBRGFcBUGczVjbHQbEHvY9rhSBpAuvjjqrze9o7cxtpbJ7Vbi4eDdjyGFMCaexgpeRABVX1uDUoxrkeQjN14k2C",
      "proofPurpose": "assertionMethod",
      "proofValue": "2V0ChVhwiqmHRLEYYoRkQ8RXGMk6AypWtEQJCEeVs-vvsrtjzRZlFkYjnflh-x9zgyr0tLsuYUHlKfzccE4m7waZyoLEkBLFiK2g54Q2i-CdtYBgDdkUDsoULSBMcH1MwGHwdjfXpldFNFrHFx_IAvLVniyeMVhAp6K1awQPNTlGQc-n8M_eqQJrj-zVhaKPWi4zCg3fcNnuXaIvjNwMNy0UpAB27QMuHm8kOHAL2jKiic1eGNDk8lhghTmtt-ysKbIxRPmJgCUDX1gMWH_XKd3fwgY5NXXNlwIDTo8qcnQ5Wsa_Hl6u4UuQE_srwQGxP8M3k9_M1zFrw39muVsXXuaFQM2hTTOoSUehu9biK4SnJqdgkYj606DpWCB70jk8pevyyPWrSr3zitlPsC1jZTyKsU07vx_10f5b-oZJL0Bjb250ZXh0Qy9pZEcvaXNzdWVyRS90eXBlSi92YWxpZEZyb21LL3ZhbGlkVW50aWw"
    }
  }
}
{
  "isValid": true,
  "message": "Verification successful"
}