FIfireblocks
Compliance

Verify a Proof of Ownership export

Verifies a Proof of Ownership export against the record Fireblocks stored at creation. Returns valid: false (not 404) for an unknown, expired, or mismatched export. Available to any authenticated Fireblocks workspace, not just the export's original owner.

post/address_registry/proof_of_ownership_exports/verify

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

exportIdstring uuid required

Export id from create / the PDF.

verificationHashstring required

Verification hash from create / the PDF (exact match required).

addressstring required

Address from the PDF (exact UTF-8 match to the stored export).

expiresAtstring

Optional but recommended: the PDF's "Online verification available until" date (YYYY-MM-DD), which speeds up the lookup. A wrong value yields valid: false even if the export exists — copy it exactly from the PDF, or omit it.

Example request

{
  "exportId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "verificationHash": "BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA",
  "address": "0x742d35cc6634c0532925a3b844bc9e7595f0beb0",
  "expiresAt": "2027-08-17"
}

Response

Verification result

validboolean required

Whether the stored export matches the supplied verification hash and address within retention.

expiresAtstring required

Inclusive last UTC calendar day (YYYY-MM-DD) when valid is true; empty string when valid is false.

Example response

{
  "valid": true,
  "expiresAt": "2027-08-17"
}

Changes

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