POST /api/v1/verifyhash

Verify a file hash against a stored proof using its proof key. Requires API key.

Headers

Header	Required	Description
`X-API-Key`	Yes	Your API key

Request Body

{
  "hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "proofKey": "550e8400-e29b-41d4-a716-446655440000"
}

Response

{
  "hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "filename": "document.pdf",
  "description": "Q1 financial report",
  "timestamp": "2026-04-03T12:00:00Z",
  "verified": "PARTIAL"
}

verified values

Value	Meaning
`VERIFIED`	RFC 3161 certificate valid AND Bitcoin blockchain confirmed
`PARTIAL`	RFC 3161 certificate valid, blockchain anchor not yet confirmed
`FAILED`	Hash mismatch or invalid certificate

Error Codes

Status	Condition
400	Invalid hash format or missing proof key
401	Missing or invalid API key
404	Proof not found for given proof key
429	Rate limit exceeded

cURL Example

curl -X POST https://proofintegrity.net/api/v1/verifyhash \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "proofKey": "550e8400-e29b-41d4-a716-446655440000"
  }'

API Docs

POST /api/v1/verifyhash