Skip to main content
GET
/
v1
/
truth
/
document
/
{documentId}
Get Document Verification
curl --request GET \
  --url https://api.truthlocks.com/v1/truth/document/{documentId} \
  --header 'X-API-Key: <api-key>'
{
  "verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "document_hash": "<string>",
  "status": "pending",
  "results": [
    {}
  ],
  "verifications": [
    {}
  ],
  "claims": [
    {
      "claim_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "claim_type": "<string>",
      "payload": {},
      "evidence": [
        {}
      ],
      "status": "pending",
      "receipt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "attestations": [
        {
          "attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "witness_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "claim_hash": "<string>",
          "signature": "<string>",
          "status": "pending",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ],
      "verified_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z"
}
Returns the current status and verification results for a previously submitted document. When processing is complete, the response includes both the AI verdict and (if applicable) the human verdict, along with the associated truth claim and receipt identifiers.

​
Authentication

Requires X-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.

​
Path Parameters

​
document_id
string
required
The unique identifier of the document verification record. Format: maip-doc:ULID.

​
Response

​
document_id
string
The document verification record identifier.
​
agent_id
string
The agent that submitted the document.
​
document_type
string
The classification of the document.
​
file_name
string
The original file name.
​
document_hash
string
The SHA-256 hex digest of the document content.
​
status
string
Current processing status. One of: - processing — document is being analyzed - verified — document passed verification - disputed — document has conflicting signals - rejected — document failed verification (tampering, forgery, or invalidity detected)
​
ai_verdict
string
The AI model’s determination. One of: authentic, suspicious, forged, inconclusive. null while still processing.
​
ai_confidence
number
The AI model’s confidence in its verdict as a float between 0.0 and 1.0. null while still processing.
​
human_verdict
string
The human reviewer’s determination, if human review was triggered. One of: authentic, suspicious, forged, inconclusive. null if not yet reviewed or human review was not required.
​
truth_claim_id
string
The identifier of the truth claim automatically created for this document verification. Format: maip-tc:ULID.
​
receipt_ids
string[]
List of receipt identifiers minted during the verification process. Typically includes the verification receipt and, if applicable, the human review receipt.
​
created_at
string
ISO 8601 timestamp of when the document was submitted.
​
updated_at
string
ISO 8601 timestamp of the last status change.

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
documentId
string<uuid>
required

Document verification identifier

Response

Document verification details

​
verification_id
string<uuid>
​
document_id
string<uuid>
​
document_hash
string
​
status
enum<string>
Available options:
pending,
verified,
failed
​
results
object[]
​
verifications
object[]
​
claims
object[]
​
created_at
string<date-time>