# Function: getMetadataIdForTokenId()

> **getMetadataIdForTokenId**\<`T`\>(`tokenId`, `tokenMetadata`): `bigint` \| `-1` \| `T`

Defined in: [packages/bitbadgesjs-sdk/src/api-indexer/metadata/metadataIds.ts:35](https://github.com/BitBadges/bitbadgesjs/blob/master/packages/bitbadgesjs-sdk/src/api-indexer/metadata/metadataIds.ts#L35)

This function returns the [Metadata ID](https://docs.bitbadges.io/for-developers/bitbadges-sdk/common-snippets/metadata-ids)
for a specific token ID. Returns -1 if not found.

## Type Parameters

### T

`T` *extends* [`NumberType`](https://docs.bitbadges.io/sdk/reference/type-aliases/number-type)

## Parameters

### tokenId

`T`

### tokenMetadata

[`TokenMetadata`](https://docs.bitbadges.io/sdk/reference/classes/token-metadata)\<`T`\>[]

## Returns

`bigint` \| `-1` \| `T`

## Remarks

The token metadata array is the timeline values (TokenMetadataTimeline.tokenMetadata), not the cached fetched values
from the API.

## Examples

```ts
import { getMetadataIdForTokenId } from 'bitbadges'
const collection: BitBadgesCollection<bigint> = { ... }
const tokenId = 123n
const metadataId = getMetadataIdForTokenId(tokenId, collection.getTokenMetadataTimelineValue())
```

This can also be used with the BitBadges collection interface
```ts
import { BitBadgesCollection } from 'bitbadges'
const collection: BitBadgesCollection<bigint> = { ... }
const tokenId = 123n
const metadataId = collection.getMetadataIdForTokenId(tokenId)
```