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

## OpenAPI

````yaml POST /getNetworksNew
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:
  /getNetworksNew:
    post:
      summary: Get Networks (v2, POST)
      description: >-
        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.
      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:
                includeDisabled:
                  type: boolean
                  description: >-
                    Also return disabled tokens and networks without enabled
                    tokens
                  example: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - error
                properties:
                  data:
                    type: object
                    properties:
                      networks:
                        type: array
                        items:
                          allOf:
                            - $ref: '#/components/schemas/Network'
                            - type: object
                              properties:
                                TokenType:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      tokenTypeID:
                                        type: string
                                        format: uuid
                                      name:
                                        type: string
                                      currencyCode:
                                        type: string
                                      isTokenEnabled:
                                        type: boolean
                                        nullable: true
                                tokenTypes:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      tokenTypeID:
                                        type: string
                                        format: uuid
                                      name:
                                        type: string
                                      currencyCode:
                                        type: string
                                      isTokenEnabled:
                                        type: boolean
                                        nullable: true
                                  description: Same list as TokenType
                                rpcUrlConfigured:
                                  type: boolean
                                  description: >-
                                    True when an RPC URL is set (the URL itself
                                    is not returned)
                    required:
                      - networks
                  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:
    Network:
      type: object
      properties:
        networkID:
          type: string
          format: uuid
          example: 880e8400-e29b-41d4-a716-446655440003
        orgID:
          type: string
          format: uuid
        name:
          type: string
          example: Ethereum
        icon:
          type: string
          example: ethereum.svg
          nullable: true
        tokenType:
          type: string
          enum:
            - ERC20
            - NATIVE
          example: ERC20
        isNetworkEnabled:
          type: boolean
          example: true
          nullable: true
        chainType:
          type: string
          enum:
            - EVM
            - SOLANA
            - XRPL
            - BITCOIN
            - COSMOS_SDK
            - FILECOIN
            - PROVENANCE
            - ALEO
            - FOGO
            - FIAT
            - NEAR
            - POLKADOT
            - STACKS
            - SUI
          example: EVM
          nullable: true
        meshConnectNetworkID:
          type: string
          nullable: true
        evmChainID:
          type: integer
          example: 1
          nullable: true
        multiSendCallOnlyAddress:
          type: string
          nullable: true
        safeSingletonAddress:
          type: string
          nullable: true
        safeFactoryAddress:
          type: string
          nullable: true
        safeAppBaseUrl:
          type: string
          nullable: true
        safeTxServiceUrl:
          type: string
          nullable: true
        blockExplorerBaseUrl:
          type: string
          nullable: true
        eipsName:
          type: string
          nullable: true
        aleoTransferVisibility:
          type: string
          enum:
            - PUBLIC
            - PUBLIC_TO_PRIVATE
            - PRIVATE
          nullable: true
        defaultNetworkSlugUrl:
          type: string
          nullable: true
        catalogChainID:
          type: string
          format: uuid
          nullable: true
      description: 'A network row. rpcUrl is left out: most operations remove it.'
    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.
````
