> For the complete documentation index, see [llms.txt](https://developer.1moneynetwork.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.1moneynetwork.com/integrations/rest-apis/tokens/get-token-metadata.md).

# Get token metadata

## GET /v1/tokens/token\_metadata

>

```json
{"openapi":"3.1.0","info":{"title":"om-api-rest","version":"0.1.0"},"tags":[{"name":"tokens","description":"Tokens API"}],"servers":[{"url":"https://api.testnet.1money.network","description":"Testnet API server"},{"url":"https://api.1money.network","description":"Mainnet API server"},{"url":"http://localhost:18555","description":"Local API server"}],"paths":{"/v1/tokens/token_metadata":{"get":{"tags":["tokens"],"operationId":"get_mint_account","parameters":[{"name":"token","in":"query","description":"Token address to lookup metadata for","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintInfo"}}}},"400":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"408":{"description":"Request timeout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"422":{"description":"Business logic error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}}}}}},"components":{"schemas":{"MintInfo":{"type":"object","description":"`MintInfo` is the struct for token contract. One mint account represents one\ntoken.","required":["symbol","master_authority","master_mint_burn_authority","mint_burn_authorities","pause_authorities","list_authorities","black_list","white_list","metadata_update_authorities","bridge_mint_authorities","supply","decimals","is_paused","is_private","meta"],"properties":{"black_list":{"type":"array","items":{"$ref":"#/components/schemas/AddressSchema"},"description":"A blacklist of token accounts"},"bridge_mint_authorities":{"type":"array","items":{"$ref":"#/components/schemas/AddressSchema"},"description":"The authorities for bridge operations (minting from bridge). Maximum of\n5 authorities."},"decimals":{"type":"integer","format":"int32","description":"Number of base 10 digits to the right of the decimal place.","minimum":0},"is_paused":{"type":"boolean","description":"`true` if all transactions for this token are paused"},"is_private":{"type":"boolean","description":"`true` if this token is private and only whitelisted addresses can\noperate with the tokens"},"list_authorities":{"type":"array","items":{"$ref":"#/components/schemas/AddressSchema"},"description":"The authorities to blacklist/whitelist malicious accounts"},"master_authority":{"$ref":"#/components/schemas/AddressSchema","description":"`master_authority` used to create new tokens. The `master_authority` can\nbe provided if and only if during token creation. If `master_authority`\nis `EMPTY_ADDRESS`, the token hasn't been initialized. When the token is\ninitialized with `master_authority`, only the `master_authority` can\ngrant other role authorities to others. And the `master_authority`\nserves as the identifier address for the token. All token account's mint\nfield will be associated with the mint's `master_authority`."},"master_mint_burn_authority":{"$ref":"#/components/schemas/AddressSchema","description":"The authority that can grant individual `mint_burn_authorities`. The\n`master_mint_burn_authority` is created by `master_authority`, which\ndelegate the mint authority to other accounts."},"meta":{"$ref":"#/components/schemas/TokenMetadata","description":"Metadata of the token"},"metadata_update_authorities":{"type":"array","items":{"$ref":"#/components/schemas/AddressSchema"},"description":"The authorities for updating the metadata. Maximum of 5 authorities."},"mint_burn_authorities":{"type":"array","items":{"$ref":"#/components/schemas/MinterAllowance"},"description":"The collection of authorities to mint and burn tokens with a given\nallowance. If the allowance is used up, the authority is not able to\nmint any more tokens until the allowance is updated.\n\nThe allowance to burn is unlimited. Maximum of 20 authorities."},"pause_authorities":{"type":"array","items":{"$ref":"#/components/schemas/AddressSchema"},"description":"The authorities to pause/unpause token transactions. Maximum of 5\nauthorities."},"supply":{"$ref":"#/components/schemas/U256Schema","description":"Total supply of tokens."},"symbol":{"type":"string","description":"The symbol of the token. Created during token creation and cannot be\nchanged."},"white_list":{"type":"array","items":{"$ref":"#/components/schemas/AddressSchema"},"description":"A whitelist of token accounts. Only used if the token is private"}}},"AddressSchema":{"type":"string","title":"string"},"TokenMetadata":{"type":"object","description":"Token metadata for one token.","required":["name","uri","additional_metadata"],"properties":{"additional_metadata":{"type":"array","items":{"$ref":"#/components/schemas/MetadataKVPair"},"description":"must avoid storing the same key twice"},"name":{"type":"string","description":"The longer name of the token"},"uri":{"type":"string","description":"The URI pointing to richer metadata"}}},"MetadataKVPair":{"type":"object","description":"The additional key-value properties for one token.","required":["key","value"],"properties":{"key":{"type":"string"},"value":{"type":"string"}}},"MinterAllowance":{"type":"object","required":["minter","allowance"],"properties":{"allowance":{"$ref":"#/components/schemas/U256Schema"},"minter":{"$ref":"#/components/schemas/AddressSchema"}}},"U256Schema":{"type":"string","title":"string"},"RESTErrorData":{"type":"object","required":["error_code","message"],"properties":{"error_code":{"type":"string","description":"Structured error code for programmatic handling"},"message":{"type":"string","description":"Human-readable error message"}}}}}}
```