---
title: "List assets"
method: GET
path: "/assets"
tags: ["Blockchains & assets"]
---

# List assets

`GET /assets`

## Request

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

Retrieves a paginated list of all assets supported by Fireblocks in your workspace

**Note:** We will continue to support and display the legacy ID (API ID). Since not all Fireblocks services fully support the new Assets UUID, please use only the legacy ID until further notice.

## Query parameters

- `blockchainId` string
- `assetClass` 'NATIVE' | 'FT' | 'FIAT' | 'NFT' | 'SFT' | 'VIRTUAL'
- `symbol` string
- `scope` 'GLOBAL' | 'LOCAL': The scope of the asset
- `deprecated` boolean
- `ids` string[]
- `pageCursor` string
- `pageSize` number

## Headers

- `Idempotency-Key` string

## Response `200`

List of assets

- ListAssetsResponse
  - `data` Asset[], required: The data of the current page
    - `id` string, required: The ID of the asset
    - `legacyId` string, required: The Legacy ID of the asset
    - `blockchainId` string: The ID of the asset's blockchain
    - `displayName` string, required: Asset's display name
    - `displaySymbol` string, required: Asset's display symbol
    - `providerId` string: The ID of the asset provider
    - `peggedAssetId` string: The ID of the pegged asset
    - `assets` string[]: List of asset IDs for virtual assets
    - `assetClass` 'NATIVE' | 'FT' | 'FIAT' | 'NFT' | 'SFT' | 'VIRTUAL', required
    - `decimals` number: Number of decimals for FIAT assets
    - `onchain` AssetDetailsOnchain
      - `symbol` string, required: The asset symbol
      - `name` string, required: The asset name
      - `address` string: The asset address
      - `decimals` number, required: Number of decimals
      - `standards` string[]: Supported standards
    - `metadata` AssetDetailsMetadata, required
      - `scope` 'GLOBAL' | 'LOCAL', required: The scope of the asset
      - `verified` boolean, required: Is asset verified by Fireblocks
      - `deprecated` boolean, required: Is asset deprecated
      - `deprecationReferralId` string: New asset ID replacement
      - `website` string: Vendor’s website
      - `media` AssetMedia[]: Asset’s media
        - `url` string, required: Media URL
        - `type` 'image/svg+xml' | 'image/png', required: Media type
        - `attributes` object: Media attributes
          - `monochrome` boolean: Monochrome flag
      - `note` AssetNote
        - `text` string, required: Note content
        - `userId` string, uuid, required: Who updated the note (uuid)
        - `userName` string, required: User name
        - `updatedAt` string, date-time, required: ISO Timestamp when last updated
      - `features` AssetFeature[]: Asset features
  - `next` string, nullable, required: Cursor to the next page

## Other responses

- `500`: Error occurred while listing assets
- `default`: Error Response

---

[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)
