Skip to main content
GET
/
v1
/
attestations
/
{id}
/
proof-bundle
Get Proof Bundle
curl --request GET \
  --url https://api.truthlocks.com/v1/attestations/{id}/proof-bundle \
  --header 'X-API-Key: <api-key>'
{
  "bundle_id": "bun_a1b2c3d4...",
  "bundle_version": "1.0",
  "generated_at": "2026-03-25T14:30:00Z",
  "tenant_id": "ten_x9y8z7...",
  "attestation": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "issuer_id": "550e8400-e29b-41d4-a716-446655440000",
    "kid": "ed-key-1",
    "status": "VALID",
    "payload": {
      "subject": "user:12345",
      "claim": "verified_email",
      "value": "user@example.com"
    },
    "content_hash": "sha256:a1b2c3d4e5f6...",
    "document_hash_hex": "a1b2c3d4e5f6...",
    "signature": "MEUCIQDf7KxF5bXmz...",
    "log_index": 42,
    "created_at": "2026-01-13T12:00:00Z"
  },
  "issuer": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme University",
    "did": "did:truthlock:550e8400-e29b-41d4-a716-446655440000",
    "domain": "acme.edu",
    "trust_level": "VERIFIED"
  },
  "key": {
    "kid": "ed-key-1",
    "algorithm": "Ed25519",
    "public_key": "MCowBQYDK2VwAyEA..."
  },
  "inclusion_proof": {
    "log_index": 42,
    "root_hash": "sha256:abc123...",
    "hashes": ["hash1", "hash2", "hash3"]
  },
  "signed_tree_head": {
    "tree_size": 1000,
    "root_hash": "sha256:abc123...",
    "signature": "MEQCIFxhQ7..."
  },
  "bundle_hash_b64url": "dGhpcyBpcyBhIGJhc2U2NHVybC1lbmNvZGVk..."
}
Returns a complete proof bundle for offline verification. Includes the attestation, issuer information, public key, transparency log inclusion proof, and signed tree head.

Parameters

id
uuid
required
Attestation ID

Responses

{
  "bundle_id": "bun_a1b2c3d4...",
  "bundle_version": "1.0",
  "generated_at": "2026-03-25T14:30:00Z",
  "tenant_id": "ten_x9y8z7...",
  "attestation": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "issuer_id": "550e8400-e29b-41d4-a716-446655440000",
    "kid": "ed-key-1",
    "status": "VALID",
    "payload": {
      "subject": "user:12345",
      "claim": "verified_email",
      "value": "user@example.com"
    },
    "content_hash": "sha256:a1b2c3d4e5f6...",
    "document_hash_hex": "a1b2c3d4e5f6...",
    "signature": "MEUCIQDf7KxF5bXmz...",
    "log_index": 42,
    "created_at": "2026-01-13T12:00:00Z"
  },
  "issuer": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme University",
    "did": "did:truthlock:550e8400-e29b-41d4-a716-446655440000",
    "domain": "acme.edu",
    "trust_level": "VERIFIED"
  },
  "key": {
    "kid": "ed-key-1",
    "algorithm": "Ed25519",
    "public_key": "MCowBQYDK2VwAyEA..."
  },
  "inclusion_proof": {
    "log_index": 42,
    "root_hash": "sha256:abc123...",
    "hashes": ["hash1", "hash2", "hash3"]
  },
  "signed_tree_head": {
    "tree_size": 1000,
    "root_hash": "sha256:abc123...",
    "signature": "MEQCIFxhQ7..."
  },
  "bundle_hash_b64url": "dGhpcyBpcyBhIGJhc2U2NHVybC1lbmNvZGVk..."
}

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

id
string<uuid>
required

Response

Proof bundle

attestation
object
issuer
object
key
object
inclusion_proof
object
signed_tree_head
object