curl --request POST \
--url https://api.truthlocks.com/v1/verify \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
attestation: {
attestation_id: '<string>',
document_hash: '<string>',
expires_at_unix: 123,
issued_at_unix: 123,
issuer_id: '<string>',
log: {
log_id: '<string>',
leaf_index: 123,
leaf_hash: '<string>',
proof_url: '<string>'
},
payload_hash: '<string>',
signature: {alg: '<string>', kid: '<string>', value: '<string>'},
status: '<string>',
tenant_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
version: '<string>'
},
attestation_id: '<string>',
document_hash_hex: '<string>',
payload_b64url: '<string>'
})
};
fetch('https://api.truthlocks.com/v1/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/verify"
payload = {
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/verify"
payload := strings.NewReader("{\n \"attestation\": {\n \"attestation_id\": \"<string>\",\n \"document_hash\": \"<string>\",\n \"expires_at_unix\": 123,\n \"issued_at_unix\": 123,\n \"issuer_id\": \"<string>\",\n \"log\": {\n \"log_id\": \"<string>\",\n \"leaf_index\": 123,\n \"leaf_hash\": \"<string>\",\n \"proof_url\": \"<string>\"\n },\n \"payload_hash\": \"<string>\",\n \"signature\": {\n \"alg\": \"<string>\",\n \"kid\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"tenant_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"version\": \"<string>\"\n },\n \"attestation_id\": \"<string>\",\n \"document_hash_hex\": \"<string>\",\n \"payload_b64url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}Verify Attestation
Check record status, issuer metadata and available evidence. Supply the exact original payload_b64url to verify the cryptographic signature. An ID-only or file-fingerprint-only lookup returns INCOMPLETE with signature_verified false if no stronger failure applies. VALID means the supplied payload passed signature checks; it does not prove the truth of the claims or guarantee that optional policy and transparency checks completed. Inspect reasons and log.proof_checked. Public requests need no API key; authenticated requests are scoped and metered against the caller’s workspace.
curl --request POST \
--url https://api.truthlocks.com/v1/verify \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
attestation: {
attestation_id: '<string>',
document_hash: '<string>',
expires_at_unix: 123,
issued_at_unix: 123,
issuer_id: '<string>',
log: {
log_id: '<string>',
leaf_index: 123,
leaf_hash: '<string>',
proof_url: '<string>'
},
payload_hash: '<string>',
signature: {alg: '<string>', kid: '<string>', value: '<string>'},
status: '<string>',
tenant_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
version: '<string>'
},
attestation_id: '<string>',
document_hash_hex: '<string>',
payload_b64url: '<string>'
})
};
fetch('https://api.truthlocks.com/v1/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/verify"
payload = {
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/verify"
payload := strings.NewReader("{\n \"attestation\": {\n \"attestation_id\": \"<string>\",\n \"document_hash\": \"<string>\",\n \"expires_at_unix\": 123,\n \"issued_at_unix\": 123,\n \"issuer_id\": \"<string>\",\n \"log\": {\n \"log_id\": \"<string>\",\n \"leaf_index\": 123,\n \"leaf_hash\": \"<string>\",\n \"proof_url\": \"<string>\"\n },\n \"payload_hash\": \"<string>\",\n \"signature\": {\n \"alg\": \"<string>\",\n \"kid\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"tenant_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"version\": \"<string>\"\n },\n \"attestation_id\": \"<string>\",\n \"document_hash_hex\": \"<string>\",\n \"payload_b64url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}payload_b64url. A record ID or file fingerprint alone cannot supply those bytes.
Choose the check you need
| Input | What it checks |
|---|---|
attestation_id | Finds an accessible record and checks its current status, issuer metadata and available log evidence. |
ID plus payload_b64url | Also checks the payload digest and signature against the registered public key. Encode the original bytes; reformatting JSON can change those bytes. |
ID plus document_hash_hex | Compares a supplied SHA-256 fingerprint with the recorded document fingerprint. This does not replace the signed-payload check. |
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
| Verdict | Meaning |
|---|---|
VALID | The supplied payload passed its signature check and no blocking failure was returned. Inspect reasons and individual checks. |
INCOMPLETE | Required original content was not supplied; the signature was not checked. |
ALTERED | A supplied payload, signature or document fingerprint failed an integrity check. |
REVOKED | The record has been revoked. |
SUPERSEDED | A newer record replaces this one. Ask the issuer for its current record. |
EXPIRED | The record or signing key has expired. |
INVALID | A required input or verification check failed. |
NOT_FOUND | No accessible record matched the request and its environment. |
UNKNOWN_ISSUER | The issuer’s signing key could not be accepted. |
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.
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 usinghttps://verify.truthlocks.com/proof/{attestation_id}. A shared URL does not grant access to private payloads.Body
Response
Verification result
Public verification evidence. Inspect reasons and individual checks; an ID-only check does not verify original content supplied by the caller.
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.
VALID, INCOMPLETE, INVALID, REVOKED, ALTERED, SUPERSEDED, EXPIRED, UNKNOWN_ISSUER, NOT_FOUND 
