FIfireblocks
Compliance

Create a Proof of Ownership PDF for an address

Creates a Proof of Ownership PDF for a blockchain address owned by the authenticated workspace — for example, to share with a counterparty or bank as compliance evidence. Recipients can confirm it with POST /v1/address_registry/proof_of_ownership_exports/verify.

Check proofOfOwnershipAvailable on GET /v1/address_registry/legal_entities/{address} first if you want to know whether create is likely to succeed.

post/address_registry/proof_of_ownership_exports

Request

Headers

Idempotency-Keystring

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Request body

addressstring required

Blockchain address to prove ownership for (must resolve to the caller's workspace). Same format expectations as the address path parameter on GET /v1/address_registry/legal_entities/{address}.

Example request

{
  "address": "0x742d35cc6634c0532925a3b844bc9e7595f0beb0"
}

Response

PDF export created

pdfstring byte required

Base64-encoded Proof of Ownership PDF bytes. Fireblocks does not store the PDF: save it immediately, there is no re-download route.

exportIdstring uuid required

Stable id of the online-verifiable export record.

verificationHashstring required

Verification hash bound to the export (also printed on the PDF).

expiresAtstring required

Inclusive last UTC calendar day online verification is available (YYYY-MM-DD).

Example response

{
  "pdf": "JVBERi0xLjQK...",
  "exportId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "verificationHash": "BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA",
  "expiresAt": "2027-08-17"
}

Changes

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