Proofs

Retrieve a proof by ID

Returns full status of a proof, including chain transaction hash, anchoring status, and public explorer URLs. Callers can only retrieve proofs they own.

get/api/v1/proof/{id}

Request

  • Base URL: https://proofledger.io
  • URL: https://proofledger.io/api/v1/proof/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

The proof ID returned by POST /api/v1/proof.

Response

Proof retrieved.

idinteger
sha256string
filenamestring
sizeinteger
mimestring
status'approved' | 'pending' | 'pending_review' | 'denied' | 'contested'
review_status'APPROVED' | 'PENDING' | 'PENDING_REVIEW' | 'DENIED' | 'CONTESTED' | 'UNKNOWN'
polygon_status'ANCHORED' | 'PENDING'
bitcoin_status'NOT_REQUESTED' | 'AWAITING_PAYMENT' | 'PENDING' | 'ANCHORED' | 'FAILED'

Legacy field: carries a value only on proofs anchored on Bitcoin before 2026-10-15, when Bitcoin anchoring was discontinued. Null or NOT_REQUESTED on every newer proof.

evidence_readiness'READY_BITCOIN' | 'READY_POLYGON' | 'PENDING_BITCOIN' | 'PENDING_BITCOIN_PAYMENT' | 'PENDING_POLYGON' | 'NEEDS_REVIEW' | 'DENIED' | 'UNKNOWN'
created_atstring date-time
chain_txstring nullable

Polygon transaction hash once anchored.

chain_name'polygon-mainnet' | 'polygon-amoy' | 'null' nullable
bitcoin_txidstring nullable

Legacy field: carries a value only on proofs anchored on Bitcoin before 2026-10-15, when Bitcoin anchoring was discontinued. Null on every newer proof.

bitcoin_anchor_status'NOT_REQUESTED' | 'AWAITING_PAYMENT' | 'PENDING' | 'ANCHORED' | 'FAILED' | 'null' nullable

Legacy field: carries a value only on proofs anchored on Bitcoin before 2026-10-15, when Bitcoin anchoring was discontinued. Null or NOT_REQUESTED on every newer proof.

btc_merkle_rootstring nullable

Legacy field: carries a value only on proofs anchored on Bitcoin before 2026-10-15, when Bitcoin anchoring was discontinued. Null on every newer proof.

btc_payment_status'NONE' | 'INCLUDED' | 'REQUIRED' | 'PAID'

Legacy field: NONE on every proof created since 2026-10-15.

public_cert_idstring nullable
certificate_urlstring uri

Absolute link to the public certificate page.

verification_urlstring uri

Absolute link to the public verification page for this hash.

explorer_urlstring nullable

Polygonscan URL once anchored.

bitcoin_explorer_urlstring nullable

Legacy field: carries a value only on proofs anchored on Bitcoin before 2026-10-15, when Bitcoin anchoring was discontinued. Null on every newer proof.

external_idstring nullable

Your own record id, if one was sent.

polygon_anchored_atstring date-time nullable

When the Polygon transaction was recorded.

issued_viastring nullable

Approved partner name copied onto the proof when it was created ("Recorded through <name> · Anchored by ProofLedger"). Null when not branded.

Example response

{
  "certificate_url": "https://proofledger.io/cert/42",
  "verification_url": "https://proofledger.io/verify.html?hash=a1b2c3..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.