SETHUSemantic Electronic Trust Harbour Utility

Documentation

API documentation, integration guides, and reference.

OpenAPI / Swagger

Interactive API documentation with request/response schemas.

Open API docs →

Runbook

Operational procedures: health checks, common issues, cron jobs. Repo: docs/SETHU_Runbook.md.

API Reference (JSON)

Machine-readable endpoint index with curl examples.

GET /v1/sethu/api-reference →

Integration guides

See Knowledge Base and repo docs/SETHU_Integration_Guide.md for full integration flows.

  • • DID create/prove: Knowledge Base – POST /v1/did/create, POST /v1/did/prove, GET /v1/did/:did. PQC+ keys (ML-DSA-65, ML-DSA-87) supported.
  • • DID bind: POST /v1/sethu/did/bind with type (FALLBACK, IDENTITY_HASH, VID). senderRef recommended for audit.
  • • Ledger state write: POST /v1/sethu/ledger/ist – requires API key; senderRef required (SETHU inbound standard). Hash computed by sender.
  • • Ledger mirror read: GET /v1/sethu/ledger/mirror/:did – returns did, istHash, blockNumber, txHash.
  • • AI blockchain: Registration anchoring and negative-events log on request from TokCredAI; returns blockchain response. See catalogue (AI – registration anchoring, AI – negative events log).
  • • Wallet credentials: POST /v1/sethu/wallet/credentials (store), GET (list), POST .../disclose (selective disclosure). Supports JWT (e.g. SD-JWT) and AnonCreds.
  • • Education API v1: POST /v1/credentials/issue, /accept, /verify, /revoke, POST /v1/schemas/register, GET /v1/credentials/:id/proof, GET /v1/ledger/tx/:anchorId. These are the stable education-facing aliases for partner integrations.
  • • Compliance package: GET /v1/sethu/compliance-package packages audit, incident, ledger, and key-rotation metadata for operator or regulator reviews. Use GET /v1/sethu/audit-export for the raw audit extract.