GET /api/v1/proof/{hash}
Retrieve proof details by SHA-256 hash. Requires API key.
Headers
| Header | Required | Description |
|---|---|---|
X-API-Key | Yes | Your API key |
Response
{
"hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"certificate": "MIIGnAYJKo...",
"otsProof": "AE9wZW5UaW1l...",
"otsStatus": "COMPLETE",
"otsBlockTime": 1754500000,
"otsBlockHeight": 874123,
"filename": "document.pdf",
"description": "Q1 financial report",
"timestamp": "2026-04-03T12:00:00Z"
}Response Fields
| Field | Type | Description |
|---|---|---|
hash | string | SHA-256 hex |
certificate | string | Base64-encoded RFC 3161 token (.tsr) |
otsProof | string | Base64-encoded OpenTimestamps proof. Complete proof preferred; pending proof returned before Bitcoin confirmation. null if OTS anchoring was skipped or failed. |
otsStatus | string | PENDING / COMPLETE / FAILED / null |
otsBlockTime | number | Unix seconds of the Bitcoin block that anchored the proof. null until confirmation. |
otsBlockHeight | number | Bitcoin block height. null until confirmation. |
filename | string | Original filename (optional, nullable) |
description | string | User-provided description (optional, nullable) |
timestamp | string | RFC 3161 genTime (UTC ISO-8601) |
Error Codes
| Status | Condition |
|---|---|
| 400 | Invalid hash format |
| 401 | Missing or invalid API key |
| 404 | Proof not found |
| 429 | Rate limit exceeded |
cURL Example
curl https://proofintegrity.net/api/v1/proof/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 \
-H "X-API-Key: your-api-key-here"