> ## Documentation Index
> Fetch the complete documentation index at: https://catchbackcards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Token metadata

> A token's standard NFT metadata, which wallets and marketplaces read with no key. No prices.

No key · No scope

Every token carries a standard metadata URL that wallets and marketplaces read without a key, from anywhere. On EVM it is the token's `tokenURI`; on Solana it is the asset's `uri`.

| Mint chain | URL |
| - | - |
| EVM | `https://catchbackcards.com/api/partner-nfts/metadata/{chainId}/{tokenId}` |
| Solana | `https://catchbackcards.com/api/partner-nfts/metadata/{id}` (our id for the asset) |

* **It never includes a price** or value of any kind.
* It is cached for a few minutes.
* A token whose mint hasn't been sent yet answers `404`.
* A trailing `.json` on the last path segment is accepted.

**chainId** `string` *required*

EVM: the numeric chain id of your mint chain, e.g. `196`.

**tokenId** `string` *required*

EVM: the decimal `token_id`.

## Response

**name** `string`

The item's name, with its grade where it has one, e.g. `Charizard ex 199/165 (PSA 10)`.

**description** `string`

**image** `string | null`

The item's image.

**external\_url** `string`

**attributes** `object[]`

`{ "trait_type", "value" }` pairs: `Category`, `Set`, `Year`, `Number`, `Grade`, `Cert`, `Language`, `Brand`, `Size` and `Condition` where the item has them, and `Status` (`Vaulted`, or `Redeemed` once burned).

## Errors

| Status | When |
| - | - |
| `404` | No such token, or its mint hasn't been sent yet (`"error": "Unknown token"`) |
| `503` | Briefly unavailable; retry shortly |

```bash cURL theme={null}
curl https://catchbackcards.com/api/partner-nfts/metadata/196/81264573985362058461377125337283195667
```

```json 200 theme={null}
{
  "name": "Charizard ex 199/165 (PSA 10)",
  "description": "A physical collectible held in the CatchBack vault. Burn this token to sell it back or have it shipped.",
  "image": "https://...",
  "external_url": "https://catchbackcards.com",
  "attributes": [
    { "trait_type": "Category", "value": "pokemon" },
    { "trait_type": "Grade", "value": "PSA 10" },
    { "trait_type": "Status", "value": "Vaulted" }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.