---
title: "List tokens by IDs"
method: GET
path: "/nfts/tokens"
tags: ["NFTs"]
---

# List tokens by IDs

`GET /nfts/tokens`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/nfts/tokens`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/nfts/tokens/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the requested tokens data.

## Query parameters

- `ids` string, required
- `pageCursor` string
- `pageSize` number
- `sort` string[]
- `order` 'DESC' | 'ASC'

## Response `200`

- GetNFTsResponse
  - `paging` Paging
    - `next` string, required: Cursor to the next page
  - `data` TokenResponse[]
    - `id` string, required: The Fireblocks NFT asset id
    - `tokenId` string, required: Token id within the contract/collection
    - `standard` string, required: ERC721 / ERC1155
    - `metadataURI` string: URL of the original token JSON metadata
    - `cachedMetadataURI` string: URL of the cached token JSON metadata
    - `media` MediaEntityResponse[]: Media items extracted from metadata JSON
      - `url` string, required: Cached accessible URL
      - `contentType` 'IMAGE' | 'VIDEO' | 'ANIMATION' | 'THREE_D' | 'TEXT' | 'GIF' | 'UNKNOWN_TYPE' | 'SVG' | 'AUDIO', required: Media type
    - `spam` SpamTokenResponse
      - `result` boolean, required: Token spam result
    - `collection` TokenCollectionResponse
      - `id` string, required
      - `name` string
      - `symbol` string
    - `blockchainDescriptor` 'ETH' | 'ETH_TEST3' | 'ETH_TEST5' | 'ETH_TEST6' | 'POLYGON' | 'POLYGON_TEST_MUMBAI' | 'AMOY_POLYGON_TEST' | 'XTZ' | 'XTZ_TEST' | 'BASECHAIN_ETH' | 'BASECHAIN_ETH_TEST3' | 'BASECHAIN_ETH_TEST5' | 'ETHERLINK' | 'ETHERLINK_TEST' | 'MANTLE' | 'MANTLE_TEST' | 'GUN_GUNZILLA' | 'GUN_GUNZILLA_TEST' | 'ETH_SONEIUM' | 'SONEIUM_MINATO_TEST' | 'IOTX_IOTEX' | 'KLAY_KAIA' | 'KLAY_KAIA_TEST' | 'APECHAIN' | 'APECHAIN_TEST' | 'CRONOS' | 'CRONOS_TEST' | 'ROBINHOOD_CHAIN_TESTNET_TEST' | 'ARB', required
    - `description` string
    - `name` string

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)