# 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"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.1moneynetwork.com/integrations/rest-apis/tokens/get-token-metadata.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.