/accounts/{address}/roles/collections/{collection}

Returns details about a specific NFT/SFT/MetaESDT collection from a given address.

Parameters

• address: REQUIRED (string) - the address to query

• collection : REQUIRED (string) - the information about the NFT or SFT, like picture traits or tags for your NFT/collection

Returns

• collection : (string) - represents additional information about the NFT or SFT, like picture traits or tags for your NFT/collection. The field should follow a metadata:ipfsCID/fileName.json;tags:tag1,tag2,tag3 format

• type : (string) - enum [NonFungibleESDT, SemiFungibleESDT, MetaESDT]

• ticker : (string) - a random string that starts with “-” and has 6 more random characters

• owner : (string) - the owner's address

• timestamp : (number) - u64 format

• canFreeze: (boolean) - the token manager may freeze the token balance in a specific account, preventing transfers to and from that account - default value: false

• canWipe: (boolean) - the token manager may wipe out the tokens held by a frozen account, reducing the supply - default value: false

• canPause: (boolean) - the token manager may prevent all transactions of the token, apart from minting and burning - default value: false

• _canTransferNFTCreateRole _ : (boolean) - the addresses with the transfer role can transfer anywhere

• decimals: (number) - the number of decimals in order to display balance

• assets :

  • website : (string)

  • description : (string)

  • status : active/inactive

  • pngUrl : (string)

  • svgUrl : (string)

  • lockedAccounts : (array[string])

  • extraTokens : (array[string])

• roles :

  • address: (string) - account bech32 address

  • canCreate : (boolean) - this role allows one to create

  • canBurn: (boolean) - users may "burn" some of their tokens, reducing the supply - default value: false

  • canAddQuantity : (boolean) - this role allows one to add quantity of a specific SFT

  • canUpdateAttributes : (boolean) - this role allows one to change the attributes of a specific NFT

  • canAddUri : (boolean) - this role allows one to add URIs for a specific NFT

  • canTransferRole : (boolean) - this role enables transfer only to specified addresses

  • roles : (array[string]) - the list of the roles

Example Request and Result for /accounts/{address}/roles/collections/{collection}

Request:

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/accounts/erd160y56egs9q7en67z06jk8ndsgxxuc0srf4kx8gfwc7xmap7zqvtqv973la/roles/collections/test' \
  -H 'accept: application/json'

Result:

{
  "collection": "string",
  "type": "NonFungibleESDT",
  "name": "string",
  "ticker": "string",
  "owner": "string",
  "timestamp": 0,
  "canFreeze": false,
  "canWipe": false,
  "canPause": false,
  "canTransferNftCreateRole": false,
  "decimals": 0,
  "assets": {
    "website": "string",
    "description": "string",
    "status": "inactive",
    "pngUrl": "string",
    "svgUrl": "string",
    "lockedAccounts": [
      "string"
    ],
    "extraTokens": [
      "string"
    ]
  },
  "roles": {
    "address": "string",
    "canCreate": false,
    "canBurn": false,
    "canAddQuantity": false,
    "canUpdateAttributes": false,
    "canAddUri": false,
    "canTransferRole": false,
    "roles": [
      "string"
    ]
  },
  "canCreate": true,
  "canBurn": true,
  "canAddQuantity": true,
  "canUpdateAttributes": true,
  "canAddUri": true,
  "canTransferRole": true
}