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

Report Digital Passports Transfers

Track transactions in a given time period.

Before you begin

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

Let's start 🚀

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

📌

The API is authenticated with the user rights required → certCreate

InputMandatoryTypeDescription
fromTimestampYYYY-MM-DDTHH:MM:SSZReporting starting date
toTimestampYYYY-MM-DDTHH:MM:SSZReporting ending date
curl --request GET \
     --url 'https://documentation.arianee.com/reports/certificates/pastTransfer?fromTimestamp=2022-06-07T20%253A05%253A25Z&toTimestamp=2022-06-08T20%253A05%253A25Z' \
     --header 'accept: application/json' \
     --header 'x-api-key: string'

Result:

CSV file containing all the NFTs involved and their information such as:

  • arianeeId - Digital passport identification number.
  • passphrase - Digital passport passphrase.
  • deeplink - Digital passport link.
  • serialNumber - Serial number of the digital passport product.
  • name - Name of the digital passport product.
  • chain - Chain involved.
  • currentOwner - Current digital passport owner wallet address.
  • isDestroyed - The digital passport is destroyed if true.
  • creationDate - Creation date of the digital passport.
  • isBrandOwner - Digital passport belongs to the brand.
  • numberOfTransfer - Number of transfers of the digital passport.
  • firstClaimDate - Date of the first digital passport claiming.
  • lastClaimDate - Date of the last digital passport claiming.
{
  "query": {
    "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
    "fromTimestamp": "2022-06-07T20:05:25Z",
    "toTimestamp": "2022-06-08T20:05:25Z"
  },
  "result": [
    [
      {
        "tokenId": 73529443,
        "timestamp": "2022-06-08 06:42:45+00",
        "blockNumber": "27802231",
        "owner": "0x045f8F924E5aBf716A7aE66403e9553F9F2E396C",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 25341984,
        "timestamp": "2022-06-08 08:41:55+00",
        "blockNumber": "27803500",
        "owner": "0x07405fE6D58D0049CBBC95b90d34ab9860DEc437",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 22200251,
        "timestamp": "2022-06-08 15:17:20+00",
        "blockNumber": "27807609",
        "owner": "0x794c544F3e8B194d7a1155282B83e64C45AaFa89",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 56806265,
        "timestamp": "2022-06-08 15:17:40+00",
        "blockNumber": "27807611",
        "owner": "0xdDA4c4f0b007593c8F09102A56B2Db6595994877",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 36761613,
        "timestamp": "2022-06-08 15:17:45+00",
        "blockNumber": "27807612",
        "owner": "0xC5E72d57EFD811F4664E2ecdb71ff19319B89a44",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 87156470,
        "timestamp": "2022-06-08 15:17:45+00",
        "blockNumber": "27807612",
        "owner": "0x722976114c0c69EDC3Bbd324be9e0235BBf557E5",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 21492262,
        "timestamp": "2022-06-08 15:25:55+00",
        "blockNumber": "27807697",
        "owner": "0x958DFDC75b4F2Fc50edB48A2aBE87E10E9E4cDe8",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 64148932,
        "timestamp": "2022-06-08 15:26:35+00",
        "blockNumber": "27807705",
        "owner": "0xA48516057863Bd720af88BA6c3227f39ae944e91",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      },
      {
        "tokenId": 93979571,
        "timestamp": "2022-06-08 15:38:05+00",
        "blockNumber": "27807824",
        "owner": "0xC64D13831919Ad2Ec75c5F64DDc6f9a12BAe8Bd6",
        "issuer": "0xb908B66915ecD1ec31e669adc9C71BDcE44EC601",
        "isIssuerOwner": false,
        "isDetroyed": false,
        "eventName": "Transfer",
        "isHostedWallet": false,
        "transferCount": 1
      }
    ]
  ]
}