# List user's NFT balances group by Collection ID ## Endpoint ``` GET /api/v3/user/collection/details ``` *** ## Header | Field | Description | Example | | :-------: | ----------- | ------------------------------------------------------------------ | | X-API-KEY | ApiKey | "HlkcGxbqBeaF76j4rvPaOasyfPwnkQ6B6DQ6THZWbvrAGxzEdulXQvOKLrRWZLnN" | ## ## **Request** | Query Param | Description | Example | | :---------------------: | --------------------------------------------- | -------------------------------------------- | | accountId | User account Id | 10001 | | offset | (Optional) | 0 | | limit | (Optional) | 10 | | nonZero (Optional) | Only return non-zero nfts | true | | tokenAddress (Optional) | Only return collections of this token address | fe0x1abe8e24312e9fe614b5c9c67b472b3ecb3b8788 | ## ## **Response** | Field | Description | Example | | :---------: | ----------------------------------------------------- | ------- | | collections | See [Collection](broken://pages/eNxdooIg1mwvumT9fMWf) | | ### **Collection** | Field | Description | Example | | :---------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Unique collection Id | 256 | | owner | Owner address | "0x3be20a5500a331ef148f1aca64e326cd0b605a4b" | | name | Collection name | "test1127" | | contractAddress | ERC1155 nft token address to be deployed on L1 | "0x4a71d8b79ab6d9ae89e6709a54e53db9c9e27e49" | | collectionAddress | URL of collection metadata, if this collection is created via loopring.io web app, `collectionAddress` will start with `0x`, and it can be visited on the browser via appending prefix `https://nftinfos.loopring.io/` to the `collectionAddress`, for example, `https://nftinfos.loopring.io/0x9717fa2a7d827b3db111be23938c95d14b875863`. Otherwise, it may be in the format of ipfs `ipfs://...` or https `https://...` | "0x9717fa2a7d827b3db111be23938c95d14b875863" or "" | | baseUri | Generated by Loopring | "ipfs\://0x26ae6d3096348959d033b32ef635b58c0b50d5cb2165debafbb7e6eef783fd9e" | | nftFactory | NFT factory contract address of this colleciton | "0xfDDA90dbCc99B3a91e3fB1292991Ba1076d9E281" | | description | Text | "" | | avatar | Ipfs URI or URL of collection image | "ipfs\://QmZop7r8RQkB3L9BNfkKsZfY82kTVoPQyaSiZsTeKgTDij" | | banner | Ipfs URI or URL of collection image | "ipfs\://QmZop7r8RQkB3L9BNfkKsZfY82kTVoPQyaSiZsTeKgTDij" | | thumbnail | Ipfs URI or URL of collection image | "ipfs\://QmZop7r8RQkB3L9BNfkKsZfY82kTVoPQyaSiZsTeKgTDij" | | tileUri | Ipfs URI or URL of collection image | "ipfs\://QmZop7r8RQkB3L9BNfkKsZfY82kTVoPQyaSiZsTeKgTDij", | | cached | Cached collection image URL read and stored by loopring if the cache is available. If the cache constructed fails will return empty. See [Cached](broken://pages/eNxdooIg1mwvumT9fMWf) | | | deployStatus | L1 ERC1155 NFT contract deploy status | "NOT\_DEPLOYED" or "DEPLOY\_FAILED" or "DEPLOYING" or "DEPLOYED" | | nftType | Collections created from loopring.io are all ERC1155 | "ERC1155" or "ERC721" | | isPublic | | false | | times | See [Times](broken://pages/eNxdooIg1mwvumT9fMWf) | | | extra | See [Extra](broken://pages/eNxdooIg1mwvumT9fMWf) | | | count | How many kinds of nfts user hold under this collection | 10 | #### **Cached** | Field | Description | Example | | :-------: | ----------- | -------------------------------------------------------------------------------------------------------------------- | | avatar | | "" | | banner | | "", | | tileUri | | "", | | thumbnail | | "" | #### **Extra** | Field | Description | Example | | :---------: | ----------------------------------------------------- | ------------------ | | properties | See [Properties](broken://pages/eNxdooIg1mwvumT9fMWf) | | | mintChannel | Where this collection initially created | "UNKNOWN\_CHANNEL" | **Properties** | Field | Description | Example | | :-----------------: | ------------------------------------------------------------------------------------------------------- | ------- | | isLegacy | If this collection was created from a legacy NFT token address, see Create collection from legacy NFTs | false | | isPublic | | false | | isCounterFactualNFT | Whether the NFT token address was counter-factual | true | | isMintable | Whether the user can mint more nfts under this token address | true | | isEditable | Whether the user can edit collection info | true | | isDeletable | User can delete one collection only if he is the creator of that collection and the collection is empty | true | #### **Times** | Field | Description | Example | | :-------: | ------------------------------ | ------------- | | createdAt | Unix timestamp in milliseconds | 1669188281228 | | updatedAt | Unix timestamp in milliseconds | 1669188281228 | *** *** ## **Example** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs-protocol.loopring.io/counterfactual-nft/api-references/nft-collection/list-users-nft-balances-group-by-collection-id.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.