Skip to main content
POST
/
_webhooks
/
credential
Credential Event
curl --request POST \
  --url https://api.example.com/_webhooks/credential \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventType": "credential",
  "requestId": "<string>",
  "issuerDid": "<string>",
  "user": {
    "contact": "<string>",
    "id": "<string>",
    "internalId": "<string>"
  },
  "api_version": "<string>",
  "credential": {
    "id": "urn:via:credential:550e8400-e29b-41d4-a716-446655440000",
    "resourceType": "DOCUMENT",
    "status": "DRAFT",
    "w3cCredential": {
      "@context": [
        "https://www.w3.org/ns/credentials/v2",
        "https://via.humanos.dev/ns/v1"
      ],
      "id": "did:web:humanos.techcredential:uuid",
      "type": [
        "VerifiableCredential",
        "VIAMandate"
      ],
      "issuer": "did:web:humanos.tech",
      "validFrom": "2025-01-01T00:00:00Z",
      "validUntil": null,
      "credentialSubject": {
        "id": "did:web:humanostech:issuer-uuid",
        "mandate": {
          "grantor": [
            "did:web:humanos:contact:"
          ],
          "scope": "humanos.credential.request",
          "context": {
            "authorizedDIDs": [
              "did:web:humanos.tech:issuer-uuid",
              "did:web:humanos.tech:agent:uuid"
            ]
          }
        }
      },
      "evidences": [
        {
          "id": "did:web:humanos.tech::evidence:uuid",
          "digestSRI": "sha256-abc123",
          "location": "https://api.humanos.dev/evidences/did:web:humanos.tech::evidence:uuid"
        }
      ],
      "proofs": [
        {
          "type": "DataIntegrityProof",
          "cryptosuite": "eddsa-jcs-2022",
          "verificationMethod": "did:web:humanos.tech:platform:550e8400-e29b-41d4-a716-446655440000#key-1",
          "created": "2026-05-02T10:15:30.000Z",
          "proofPurpose": "assertionMethod",
          "proofValue": "z2pcVdSdoMTrkYP9rVdz..."
        }
      ]
    },
    "name": "Credential Name",
    "description": "Document to be requested on onboarding",
    "internalId": "internal-12345",
    "tags": [
      "<string>"
    ],
    "decisions": [
      {
        "id": "urn:via:decision:550e8400-e29b-41d4-a716-446655440001",
        "contact": "grantor@example.com",
        "accepted": true,
        "decidedAt": "2025-06-01T12:00:00.000Z"
      }
    ]
  },
  "decision": {
    "action": "accept",
    "date": "2023-11-07T05:31:56Z"
  },
  "internalId": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.humanos.id/llms.txt

Use this file to discover all available pages before exploring further.

Headers

API-Version
string

Pin responses to a specific API version (YYYY-MM-DD). When omitted, defaults to the version stored in your issuer config or today's date.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-03-03"

Body

application/json
eventType
enum<string>
required
Available options:
credential
requestId
string
required
issuerDid
string
required
user
object
required
api_version
string
required
credential
object
required
decision
object
required
internalId
string

Response

200

Webhook received successfully