---
title: "GetTokenMetadata"
method: POST
path: "/rpc/Metadata/GetTokenMetadata"
tags: ["public"]
---

# GetTokenMetadata

`POST /rpc/Metadata/GetTokenMetadata`

GetTokenMetadata - fetch token metadata for a particular contract and respective tokenIDs

## Request body

- MetadataGetTokenMetadataRequest
  - `chainID` string
  - `contractAddress` string
  - `tokenIDs` string[] — []string

## Response `200`

OK

- MetadataGetTokenMetadataResponse
  - `tokenMetadata` TokenMetadata[] — []TokenMetadata
    - `tokenId` string, required
    - `name` string, required
    - `description` string
    - `image` string
    - `video` string
    - `audio` string
    - `properties` object — map<string,any>
    - `attributes` object[], required — []map<string,any>
    - `imageData` string
    - `externalUrl` string
    - `backgroundColor` string
    - `animationUrl` string
    - `decimals` number
    - `updatedAt` string
    - `assets` Asset[] — []Asset
      - `id` number, required
      - `collectionId` number, required
      - `tokenId` string
      - `url` string
      - `metadataField` string, required
      - `filename` string
      - `filesize` number
      - `mimeType` string
      - `width` number
      - `height` number
      - `updatedAt` string
    - `status` 'NOT_AVAILABLE' | 'STALE' | 'AVAILABLE', required — Represented as uint32 on the server side
    - `queuedAt` string
    - `lastFetched` string
  - `task` Task
    - `id` number, required
    - `queue` string, required
    - `status` 'QUEUED' | 'PAUSED' | 'FAILED' | 'COMPLETED' — Represented as uint8 on the server side
    - `try` number, required
    - `runAt` string
    - `lastRanAt` string
    - `createdAt` string
    - `payload` string[], required — []byte
    - `hash` string

## Other responses

- `4XX` — Client error
- `5XX` — Server error

---

[API](https://skmtc.dev/sequence/apis/analytics-api.md) · [All operations](https://skmtc.dev/sequence/apis/analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequence/analytics-api/revisions/12db1459a050/schema)