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

Read Digital Passport History

Allow your users to to track the history of their digital passports.

Before you begin

As a brand, you wish to allow your users to track their digital passports and get information on their lifecycle.

Let's start 🚀

To fetch the authenticity, use the wallet/getCertificate.

InputMandatoryTypeDescription
certificateIdNumberDigital passport identification number.
passphraseObjectDigital passport access passphrase.

📌

The passphrase is optional only if the requester is the owner.

curl -X POST "https://custodial.arianee.com/testnet/wallet/getCertificate" -H  "accept: application/json" -H  "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpX..." -H  "Content-Type: application/json" -d "[983002786,\"qoy7bdpri6me5\"]"

Result: The digital passport information is returned.

Example:

{
    "certificateId": 19118567,
    "content": {
        "isRawAuthentic": false,
        "isAuthentic": false
    },
    "issuer": {
        "identity": {
            "data": {
                "$schema": "https://cert.arianee.org/version2/ArianeeBrandIdentity-i18n.json",
                "name": "BDh maxime",
                "description": "test",
                "externalContents": [
                    {
                        "type": "hostedWallet"
                    }
                ],
                "pictures": [
                    {
                        "type": "brandLogoSquare",
                        "url": "https://bdh-maxime.api.staging.arianee.com/pub/1673276288690-logo-square.png"
                    },
                    {
                        "type": "brandLogoHeaderReversed",
                        "url": "https://bdh-techteam-poa.api.arianee.com/pub/1673278167514-logo-white.png"
                    },
                    {
                        "type": "brandLogoHeader",
                        "url": "https://bdh-techteam-poa.api.arianee.com/pub/1673278152066-logo-black.png"
                    }
                ],
                "providers": [
                    {
                        "type": "missing",
                        "address": "0x9622D4C5FD7B7238D81EC46D57035B2c1f2B9BDE",
                        "url": "https://resell.arianee.org/"
                    }
                ],
                "rpcEndpoint": "https://bdh-maxime.api.staging.arianee.com/rpc"
            },
            "isAuthentic": true,
            "isApproved": true,
            "imprint": "0x02abef525cd3721fb1b985483e02f4a63bdca38800dfedb45dd1fc06170a724f",
            "address": "0x305051e9a023fe881EE21cA43fd90c460B427Caa"
        },
        "isIdentityAuthentic": true,
        "isIdentityVerified": true,
        "imprint": "0x02abef525cd3721fb1b985483e02f4a63bdca38800dfedb45dd1fc06170a724f"
    },
    "isRequestable": false,
    "owner": {
        "publicKey": "0x8ce250a8d46e8f961c832908c9e604fe9eb7952b",
        "address": "0x8ce250a8d46e8f961c832908c9e604fe9eb7952b",
        "isOwner": false
    },
    "events": {
        "transfer": [
            {
                "identity": {
                    "data": {
                        "$schema": "https://cert.arianee.org/version2/ArianeeBrandIdentity-i18n.json",
                        "name": "BDh maxime",
                        "description": "test",
                        "externalContents": [
                            {
                                "type": "hostedWallet"
                            }
                        ],
                        "pictures": [
                            {
                                "type": "brandLogoSquare",
                                "url": "https://bdh-maxime.api.staging.arianee.com/pub/1673276288690-logo-square.png"
                            },
                            {
                                "type": "brandLogoHeaderReversed",
                                "url": "https://bdh-techteam-poa.api.arianee.com/pub/1673278167514-logo-white.png"
                            },
                            {
                                "type": "brandLogoHeader",
                                "url": "https://bdh-techteam-poa.api.arianee.com/pub/1673278152066-logo-black.png"
                            }
                        ],
                        "providers": [
                            {
                                "type": "missing",
                                "address": "0x9622D4C5FD7B7238D81EC46D57035B2c1f2B9BDE",
                                "url": "https://resell.arianee.org/"
                            }
                        ],
                        "rpcEndpoint": "https://bdh-maxime.api.staging.arianee.com/rpc"
                    },
                    "isAuthentic": true,
                    "isApproved": true,
                    "imprint": "0x02abef525cd3721fb1b985483e02f4a63bdca38800dfedb45dd1fc06170a724f",
                    "address": "0x305051e9a023fe881EE21cA43fd90c460B427Caa"
                },
                "address": "0x512C1FCF401133680f373a386F3f752b98070BC5",
                "blockHash": "0x83a870a02b259c81e7e69395a4620c1b7d28ee3d73f30278e3fcfc1149f4d6cf",
                "blockNumber": 30918624,
                "logIndex": 1,
                "removed": false,
                "transactionHash": "0x368abfb6004a41b2c492f241e81d496a0fb667c12b1575878e38172c00c5e65a",
                "transactionIndex": 0,
                "transactionLogIndex": "0x1",
                "id": "log_f72bd859",
                "returnValues": {
                    "0": "0x0000000000000000000000000000000000000000",
                    "1": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                    "2": "19118567",
                    "_from": "0x0000000000000000000000000000000000000000",
                    "_to": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                    "_tokenId": "19118567"
                },
                "event": "Transfer",
                "signature": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "raw": {
                    "data": "0x",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "0x000000000000000000000000305051e9a023fe881ee21ca43fd90c460b427caa",
                        "0x000000000000000000000000000000000000000000000000000000000123b9e7"
                    ]
                },
                "timestamp": 1688472595
            },
            {
                "identity": {
                    "isAuthentic": false,
                    "isApproved": false,
                    "address": "0x8Ce250a8D46E8f961C832908c9E604FE9Eb7952B"
                },
                "address": "0x512C1FCF401133680f373a386F3f752b98070BC5",
                "blockHash": "0x685216732280f1b937fdfc6ace916e1231d3349a7368185dfb95fac2bcce27ec",
                "blockNumber": 32264243,
                "logIndex": 1,
                "removed": false,
                "transactionHash": "0x658e38c0771c535a2b21c52d0234981727333f793215a386300bb90b42cf93fd",
                "transactionIndex": 2,
                "transactionLogIndex": "0x0",
                "id": "log_40def36c",
                "returnValues": {
                    "0": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                    "1": "0x8Ce250a8D46E8f961C832908c9E604FE9Eb7952B",
                    "2": "19118567",
                    "_from": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                    "_to": "0x8Ce250a8D46E8f961C832908c9E604FE9Eb7952B",
                    "_tokenId": "19118567"
                },
                "event": "Transfer",
                "signature": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "raw": {
                    "data": "0x",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x000000000000000000000000305051e9a023fe881ee21ca43fd90c460b427caa",
                        "0x0000000000000000000000008ce250a8d46e8f961c832908c9e604fe9eb7952b",
                        "0x000000000000000000000000000000000000000000000000000000000123b9e7"
                    ]
                },
                "timestamp": 1695201285
            }
        ],
        "arianeeEvents": [
            {
                "certificateId": 19118567,
                "timestamp": 1695201335,
                "issuer": {
                    "isIdentityVerified": true,
                    "isIdentityAuthentic": true,
                    "imprint": "0x02abef525cd3721fb1b985483e02f4a63bdca38800dfedb45dd1fc06170a724f",
                    "identity": {
                        "data": {
                            "$schema": "https://cert.arianee.org/version2/ArianeeBrandIdentity-i18n.json",
                            "name": "BDh maxime",
                            "description": "test",
                            "externalContents": [
                                {
                                    "type": "hostedWallet"
                                }
                            ],
                            "pictures": [
                                {
                                    "type": "brandLogoSquare",
                                    "url": "https://bdh-maxime.api.staging.arianee.com/pub/1673276288690-logo-square.png"
                                },
                                {
                                    "type": "brandLogoHeaderReversed",
                                    "url": "https://bdh-techteam-poa.api.arianee.com/pub/1673278167514-logo-white.png"
                                },
                                {
                                    "type": "brandLogoHeader",
                                    "url": "https://bdh-techteam-poa.api.arianee.com/pub/1673278152066-logo-black.png"
                                }
                            ],
                            "providers": [
                                {
                                    "type": "missing",
                                    "address": "0x9622D4C5FD7B7238D81EC46D57035B2c1f2B9BDE",
                                    "url": "https://resell.arianee.org/"
                                }
                            ],
                            "rpcEndpoint": "https://bdh-maxime.api.staging.arianee.com/rpc"
                        },
                        "isAuthentic": true,
                        "isApproved": true,
                        "imprint": "0x02abef525cd3721fb1b985483e02f4a63bdca38800dfedb45dd1fc06170a724f",
                        "address": "0x305051e9a023fe881EE21cA43fd90c460B427Caa"
                    }
                },
                "arianeeEventId": "580370453",
                "content": {
                    "isAuthentic": false
                },
                "pending": false
            }
        ]
    },
    "messageSenders": {
        "0x305051e9a023fe881EE21cA43fd90c460B427Caa": true
    }
}