# Verified Digital Agents (VDA) Witness API

**Canonical:** https://apis.io/apis/getvda-ai/getvda-ai-witness-api/  
**Provider:** Verified Digital Agents (VDA) — https://apis.io/providers/getvda-ai/  
**Base URL:** https://witness.getvda.ai  
**Documentation:** https://witness.getvda.ai/docs

Verified Digital Agents (VDA) Witness API is one of 27 APIs that [Verified Digital Agents (VDA)](https://apis.io/providers/getvda-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Witness. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Witness API from Verified Digital Agents (VDA) — 23 operation(s) for witness.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/witness/test-key` | Self-serve: mint an instant SEALED-tier API key (no human in the loop) |
| POST | `/api/witness/renew/challenge` | Agent-provable renewal, step 1: get a one-time challenge nonce |
| POST | `/api/witness/renew` | Agent-provable renewal, step 2: prove control → fresh short-TTL key |
| POST | `/api/witness/account/bind-controller` | Bind an Ed25519 controller key to an EXISTING account (upgrade to durable) |
| POST | `/api/witness/seal` | Seal a governed decision into a signed, hash-chained record |
| POST | `/api/witness/seal/hitl-decision` | Seal a human-in-the-loop decision (shaped — evidentiary basis required) |
| POST | `/api/witness/seal/agent-action` | Seal an autonomous agent action (shaped — evidence and/or parameters) |
| POST | `/api/witness/seal/attestation` | Seal an attestation (shaped — a fact/state as of a time) |
| POST | `/api/witness/prepare` | Customer-managed custody: prepare a shaped body for local signing (STATELESS) |
| POST | `/api/witness/credentials/issue` | Issue an agent admission credential (a sealed attestation) |
| GET | `/api/witness/credentials/{credential_id}` | check_valid — is this admission credential currently valid? (PUBLIC) |
| POST | `/api/witness/credentials/{credential_id}/revoke` | Revoke an admission credential (issuer account only) |
| POST | `/api/witness/keys/revoke` | Revoke an account API key — sealed as a key_revocation event |
| GET | `/api/witness/records/{recordId}/issuer` | verify_record_issuer — is a record's signature by the issuer it claims? |
| POST | `/api/witness/verify` | Independently verify a record or chain (PUBLIC — no key) |
| GET | `/api/witness/records` | list_records — read your own records (account-scoped operational query; account… |
| GET | `/api/witness/records/{recordId}` | get_record — the FULL signed body of one of your records (reasoning, inputs… |
| GET | `/api/witness/chains/{chainKey}/proof` | Whole-chain OFFLINE proof bundle — verify an entire trail with zero Witness… |
| POST | `/api/witness/report` | Article 12 EVIDENCE report from your trail (a compliance artefact, not a query… |
| GET | `/api/witness/usage` | This account's seal usage + monthly headroom (Sealed tier includes 5,000… |
| GET | `/api/witness/whoami` | Resolve the presented API key to its account + tier (suite-service credential… |
| GET | `/api/witness/anchor-status` | Anchor coverage for your account/chain |
| POST | `/api/witness/mcp` | Model Context Protocol endpoint (initialize / tools/list / tools/call… |

## Machine-readable artifacts (25)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/openapi/getvda-ai-witness-api-openapi.yml
- **Documentation** — https://witness.getvda.ai/docs
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-witness-llms.txt
- **LLMsTxt** — https://witness.getvda.ai/llms.txt
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/mcp/getvda-ai-tool-crosswalk.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/data-model/getvda-ai-data-model.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/sandbox/getvda-ai-sandbox.yml
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-witness-did.json
- **X-ProofOfIntegrity** — https://witness.getvda.ai/proof
- **Documentation** — https://getvda.ai/blocks/hitl.html
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-hitl-did.json
- **Documentation** — https://getvda.ai/blocks/acp.html
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-acp-did.json
- **Documentation** — https://getvda.ai/c2md/generate-compliance-bundle.html
- **APIReference** — https://c2md.getvda.ai/docs
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-c2md-llms.txt
- **LLMsTxt** — https://c2md.getvda.ai/llms.txt
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/scopes/getvda-ai-scopes.yml
- **Documentation** — https://agents.getvda.ai/agents
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-gosce-llms.txt
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-gosce-router-llms.txt
- **X-AgentCatalog** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-ai-catalog.json
- **X-JWKS** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-jwks.json
- **X-DID** — https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-did.json
- **SourceCode** — https://github.com/mikerawsonnz/gosce-agents

## Other Verified Digital Agents (VDA) APIs (12)

- [VDA Onboarding Agent](https://apis.io/apis/getvda-ai/vda-onboarding-agent/)
- [Verified Digital Agents (VDA) Agents API](https://apis.io/apis/getvda-ai/getvda-ai-agents-api/)
- [Verified Digital Agents (VDA) Bundles API](https://apis.io/apis/getvda-ai/getvda-ai-bundles-api/)
- [Verified Digital Agents (VDA) C2MD Edge API](https://apis.io/apis/getvda-ai/getvda-ai-c2md-edge-api/)
- [Verified Digital Agents (VDA) Copilot Studio.yaml API](https://apis.io/apis/getvda-ai/getvda-ai-copilot-studio-yaml-api/)
- [Verified Digital Agents (VDA) Environments API](https://apis.io/apis/getvda-ai/getvda-ai-environments-api/)
- [Verified Digital Agents (VDA) Genesis API](https://apis.io/apis/getvda-ai/getvda-ai-genesis-api/)
- [Verified Digital Agents (VDA) GOSCE Portfolio API](https://apis.io/apis/getvda-ai/getvda-ai-gosce-portfolio-api/)
- [Verified Digital Agents (VDA) Governance.md API](https://apis.io/apis/getvda-ai/getvda-ai-governance-md-api/)
- [Verified Digital Agents (VDA) Health API](https://apis.io/apis/getvda-ai/getvda-ai-health-api/)
- [Verified Digital Agents (VDA) Healthz API](https://apis.io/apis/getvda-ai/getvda-ai-healthz-api/)
- [Verified Digital Agents (VDA) Livez API](https://apis.io/apis/getvda-ai/getvda-ai-livez-api/)

## Tags

Witness

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/getvda-ai/getvda-ai-witness-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/getvda-ai/.