> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## OpenAPI

````yaml POST /getTokenTypesNew
openapi: 3.0.0
info:
  title: Toku API
  version: 1.0.0
  description: >-
    The Toku API lets you manage token grants, wallets, employee seats, tokens
    and networks, and invoice payments from your own systems. Payroll, EOR,
    payslips, webhooks, custody and distributions are not available through this
    API.
servers:
  - url: https://app.toku.com/api/tokuApi/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /getTokenTypesNew:
    post:
      summary: Get Token Types (v2, POST)
      description: >-
        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.
      tags:
        - Tokens & Networks
      security:
        - bearerAuth: []
      parameters:
        - name: x-role-type
          in: header
          required: true
          description: >-
            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.
          example: CLIENT_ORG_ADMIN
          schema:
            type: string
            enum:
              - CLIENT_ORG_ADMIN
              - FINANCE_ADMIN
              - CLIENT_ORG_APPROVER
              - USER
              - INVESTOR
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                networkID:
                  type: string
                  format: uuid
                  description: Only tokens on this network
                includeDisabled:
                  type: boolean
                  description: Also return disabled tokens
                  example: true
                payrollType:
                  type: string
                  enum:
                    - ON_CYCLE
                    - OFF_CYCLE
                    - INVOICE_PAYMENT
                  description: Only tokens enabled for this payroll type or for all types
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - error
                properties:
                  data:
                    type: object
                    properties:
                      tokenTypes:
                        type: array
                        items:
                          allOf:
                            - $ref: '#/components/schemas/TokenType'
                            - type: object
                              properties:
                                Network:
                                  type: object
                                  properties:
                                    networkID:
                                      type: string
                                      format: uuid
                                    name:
                                      type: string
                                    icon:
                                      type: string
                                      nullable: true
                                    tokenType:
                                      type: string
                                      enum:
                                        - ERC20
                                        - NATIVE
                                    isNetworkEnabled:
                                      type: boolean
                                      nullable: true
                                    OrganizationTestTransactionConfiguration:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          orgTestTransactionConfigId:
                                            type: string
                                            format: uuid
                                          amount:
                                            type: number
                                          numberOfTxPer24Hours:
                                            type: integer
                                          walletNetworkId:
                                            type: string
                                            format: uuid
                    required:
                      - tokenTypes
                  error:
                    type: object
                    nullable: true
                    description: Always null on success
                    example: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    TokenType:
      type: object
      properties:
        tokenTypeID:
          type: string
          format: uuid
          example: 990e8400-e29b-41d4-a716-446655440004
        name:
          type: string
          example: USDC
        currencyCode:
          type: string
          example: USDC
        icon:
          type: string
          nullable: true
        orgID:
          type: string
          format: uuid
        enabledForPayrollType:
          type: string
          enum:
            - ON_CYCLE
            - OFF_CYCLE
            - INVOICE_PAYMENT
          nullable: true
        networkID:
          type: string
          format: uuid
          example: 880e8400-e29b-41d4-a716-446655440003
        address:
          type: string
          description: Token contract address (ERC20)
          nullable: true
        decimalPlaces:
          type: integer
          example: 6
          nullable: true
        coinMarketCapID:
          type: string
          nullable: true
        createdAt:
          type: string
          format: date-time
        isTokenEnabled:
          type: boolean
          example: true
          nullable: true
        isContractorDefault:
          type: boolean
        defaultTokenSlug:
          type: string
          nullable: true
        catalogTokenDeploymentID:
          type: string
          format: uuid
          nullable: true
      description: A token type row
    ErrorResponse:
      type: object
      required:
        - error
      description: >-
        Returned before the operation runs: a missing or refused token, an
        unknown operation, a wrong method or too many requests.
      properties:
        error:
          type: string
          description: What went wrong
          example: Invalid token or insufficient permissions
    OperationError:
      type: object
      required:
        - error
      description: >-
        Returned when the operation itself refuses the request: invalid input,
        missing permission, a record that doesn't exist.
      properties:
        error:
          type: object
          required:
            - message
          properties:
            message:
              type: string
              example: Grant not found
  responses:
    Unauthorized:
      description: The token is missing, invalid or expired
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: The token's seat doesn't have the permission this operation needs
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/OperationError'
    RateLimited:
      description: >-
        Too many requests from this address or token. Wait for the number of
        seconds in the Retry-After header, then retry.
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds to wait before retrying
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: >-
        The operation failed. This includes input that doesn't match what the
        operation accepts; error.message says what was wrong.
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/OperationError'
              - $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal API token. Create via createUserApiToken endpoint.
````
