Report Digital Passports Transfers

As a brand, you wish to get a report about the ownership transfers of your distributed digital passports during a given period.

URL

To display all transactions during a specified period, use the api/reports/certificate/pastTransfer.

GET - https://{{nmpUrl}}/api/reports/certificate/pastTransfer

๐Ÿ“Œ

The API is authenticated with the user rights required โ†’ certCreate

Query ParametersTypeRequiredDescription
fromTimestampYYYY-MM-DDTHH:MM:SSZโœ…Reporting starting date
toTimestampYYYY-MM-DDTHH:MM:SSZโœ…Reporting ending date

Return Payload

JSON is returned containing all the digital passports involved and their information.

FieldTypeDescription
tokenIdNumberDigital passport identification number.
ownerStringWallet address of the current digital passport owner.
issuerStringWallet address of the digital passport issuer.
networkStringNetwork on which the digital passport has been minted.
FirstTransferTimestampYYYY-MM-DDTHH:MM:SSZFirst digital passport transfer timestamp.
LastTransferTimestampYYYY-MM-DDTHH:MM:SSZLast digital passport transfer timestamp.
transferCountNumberCount of digital passport transfers.
{
    "query": {
        "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
        "fromTimestamp": "2023-03-07T20:05:25Z",
        "toTimestamp": "2023-06-08T20:05:25Z"
    },
    "result": [
        [
            {
                "tokenId": 72717589,
                "timestamp": "2023-03-08 10:38:15+00",
                "certTimestamp": {
                    "value": "2023-03-08T10:38:15.000Z"
                },
                "blockNumber": "29022038",
                "owner": "0xF0d4dbDf6389619bEeFa8803De9118869427853D",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1678271895,
                "LastTransferTimestamp": 1678271895
            },
            {
                "tokenId": 48664926,
                "timestamp": "2023-03-08 16:15:15+00",
                "certTimestamp": {
                    "value": "2023-03-08T16:15:15.000Z"
                },
                "blockNumber": "29026082",
                "owner": "0xdCeF355303C34f8C75852d7133c9f65DE11fB393",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1678292115,
                "LastTransferTimestamp": 1678292115
            },
            {
                "tokenId": 15735060,
                "timestamp": "2023-03-09 10:00:40+00",
                "certTimestamp": {
                    "value": "2023-03-09T10:00:40.000Z"
                },
                "blockNumber": "29038867",
                "owner": "0xA9Bc90D24D0b8495043Ab5857455444630028CAF",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 2,
                "FirstTransferTimestamp": 1678356040,
                "LastTransferTimestamp": 1690474070
            },
            {
                "tokenId": 78642977,
                "timestamp": "2023-03-09 16:56:30+00",
                "certTimestamp": {
                    "value": "2023-03-09T16:56:30.000Z"
                },
                "blockNumber": "29043857",
                "owner": "0x8e5BF9fdd4fA2e79A9c5f48f6C33B8a718a2ac9B",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1678380990,
                "LastTransferTimestamp": 1678380990
            },
            {
                "tokenId": 61378362,
                "timestamp": "2023-03-09 19:44:55+00",
                "certTimestamp": {
                    "value": "2023-03-09T19:44:55.000Z"
                },
                "blockNumber": "29045878",
                "owner": "0xA9Bc90D24D0b8495043Ab5857455444630028CAF",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 2,
                "FirstTransferTimestamp": 1678391095,
                "LastTransferTimestamp": 1687273940
            },
            {
                "tokenId": 945758489,
                "timestamp": "2023-03-20 13:23:25+00",
                "certTimestamp": {
                    "value": "2023-03-20T13:23:25.000Z"
                },
                "blockNumber": "29231380",
                "owner": "0x0A063fD490e270df1249dC1244dAf5bAe0aF21b9",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1679318605,
                "LastTransferTimestamp": 1679318605
            },
            {
                "tokenId": 78556056,
                "timestamp": "2023-03-27 08:01:00+00",
                "certTimestamp": {
                    "value": "2023-03-27T08:01:00.000Z"
                },
                "blockNumber": "29348470",
                "owner": "0x5D1e2E92488b9911C08a559ad9E3A8bD0F31B2F4",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1679904060,
                "LastTransferTimestamp": 1679904060
            },
            {
                "tokenId": 65482975,
                "timestamp": "2023-03-27 08:02:20+00",
                "certTimestamp": {
                    "value": "2023-03-27T08:02:20.000Z"
                },
                "blockNumber": "29348486",
                "owner": "0xC29cEFb275012B60b9da6814f1325a36BB01775F",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1679904140,
                "LastTransferTimestamp": 1679904140
            },
            {
                "tokenId": 80287039,
                "timestamp": "2023-03-27 08:02:40+00",
                "certTimestamp": {
                    "value": "2023-03-27T08:02:40.000Z"
                },
                "blockNumber": "29348490",
                "owner": "0x5877CF3631E4370263f1116aaC383DfA49605E31",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1679904160,
                "LastTransferTimestamp": 1679904160
            },
            {
                "tokenId": 39543907,
                "timestamp": "2023-03-27 08:02:55+00",
                "certTimestamp": {
                    "value": "2023-03-27T08:02:55.000Z"
                },
                "blockNumber": "29348493",
                "owner": "0x09D8a6DF3380b0E7a76213a75b51f39180c7Fe6C",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1679904175,
                "LastTransferTimestamp": 1679904175
            },
            {
                "tokenId": 33171105,
                "timestamp": "2023-03-27 08:29:15+00",
                "certTimestamp": {
                    "value": "2023-03-27T08:29:15.000Z"
                },
                "blockNumber": "29348809",
                "owner": "0x72d43520eb5543F88354768Cd835C1d72928C642",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1679905755,
                "LastTransferTimestamp": 1679905755
            },
            {
                "tokenId": 87311880,
                "timestamp": "2023-04-05 15:18:05+00",
                "certTimestamp": {
                    "value": "2023-04-05T15:18:05.000Z"
                },
                "blockNumber": "29509235",
                "owner": "0x51a943ee0234229b7E9B09D54c4D6363eedA74bE",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1680707885,
                "LastTransferTimestamp": 1680707885
            },
            {
                "tokenId": 709090040,
                "timestamp": "2023-04-13 09:28:05+00",
                "certTimestamp": {
                    "value": "2023-04-13T09:28:05.000Z"
                },
                "blockNumber": "29643274",
                "owner": "0x752138d452135d4aAD40658DFd72fF3854894128",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1681378085,
                "LastTransferTimestamp": 1681378085
            },
            {
                "tokenId": 92335950,
                "timestamp": "2023-04-13 11:54:20+00",
                "certTimestamp": {
                    "value": "2023-04-13T11:54:20.000Z"
                },
                "blockNumber": "29645029",
                "owner": "0xf5894f285b8F8CE2246eCdE28fA10547F41119D6",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 3,
                "FirstTransferTimestamp": 1681386860,
                "LastTransferTimestamp": 1681917110
            },
            {
                "tokenId": 92335950,
                "timestamp": "2023-04-13 12:18:05+00",
                "certTimestamp": {
                    "value": "2023-04-13T12:18:05.000Z"
                },
                "blockNumber": "29645314",
                "owner": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": true,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 3,
                "FirstTransferTimestamp": 1681386860,
                "LastTransferTimestamp": 1681917110
            },
            {
                "tokenId": 92335950,
                "timestamp": "2023-04-19 15:11:50+00",
                "certTimestamp": {
                    "value": "2023-04-19T15:11:50.000Z"
                },
                "blockNumber": "29751078",
                "owner": "0x4843313CFA764e9C4857F28c00583862f6Ef2Ec9",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 3,
                "FirstTransferTimestamp": 1681386860,
                "LastTransferTimestamp": 1681917110
            },
            {
                "tokenId": 36754654,
                "timestamp": "2023-04-20 08:15:50+00",
                "certTimestamp": {
                    "value": "2023-04-20T08:15:50.000Z"
                },
                "blockNumber": "29763366",
                "owner": "0x0A3f51a0bc781Db42Ce0B58CDD7C61547Fe49bBd",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1681978550,
                "LastTransferTimestamp": 1681978550
            },
            {
                "tokenId": 42371964,
                "timestamp": "2023-05-10 14:03:40+00",
                "certTimestamp": {
                    "value": "2023-05-10T14:03:40.000Z"
                },
                "blockNumber": "30092307",
                "owner": "0x71c4f5331745532705e4D51EB6F773e9C762c51a",
                "issuer": "0x305051e9a023fe881EE21cA43fd90c460B427Caa",
                "network": "testnet",
                "chainid": 77,
                "isIssuerOwner": false,
                "isDetroyed": false,
                "eventName": "Transfer",
                "isHostedWallet": false,
                "transferCount": 1,
                "FirstTransferTimestamp": 1683727420,
                "LastTransferTimestamp": 1683727420
            }
        ]
    ]
}