---
updatedAt: 2025-11-12T22:16:25.000Z
agentTools:
  projectIndex: https://docs.nmp.arianee.com/llms.txt
---

# Report Distributed Digital Passports using Tags

As a brand, say you wish to list digital passport IDs having one or several specific tags.

> ⚠️
>
> This API returns only the digital passports that are no longer owned by the NFT Management Platform.

#### URL

> Required rights: `admin` or `certRead`

Use the [`certificate/getListOfSmartAssetsIdByTags`](https://docs.nmp.arianee.com/reference/reportdistributeddigitalpassportsusingtags) with the following parameters.

```text URL
POST - https://{{nmpUrl}}/certificate/getListOfSmartAssetsIdByTags
```

#### Body

| Field         | Type        | Required | Description                                                       |
| :------------ | :---------- | :------- | :---------------------------------------------------------------- |
| `tags`        | String      | ✅        | Tag of the digital passport to count.                             |
| `tagRule`     | `and`, `or` | ❌        | If you search for one tag, leave the parameter empty.             |
| `uniqueOwner` | Boolean     | ✅        | The digital passport has had one unique owner since its creation. |

```json Body Example
{
    "tags": ["kittenhoodie"],
    "tagRule": "and",
    "uniqueOwner": true
}
```

#### Return Payload

The digital passport ID list is returned.

```json 200 Return Payload
{
    "result": {
        "smartAssetsId": [
            479081,
            95239832777,
            70269147,
            22143314,
            95041636,
            296461532,
            43724522,
            48496526,
            47045142,
            74876956,
            46905527
        ]
    }
}
```

#### Errors

> ⚠️
>
> If incorrect `tags`, `smartAssetId` list is empty.

```json 200 Return Payload
{
    "result": {
        "smartAssetsId": []
    }
}
```