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.
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"
}'{
"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
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your API token.
Headers
x-role-typestringrequiredSeat 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
includeDisabledbooleanAlso return disabled tokens
payrollTypestringOnly tokens enabled for this payroll type or for all types
Available options: ON_CYCLE, OFF_CYCLE, INVOICE_PAYMENT
Response
200Success
dataobjectrequiredShow child attributes
tokenTypesobject[]requiredShow child attributes
tokenTypeIDstring<uuid>namestringcurrencyCodestringiconstring | nullorgIDstring<uuid>enabledForPayrollTypestring | nullAvailable options: ON_CYCLE, OFF_CYCLE, INVOICE_PAYMENT
networkIDstring<uuid>addressstring | nullToken contract address (ERC20)
decimalPlacesinteger | nullcoinMarketCapIDstring | nullcreatedAtstring<date-time>isTokenEnabledboolean | nullisContractorDefaultbooleandefaultTokenSlugstring | nullcatalogTokenDeploymentIDstring<uuid> | nullNetworkobjectShow child attributes
networkIDstring<uuid>namestringiconstring | nulltokenTypestringAvailable options: ERC20, NATIVE
isNetworkEnabledboolean | nullOrganizationTestTransactionConfigurationobject[]Show child attributes
orgTestTransactionConfigIdstring<uuid>amountnumbernumberOfTxPer24HoursintegerwalletNetworkIdstring<uuid>errorobject | nullrequiredAlways null on success
401The token is missing, invalid or expired
errorstringrequiredWhat went wrong
403The token's seat doesn't have the permission this operation needs
errorobjectrequiredShow child attributes
messagestringrequired429Too many requests from this address or token. Wait for the number of seconds in the Retry-After header, then retry.
errorstringrequiredWhat went wrong
500The operation failed. This includes input that doesn't match what the operation accepts; error.message says what was wrong.
errorobjectrequiredShow child attributes
messagestringrequired