Skip to main content
POST
Verify Attestation
Check a record’s current status and available evidence. To check its cryptographic signature, send the exact original signed payload as payload_b64url. A record ID or file fingerprint alone cannot supply those bytes.

Choose the check you need

An ID-only or fingerprint-only check returns INCOMPLETE and signature_verified: false unless a stronger result such as REVOKED, EXPIRED, or ALTERED applies. Supply the original payload for a complete signature check. An inline attestation must identify a registered record with attestation_id. Online status and key identity are loaded from that record; fields supplied by the caller cannot override its issuer or revocation. Use a compatible offline verifier for standalone signature checks.

Interpret the response

signature_verified reports the signature check specifically. log.proof_checked reports successful transparency inclusion checking. A missing proof produces a reason and a null leaf index; zero is a legitimate first leaf. An absent expires_at_unix value does not mean that a new expiry should be invented for a historical record.
A valid signature does not prove ownership, legal validity, or the truth of every claim. Read reasons, current issuer governance, and the available evidence before relying on a record. Optional policy or log checks may be unavailable even when the payload signature passes.

Authentication and limits

Public verification does not require an API key. Authenticated calls use the caller’s workspace and environment and may be subject to its verification allowance. Service rate limits still apply to public requests. A private or sandbox record may not be available through an anonymous production lookup. Share an accessible record using https://verify.truthlocks.com/proof/{attestation_id}. A shared URL does not grant access to private payloads.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
attestation
object | null

Online lookup envelope. A registered attestation_id is required here or at request level. Stored status, issuer, key and issuance time are authoritative; supplied copies cannot override them.

attestation_id
string
document_hash_hex
string
payload_b64url
string

Response

200 - application/json

Verification result

Public verification evidence. Inspect reasons and individual checks; an ID-only check does not verify original content supplied by the caller.

verdict
enum<string>
required

Inspect reasons, the supplied verification inputs, and log.proof_checked alongside this verdict. VALID alone does not establish ownership or prove every claim in the record.

Available options:
VALID,
INCOMPLETE,
INVALID,
REVOKED,
ALTERED,
SUPERSEDED,
EXPIRED,
UNKNOWN_ISSUER,
NOT_FOUND
signature_verified
boolean

True only when the supplied original payload passed cryptographic signature verification. ID-only and fingerprint-only checks return false.

reasons
string[]
attestation_id
string<uuid>
issuer_id
string<uuid>
expires_at_unix
integer<int64> | null

Recorded signed expiry in Unix seconds; null means no expiry is recorded. Legacy records are not assigned a new expiry.

issued_at_unix
integer<int64>

Original stored issuance time as Unix seconds. This is not the time of the current check or certificate download. Absent if unavailable.

kid
string

Signing key identifier.

alg
string

Declared signing algorithm.

payload_hash
string

Base64url-encoded SHA-256 digest of the canonical payload.

document_hash
string

SHA-256 hexadecimal fingerprint of the original file, when stored.

log
object
governance
object