Tokens & Networks

Get Token Types (v2, POST)

Returns your organization's token types with their network, sorted by network name then token name. By default only enabled tokens (isTokenEnabled true) are returned. Some tokens may be hidden for certain organizations or employee addresses. Same as GET /getTokenTypesNew, but filters go in a JSON body, so includeDisabled works.

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

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/getTokenTypesNew' \
  --header 'Authorization: Bearer <token>' \
  --header 'x-role-type: CLIENT_ORG_ADMIN' \
  --header 'Content-Type: application/json' \
  --data '{
  "networkID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "includeDisabled": true,
  "payrollType": "ON_CYCLE"
}'
200 response
{
  "data": {
    "tokenTypes": [
      {
        "tokenTypeID": "990e8400-e29b-41d4-a716-446655440004",
        "name": "USDC",
        "currencyCode": "USDC",
        "icon": "string",
        "orgID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "enabledForPayrollType": "ON_CYCLE",
        "networkID": "880e8400-e29b-41d4-a716-446655440003",
        "address": "string",
        "decimalPlaces": 6,
        "coinMarketCapID": "string",
        "createdAt": "2026-01-01T00:00:00Z",
        "isTokenEnabled": true,
        "isContractorDefault": true,
        "defaultTokenSlug": "string",
        "catalogTokenDeploymentID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "Network": {
          "networkID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "icon": "string",
          "tokenType": "ERC20",
          "isNetworkEnabled": true,
          "OrganizationTestTransactionConfiguration": [
            {
              "orgTestTransactionConfigId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
              "amount": 0,
              "numberOfTxPer24Hours": 0,
              "walletNetworkId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
            }
          ]
        }
      }
    ]
  },
  "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

networkIDstring<uuid>

Only tokens on this network

includeDisabledboolean

Also return disabled tokens

payrollTypestring

Only tokens enabled for this payroll type or for all types

Available options: ON_CYCLE, OFF_CYCLE, INVOICE_PAYMENT

Response

200Success
dataobjectrequired
Show child attributes
tokenTypesobject[]required
Show child attributes
tokenTypeIDstring<uuid>
namestring
currencyCodestring
iconstring | null
orgIDstring<uuid>
enabledForPayrollTypestring | null

Available options: ON_CYCLE, OFF_CYCLE, INVOICE_PAYMENT

networkIDstring<uuid>
addressstring | null

Token contract address (ERC20)

decimalPlacesinteger | null
coinMarketCapIDstring | null
createdAtstring<date-time>
isTokenEnabledboolean | null
isContractorDefaultboolean
defaultTokenSlugstring | null
catalogTokenDeploymentIDstring<uuid> | null
Networkobject
Show child attributes
networkIDstring<uuid>
namestring
iconstring | null
tokenTypestring

Available options: ERC20, NATIVE

isNetworkEnabledboolean | null
OrganizationTestTransactionConfigurationobject[]
Show child attributes
orgTestTransactionConfigIdstring<uuid>
amountnumber
numberOfTxPer24Hoursinteger
walletNetworkIdstring<uuid>
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