Verification API
Coming soon
The hosted Verification API is not available yet. You can run the same verification today with the open-source CLI and the WebAssembly verifier; this hosted service is on the roadmap. The reference below previews the planned API.
The Verification API runs the full pipeline on the server and returns a structured report. It is stateless and safe to call from gateways, CI, and backends.
Endpoint
text
POST https://api.osdfsystems.com/v1/verifyContent-Type: application/osdfAuthorization: Bearer <token>Request
bash
curl -X POST https://api.osdfsystems.com/v1/verify \ -H "Authorization: Bearer $OSDF_TOKEN" \ -H "Content-Type: application/osdf" \ --data-binary @contract.osdfResponse
json
{ "ok": true, "score": 100, "stages": { "structure": { "status": "pass" }, "signature": { "status": "pass", "signer": "did:osdf:org:co-dor" }, "provenance": { "status": "pass", "revision": 7 }, "ledger": { "status": "pass", "log": "primary" }, "policy": { "status": "pass", "decision": "render" } }, "trust_roots": ["osdf-public-2026"]}Status semantics
| Status | Meaning |
|---|---|
pass | Check succeeded under the active profile |
info | Informational; surfaced but non-blocking |
skip | Not applicable to this package |
fail | Blocking failure - viewer must fail closed |
Rate limits and authentication are covered in the Enterprise API.