Tokens & Networks

Get Networks (v2, POST)

Returns your organization's networks sorted by name, each with its token types. By default only networks that have at least one enabled token are returned, with only their enabled tokens. Same as GET /getNetworksNew, but includeDisabled goes in a JSON body.

POSThttps://app.toku.com/api/tokuApi/v1/getNetworksNew

This is the v1 (legacy) API. The current API is in the API reference.

curl --request POST \
  --url 'https://app.toku.com/api/tokuApi/v1/getNetworksNew' \
  --header 'Authorization: Bearer <token>' \
  --header 'x-role-type: CLIENT_ORG_ADMIN' \
  --header 'Content-Type: application/json' \
  --data '{
  "includeDisabled": true
}'
200 response
{
  "data": {
    "networks": [
      {
        "networkID": "880e8400-e29b-41d4-a716-446655440003",
        "orgID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "Ethereum",
        "icon": "ethereum.svg",
        "tokenType": "ERC20",
        "isNetworkEnabled": true,
        "chainType": "EVM",
        "meshConnectNetworkID": "string",
        "evmChainID": 1,
        "multiSendCallOnlyAddress": "string",
        "safeSingletonAddress": "string",
        "safeFactoryAddress": "string",
        "safeAppBaseUrl": "string",
        "safeTxServiceUrl": "string",
        "blockExplorerBaseUrl": "string",
        "eipsName": "string",
        "aleoTransferVisibility": "PUBLIC",
        "defaultNetworkSlugUrl": "string",
        "catalogChainID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "TokenType": [
          {
            "tokenTypeID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "currencyCode": "string",
            "isTokenEnabled": true
          }
        ],
        "tokenTypes": [
          {
            "tokenTypeID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "currencyCode": "string",
            "isTokenEnabled": true
          }
        ],
        "rpcUrlConfigured": true
      }
    ]
  },
  "error": null
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your API token.

Headers

x-role-typestringrequired

Seat role the token acts as. The token's creator must hold this role in the token's organization; TOKU_ADMIN and unknown values are refused with 401. This operation accepts CLIENT_ORG_ADMIN, FINANCE_ADMIN, CLIENT_ORG_APPROVER, USER and INVESTOR; other roles get 403. FINANCE_ADMIN and CLIENT_ORG_APPROVER seats are refused in new-system organizations.

Available options: CLIENT_ORG_ADMIN, FINANCE_ADMIN, CLIENT_ORG_APPROVER, USER, INVESTOR

Body

application/json

includeDisabledboolean

Also return disabled tokens and networks without enabled tokens

Response

200Success
dataobjectrequired
Show child attributes
networksobject[]required
Show child attributes
networkIDstring<uuid>
orgIDstring<uuid>
namestring
iconstring | null
tokenTypestring

Available options: ERC20, NATIVE

isNetworkEnabledboolean | null
chainTypestring | null

Available options: EVM, SOLANA, XRPL, BITCOIN, COSMOS_SDK, FILECOIN, PROVENANCE, ALEO, FOGO, FIAT, NEAR, POLKADOT, STACKS, SUI

meshConnectNetworkIDstring | null
evmChainIDinteger | null
multiSendCallOnlyAddressstring | null
safeSingletonAddressstring | null
safeFactoryAddressstring | null
safeAppBaseUrlstring | null
safeTxServiceUrlstring | null
blockExplorerBaseUrlstring | null
eipsNamestring | null
aleoTransferVisibilitystring | null

Available options: PUBLIC, PUBLIC_TO_PRIVATE, PRIVATE

defaultNetworkSlugUrlstring | null
catalogChainIDstring<uuid> | null
TokenTypeobject[]
Show child attributes
tokenTypeIDstring<uuid>
namestring
currencyCodestring
isTokenEnabledboolean | null
tokenTypesobject[]

Same list as TokenType

Show child attributes
tokenTypeIDstring<uuid>
namestring
currencyCodestring
isTokenEnabledboolean | null
rpcUrlConfiguredboolean

True when an RPC URL is set (the URL itself is not returned)

errorobject | nullrequired

Always null on success

401The token is missing, invalid or expired
errorstringrequired

What went wrong

403The token's seat doesn't have the permission this operation needs
errorobjectrequired
Show child attributes
messagestringrequired
429Too many requests from this address or token. Wait for the number of seconds in the Retry-After header, then retry.
errorstringrequired

What went wrong

500The operation failed. This includes input that doesn't match what the operation accepts; error.message says what was wrong.
errorobjectrequired
Show child attributes
messagestringrequired
Was this page helpful? Suggest edits