These docs are for v1.7. Click to read the latest docs for v2.1.

Recover Digital Passport

Claim back your digital passport in your wallet.

Before you begin

Under specific conditions and for a limited period, brands can reclaim the ownership of a digital passport that is owned by another wallet.

Use case examples:

  • The product is declared and proven to be stolen or lost.
  • The product is returned.
  • The owner has lost the digital passport.

⚠️

Each recovered digital passport spends 1 credit.

Limitation

You can recover one digital passport at once per API call.

Let's start 🚀

To recover a digital passport in your wallet, use the api/recoverCertificate.

📌

The API is authenticated with the user rights required → certRecover

InputMandatoryTypeDescription
certificateIdStringIdentification number of the digital passport to recover.
curl --request POST \
     --url https://documentation.arianee.com/api/recoverCertificate \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '[650923746]'

Result: The digital passport has been recovered. You'll get ownership back when the transaction is validated by the blockchain.

{
  "message": "Not yet in blockchain => transaction saved in transaction manager",
  "type": "transactionManager",
  "transactionId": "63b26e95053b19996d5398c8",
  "nonce": 58842,
  "chainId": 77,
  "from": "0x57F5111A7e997a7Ba63CC8976C92decbd86C1B08",
  "data": "0xb5aaa9d50000000000000000000000000000000000000000000000000000000026cc4ee2",
  "to": "0x512C1FCF401133680f373a386F3f752b98070BC5",
  "gasLimit": 500000,
  "gasPrice": "48000000000",
  "value": "0x00"