HumanReviewed docs

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:

StatusokMeaning
verifiedtrueA qualifying human review, structurally valid, not revoked
rejected_reviewfalseA human reviewed and rejected the artefact
revokedfalseThe attestation was revoked
tier_unmetfalseSigner tier below the caller’s required tier
identity_missingfalseThe signer identity can’t be resolved
invalidfalseStructurally invalid or claims a tier its identity can’t support
not_foundfalseNo 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.