> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Document Verification
> Retrieve the verification status and result for a submitted document
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
The unique identifier of the document verification record. Format:
`maip-doc:ULID`.
### Response
The document verification record identifier.
The agent that submitted the document.
The classification of the document.
The original file name.
The SHA-256 hex digest of the document content.
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)
The AI model's determination. One of: `authentic`, `suspicious`, `forged`,
`inconclusive`. `null` while still processing.
The AI model's confidence in its verdict as a float between `0.0` and `1.0`.
`null` while still processing.
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.
The identifier of the truth claim automatically created for this document
verification. Format: `maip-tc:ULID`.
List of receipt identifiers minted during the verification process. Typically
includes the verification receipt and, if applicable, the human review
receipt.
ISO 8601 timestamp of when the document was submitted.
ISO 8601 timestamp of the last status change.
## OpenAPI
````yaml mint-openapi.yaml GET /v1/truth/document/{documentId}
openapi: 3.0.3
info:
title: Truthlocks API
description: >
Truthlocks is a universal verification infrastructure for documents,
credentials, and digital assets.
This specification defines the canonical API for interacting with Truthlocks
services.
## Base URLs
- **Production**: `https://api.truthlocks.com`
- **Sandbox**: `https://sandbox-api.truthlocks.com`
## Authentication
- **API Keys**: Use `X-API-Key` header for machine-to-machine operations
- **Bearer Tokens**: Use `Authorization: Bearer ` for user-initiated
operations
## Tenant Identity
In production, tenant identity is derived from the authenticated context
(API key or JWT).
The `X-Tenant-ID` header is ignored in production to prevent spoofing.
version: 1.0.0
contact:
name: Truthlocks Support
url: https://truthlocks.com/support
email: support@truthlocks.com
servers:
- url: https://api.truthlocks.com
description: Production API
- url: https://sandbox-api.truthlocks.com
description: Sandbox Environment
security:
- APIKey: []
tags:
- name: Authentication
description: API key and token management
- name: Issuers
description: Issuer registration and trust management
- name: Keys
description: Cryptographic key management for issuers
- name: Attestations
description: Attestation lifecycle (mint, revoke, supersede)
- name: Verification
description: Attestation verification and proof bundles
- name: Governance
description: Issuer governance workflows (admin only)
- name: Identity
description: Organization, user, and role management
- name: Audit
description: Audit event queries
- name: Platform
description: Platform administration (super admin only)
- name: Platform Review
description: Staff review workflows for issuer applications
- name: Tenant Console
description: Tenant profile and lifecycle endpoints
- name: Health
description: Service health and readiness endpoints
- name: Risk
description: Risk signal ingestion and fraud detection
- name: Risk Enforcement
description: Risk enforcement actions — block, challenge, quarantine, and configuration
- name: Billing
description: Billing, subscription, and addon management
- name: Machine Identity
description: >-
Machine Agent Identity Protocol (MAIP) — agent registration, sessions,
trust, witness, compliance, orchestration, and observability
externalDocs:
description: Transparency read-only API (separate service spec)
url: >-
https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
/v1/truth/document/{documentId}:
get:
tags:
- Machine Identity
summary: Get Document Verification
description: >-
Returns the full verification record for a document including all
associated claims.
operationId: maip.truth.document.get
parameters:
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
description: Document verification identifier
responses:
'200':
description: Document verification details
content:
application/json:
schema:
$ref: '#/components/schemas/MaipDocumentVerification'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'404':
description: Document not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
security:
- APIKey: []
components:
schemas:
MaipDocumentVerification:
type: object
properties:
verification_id:
type: string
format: uuid
document_id:
type: string
format: uuid
document_hash:
type: string
status:
type: string
enum:
- pending
- verified
- failed
results:
type: array
items:
type: object
additionalProperties: true
verifications:
type: array
items:
type: object
additionalProperties: true
claims:
type: array
items:
$ref: '#/components/schemas/MaipTruthClaim'
created_at:
type: string
format: date-time
ErrorEnvelope:
type: object
required:
- code
- message
- http_status
properties:
code:
type: string
description: Machine-readable error code
enum:
- AUTH_REQUIRED
- AUTH_INVALID
- PERMISSION_DENIED
- TENANT_IDENTITY_UNVERIFIED
- NOT_FOUND
- VALIDATION_ERROR
- CONFLICT
- PAYLOAD_TOO_LARGE
- RATE_LIMIT_EXCEEDED
- QUOTA_EXCEEDED
- SERVICE_UNAVAILABLE
- INTERNAL_ERROR
message:
type: string
description: Human-readable error message
http_status:
type: integer
description: HTTP status code
retry_after_ms:
type: integer
description: Milliseconds to wait before retrying (for rate limits)
details:
type: object
description: Additional error context
example:
code: AUTH_REQUIRED
message: Authentication required
http_status: 401
MaipTruthClaim:
type: object
properties:
claim_id:
type: string
format: uuid
agent_id:
type: string
format: uuid
claim_type:
type: string
payload:
type: object
additionalProperties: true
evidence:
type: array
items:
type: object
additionalProperties: true
status:
type: string
enum:
- pending
- verified
- rejected
- expired
receipt_id:
type: string
format: uuid
attestations:
type: array
items:
$ref: '#/components/schemas/MaipAttestation'
verified_at:
type: string
format: date-time
created_at:
type: string
format: date-time
MaipAttestation:
type: object
properties:
attestation_id:
type: string
format: uuid
witness_id:
type: string
format: uuid
agent_id:
type: string
format: uuid
claim_hash:
type: string
signature:
type: string
status:
type: string
enum:
- pending
- accepted
- rejected
created_at:
type: string
format: date-time
securitySchemes:
APIKey:
type: apiKey
in: header
name: X-API-Key
description: API key for machine-to-machine authentication
````