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

Retrieve Digital Passport Data

Get the information of your minted digital passport.

Before you begin

As a brand, say you wish to retrieve all the information such as transactions or content of a digital passport previously minted.

⚠️

If your NFT Management Platform is not the digital passport owner, the passphrase is mandatory to retrieve information.

Let's start 🚀

Use the api/getCertificate defining the parameters you wish to return.

📌

NFT Management Platform user rights required to call this API → certRead

[
  918276735,
  "hm0ncta9lrk4",
  {
    "isRequestable": true,
    "content": true,
    "issuer": {
      "waitingIdentity": false,
      "forceRefresh": false,
      "rpcURI": "https://documentation.arianee.firebaseapp.com/rpc"
    },
    "owner": true,
    "events": true,
    "arianeeEvents": true,
    "advanced": {
      "languages": [
        "fr",
        "us",
        "jp"
      ],
      "arianeeProofToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJFVEgifQ==.eyJpc3MiOiIweGJiNDEwRDM1RUMwMDBhNTEwMEZlOTM5QjQxZkEyOTk3OTc5OUQzNDIiLCJzY29wZSI6ImFsbCIsImV4cCI6MTYwMDE2MDEwODUwMywiaWF0IjoxNjAwMTU5ODA4NTA0LCJjaGFpbiI6Im1haW5uZXQiLCJzdWIiOiJjZXJ0aWZpY2F0ZSIsInN1YklkIjo4NzYxNTMxfQ==.0x0a9e3f2c769631b7b9f2a41c3e26262388b0868d3972c0067630ddd846acaba90e0686efcd049fdcd5a6cac97530730328a7cbdf1b19c7996491bba1287db0781c"
    },
    "messageSenders": true
  }
]
InputMandatoryTypeDescription
certificateIdNumberDigital passport identification number
passphraseStringDigital passport passphrase
isRequestableBooleanDigital passport claim information
contentBooleanNFT content information
issuerObjectIssuer information
rpcURIURIRPC URI
ownerBooleanDigital passport current owner information
eventsBooleanInformation on digital passport transactions and lifecycle
arianeeEventsBooleanInformation on Arianee events linked to the digital passport
advancedObjectAdvanced parameters
languagesObjectLanguages of the digital passport
arianeeProofTokenStringToken with the right to claim digital passport ownership
messageSendersBooleanWallet message sender wallet address

Result: The digital passport information is returned.

{
    "certificateId": 918276735,
    "content": {
        "isRawAuthentic": false,
        "isAuthentic": false
    },
    "issuer": {
        "identity": {
            "data": {
                "$schema": "https://cert.arianee.org/version2/ArianeeBrandIdentity-i18n.json",
                "name": "NFT name",
                "companyName": "Arianee",
                "arianeeMembership": "associate_member",
                "rpcEndpoint": "https://documentation.arianee.api.staging.arianee.com/rpc"
            },
            "isAuthentic": true,
            "isApproved": true,
            "imprint": "0xdfee9c6b92e2cb9a5fc6b4b394f46926510fc66db9faa694c53c61d4307cf883",
            "address": "0x57F5111A7e997a7Ba63CC8976C92decbd86C1B08"
        },
        "isIdentityAuthentic": true,
        "isIdentityVerified": true,
        "imprint": "0xdfee9c6b92e2cb9a5fc6b4b394f46926510fc66db9faa694c53c61d4307cf883"
    },
    "isRequestable": true,
    "owner": {
        "publicKey": "0x57f5111a7e997a7ba63cc8976c92decbd86c1b08",
        "address": "0x57f5111a7e997a7ba63cc8976c92decbd86c1b08",
        "isOwner": true
    },
    "events": {
        "transfer": [
            {
                "identity": {
                    "data": {
                        "$schema": "https://cert.arianee.org/version2/ArianeeBrandIdentity-i18n.json",
                        "name": "NFT name",
                        "companyName": "Arianee",
                        "arianeeMembership": "associate_member",
                        "rpcEndpoint": "https://documentation.arianee.api.staging.arianee.com/rpc"
                    },
                    "isAuthentic": true,
                    "isApproved": true,
                    "imprint": "0xdfee9c6b92e2cb9a5fc6b4b394f46926510fc66db9faa694c53c61d4307cf883",
                    "address": "0x57F5111A7e997a7Ba63CC8976C92decbd86C1B08"
                },
                "address": "0x512C1FCF401133680f373a386F3f752b98070BC5",
                "blockHash": "0x60c9060e2bf7401f331c192c81fc158044205aeaf69a687b928c1873fd45e389",
                "blockNumber": 28540658,
                "logIndex": 1,
                "removed": false,
                "transactionHash": "0x379087fde6ce640029cef9306874ae1875fe4b6e625d3e187b2f735c4b46e612",
                "transactionIndex": 0,
                "transactionLogIndex": "0x1",
                "id": "log_92acbcba",
                "returnValues": {
                    "0": "0x0000000000000000000000000000000000000000",
                    "1": "0x57F5111A7e997a7Ba63CC8976C92decbd86C1B08",
                    "2": "918276735",
                    "_from": "0x0000000000000000000000000000000000000000",
                    "_to": "0x57F5111A7e997a7Ba63CC8976C92decbd86C1B08",
                    "_tokenId": "918276735"
                },
                "event": "Transfer",
                "signature": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "raw": {
                    "data": "0x",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "0x00000000000000000000000057f5111a7e997a7ba63cc8976c92decbd86c1b08",
                        "0x0000000000000000000000000000000000000000000000000000000036bbca7f"
                    ]
                },
                "timestamp": 1675864990
            }
        ],
        "arianeeEvents": []
    },
    "messageSenders": {
        "0x57F5111A7e997a7Ba63CC8976C92decbd86C1B08": true
    }
}

⚠️

When the return is empty, you certificateId may be incorrect.

{
    "certificateId": 76608909993,
    "events": {
        "transfer": [],
        "arianeeEvents": []
    }
}