Attestations
Fetch and verify issued attestations. All public — verification is free and needs no key.
GET/v1/attestations/{uid}
Returns the attestation: artefact hash, agent id/run, review kind (+ reviewKindSlug), signer tier (+ signerTierSlug), timestamps, attester, chain id, and revoked.
GET/v1/attestations/{uid}/verify
Runs the reference verifier and returns a verdict. The verdict’s status is one of:
| Status | ok | Meaning |
|---|---|---|
verified | true | A qualifying human review, structurally valid, not revoked |
rejected_review | false | A human reviewed and rejected the artefact |
revoked | false | The attestation was revoked |
tier_unmet | false | Signer tier below the caller’s required tier |
identity_missing | false | The signer identity can’t be resolved |
invalid | false | Structurally invalid or claims a tier its identity can’t support |
not_found | false | No such attestation |
The verdict includes the resolved attestation, the signer identity, and the revisionChain (newest first) when the artefact was re-reviewed.
Revocation
An org admin can revoke one of its attestations from the console; the verdict becomes revoked and the badge turns neutral thereafter. Revocation is recorded on the anchor.