Verify a Proof of Ownership export

POST

address_registry

proof_of_ownership_exports

verify

TypeScript

const response: Promise<FireblocksResponse<AddressRegistryVerifyProofOfOwnershipResponse>> = fireblocks.compliance.verifyAddressRegistryProofOfOwnership(complianceApiVerifyAddressRegistryProofOfOwnershipRequest);

CompletableFuture<ApiResponse<AddressRegistryVerifyProofOfOwnershipResponse>> response = fireblocks.compliance().verifyAddressRegistryProofOfOwnership(addressRegistryVerifyProofOfOwnershipRequest, idempotencyKey);

curl --request POST \
  --url https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify \
  --header 'Content-Type: application/json' \
  --data '
{
  "exportId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "verificationHash": "BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA",
  "address": "0x742d35cc6634c0532925a3b844bc9e7595f0beb0",
  "expiresAt": "2027-08-17"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    exportId: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
    verificationHash: 'BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA',
    address: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
    expiresAt: '2027-08-17'
  })
};

fetch('https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'exportId' => '3fa85f64-5717-4562-b3fc-2c963f66afa6',
    'verificationHash' => 'BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA',
    'address' => '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
    'expiresAt' => '2027-08-17'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify"

	payload := strings.NewReader("{\n  \"exportId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"verificationHash\": \"BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA\",\n  \"address\": \"0x742d35cc6634c0532925a3b844bc9e7595f0beb0\",\n  \"expiresAt\": \"2027-08-17\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"exportId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"verificationHash\": \"BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA\",\n  \"address\": \"0x742d35cc6634c0532925a3b844bc9e7595f0beb0\",\n  \"expiresAt\": \"2027-08-17\"\n}"

response = http.request(request)
puts response.read_body

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

{
  "message": "<string>",
  "code": 123
}

{
  "message": "<string>",
  "code": 123
}

Headers

Idempotency-Key

string

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.

Body

application/json

Request body for verifying an Address Registry Proof of Ownership export.

exportId

string<uuid>

required

Export id from create / the PDF.

Minimum string length: 1

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

verificationHash

string

required

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

Minimum string length: 1

Example:

"BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA"

address

string

required

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

Minimum string length: 1

Example:

"0x742d35cc6634c0532925a3b844bc9e7595f0beb0"

expiresAt

string

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.

Pattern: ^$|^\d{4}-\d{2}-\d{2}$

Example:

"2027-08-17"

Response

Verification result

Online verification result. Authenticated calls always return HTTP 200 with this body (valid: true or valid: false); unknown/expired exports do not use 404.

valid

boolean

required

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

Example:

true

expiresAt

string

required

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

Example:

"2027-08-17"

⌘I

TypeScript

const response: Promise<FireblocksResponse<AddressRegistryVerifyProofOfOwnershipResponse>> = fireblocks.compliance.verifyAddressRegistryProofOfOwnership(complianceApiVerifyAddressRegistryProofOfOwnershipRequest);

CompletableFuture<ApiResponse<AddressRegistryVerifyProofOfOwnershipResponse>> response = fireblocks.compliance().verifyAddressRegistryProofOfOwnership(addressRegistryVerifyProofOfOwnershipRequest, idempotencyKey);

curl --request POST \
  --url https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify \
  --header 'Content-Type: application/json' \
  --data '
{
  "exportId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "verificationHash": "BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA",
  "address": "0x742d35cc6634c0532925a3b844bc9e7595f0beb0",
  "expiresAt": "2027-08-17"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    exportId: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
    verificationHash: 'BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA',
    address: '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
    expiresAt: '2027-08-17'
  })
};

fetch('https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'exportId' => '3fa85f64-5717-4562-b3fc-2c963f66afa6',
    'verificationHash' => 'BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA',
    'address' => '0x742d35cc6634c0532925a3b844bc9e7595f0beb0',
    'expiresAt' => '2027-08-17'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify"

	payload := strings.NewReader("{\n  \"exportId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"verificationHash\": \"BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA\",\n  \"address\": \"0x742d35cc6634c0532925a3b844bc9e7595f0beb0\",\n  \"expiresAt\": \"2027-08-17\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/address_registry/proof_of_ownership_exports/verify")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"exportId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"verificationHash\": \"BHS2QaqGyYegvLBy5qrGhrES3A2n5JPD7ubpgJozRgeA\",\n  \"address\": \"0x742d35cc6634c0532925a3b844bc9e7595f0beb0\",\n  \"expiresAt\": \"2027-08-17\"\n}"

response = http.request(request)
puts response.read_body

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

{
  "message": "<string>",
  "code": 123
}

{
  "message": "<string>",
  "code": 123
}

Introduction

Errors & Statuses

Data Objects

API Endpoints

Headers

Body

Response