---
title: "List all Nodes"
method: GET
path: "/v1/nodes/"
tags: ["Node"]
---

# List all Nodes

`GET /v1/nodes/`

List all nodes in the networks your organization is part of.

## Query parameters

- `order_by` 'name' | 'created_at'
- `page` integer
- `project` string
- `organization` string
- `network` string
- `region` 'asia-southeast1' | 'ap-southeast-1' | 'us-west-2' | 'us-east-1' | 'uksouth' | 'eu3' — Regions the nodes are deployed to. Available for `gcloud`: * `asia-southeast1` Available for `aws`: * `ap-southeast-1` * `us-west-2` * `us-east-1` Available for `azure`: * `uksouth` Available for `vzo`: * `eu3`
- `provider` 'aws' | 'azure' | 'gcloud' | 'vzo' — Cloud provider. <br>See also [Supported cloud providers](https://docs.chainstack.com/platform/supported-cloud-hosting-providers).
- `protocol` 'ethereum' | 'polygon-pos' | 'bsc' | 'avalanche' | 'arbitrum' | 'near' | 'aurora' | 'gnosis' | 'cronos' | 'fantom' | 'starknet' | 'harmony' | 'tezos' | 'fuse' | 'bitcoin' — Protocol. <br>See also [Supported protocols](https://docs.chainstack.com/platform/supported-protocols).
- `status` 'pending' | 'running' | 'maintenance' | 'failed' | 'error' | 'stopping' | 'stopped' | 'starting' — See more about [statuses](https://docs.chainstack.com/platform/view-node-and-network-status).
- `role` 'peer' — Role of the node. <br>Available roles: * `peer` — peer node
- `type` 'shared' | 'dedicated' — Type of the node. <br>Available types: * `shared` — only for `ethereum`, `polygon-pos`, `bsc`, `avalanche`, `fantom`, `tezos`, `bitcoin` * `dedicated` — for all protocols
- `archive` boolean
- `public_network` 'ethereum-mainnet' | 'ethereum-ropsten-testnet' | 'ethereum-rinkeby-testnet' | 'polygon-pos-mainnet' | 'polygon-pos-testnet' | 'bsc-mainnet' | 'bsc-testnet' | 'avalanche-mainnet' | 'avalanche-testnet' | 'arbitrum-mainnet' | 'arbitrum-goerli' | 'near-mainnet' | 'near-testnet' | 'aurora-mainnet' | 'aurora-testnet' | 'gnosis-mainnet' | 'gnosis-testnet' | 'cronos-mainnet' | 'cronos-testnet' | 'fantom-mainnet' | 'fantom-testnet' | 'starknet-mainnet' | 'starknet-testnet' | 'harmony-mainnet' | 'harmony-devnet' | 'tezos-mainnet' | 'tezos-testnet' | 'fuse-mainnet' | 'fuse-testnet' | 'bitcoin-mainnet' | 'bitcoin-testnet'
- `name` string
- `project_type` 'public' — Type of the project. <br> * `public` for public chain project

## Response `200`

- object
  - `count` integer — Number of the objects in the paginated results.
  - `next` string, nullable — Link to the next page.
  - `previous` string, nullable — Link to the previous page.
  - `results` object[]
    - `id` string
    - `name` string — Name of the node.
    - `network` string — ID of the network.
    - `organization` string — ID of the organization that owns this node.
    - `type` 'shared' | 'dedicated' — Type of the node. <br>Available types: * `shared` — only for `ethereum`, `polygon-pos`, `bsc`, `avalanche`, `fantom`, `tezos`, `bitcoin` * `dedicated` — for all protocols
    - `provider` 'aws' | 'azure' | 'gcloud' | 'vzo' — Cloud provider. <br>See also [Supported cloud providers](https://docs.chainstack.com/platform/supported-cloud-hosting-providers).
    - `region` 'asia-southeast1' | 'ap-southeast-1' | 'us-west-2' | 'us-east-1' | 'uksouth' | 'eu3' — Regions the nodes are deployed to. Available for `gcloud`: * `asia-southeast1` Available for `aws`: * `ap-southeast-1` * `us-west-2` * `us-east-1` Available for `azure`: * `uksouth` Available for `vzo`: * `eu3`
    - `details` union
      - EthereumNodeDetails — Ethereum node details.
        - `mode` 'full' | 'archive' — See also [Ethereum node modes](https://docs.chainstack.com/operations/ethereum/modes)
        - `version` string
        - `api_namespaces` string[]
        - `https_endpoint` string — Only for the owner of the node.
        - `wss_endpoint` string — Only for the owner of the node.
        - `beacon_endpoint` string — Only for the owner of the node.
        - `graphql_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
      - BinanceSmartChainNodeDetails — Binance Smart Chain node details.
        - `mode` 'full' | 'archive' — See also [Binance Smart Chain node modes](https://docs.chainstack.com/operations/bsc/modes)
        - `version` string
        - `api_namespaces` string[]
        - `https_endpoint` string — Only for the owner of the node.
        - `wss_endpoint` string — Only for the owner of the node.
        - `graphql_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
      - AvalancheNodeDetails — Avalanche node details.
        - `version` string
        - `api_namespaces` string[]
        - `https_endpoint` string — Only for the owner of the node.
        - `wss_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
      - FantomNodeDetails — Fantom node details.
        - `version` string
        - `api_namespaces` string[]
        - `https_endpoint` string — Only for the owner of the node.
        - `wss_endpoint` string — Only for the owner of the node.
        - `graphql_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
      - TezosNodeDetails — Tezos node details.
        - `version` string
        - `https_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
      - SolanaNodeDetails — Solana node details.
        - `version` string
        - `https_endpoint` string — Only for the owner of the node.
        - `wss_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
      - StarknetNodeDetails — StarkNet node details.
        - `version` string
        - `https_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
      - BitcoinNodeDetails — Bitcoin node details.
        - `version` string
        - `https_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoint. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoint. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoint. <br>Only for the owner of the node.
      - HarmonyNodeDetails — Harmony node details.
        - `version` string
        - `api_namespaces` string[]
        - `https_endpoint` string — Only for the owner of the node.
        - `wss_endpoint` string — Only for the owner of the node.
        - `auth_username` string — Basic authentication username to access the node endpoints. <br>Only for the owner of the node.
        - `auth_password` string, password — Basic authentication password to access the node endpoints. <br>Only for the owner of the node.
        - `auth_key` string, password — Authentication key to access the node endpoints. <br>Only for the owner of the node.
    - `status` 'pending' | 'running' | 'maintenance' | 'failed' | 'error' | 'stopping' | 'stopped' | 'starting' — See more about [statuses](https://docs.chainstack.com/platform/view-node-and-network-status).
    - `creator` Creator — Creator of the object.
      - `id` string
      - `email` string, email
      - `first_name` string
      - `last_name` string
      - `organization` Object — Common object representation.
        - `id` string
        - `name` string
    - `created_at` string, date-time — When the object was created.
    - `role` 'peer' — Role of the node. <br>Available roles: * `peer` — peer node
    - `configuration` union
      - EthereumNodeConfiguration — Ethereum node configuration.
        - `archive` boolean — Pass `true` if you want to access full blockchain data and an archive of historical states. <br>See more about [archive nodes](https://docs.chainstack.com/operations/ethereum/modes).
      - PolygonPoSNodeConfiguration — Polygon PoS node configuration.
        - `archive` boolean — Pass `true` if you want to access full blockchain data and an archive of historical states. <br>See more about [archive nodes](https://docs.chainstack.com/operations/polygon/modes).
      - BinanceSmartChainNodeConfiguration — Binance Smart Chain node configuration.
        - `archive` boolean — Pass `true` if you want to access full blockchain data and an archive of historical states. <br>See more about [archive nodes](https://docs.chainstack.com/operations/bsc/modes).
      - AvalancheNodeConfiguration — Avalanche node configuration.
        - `archive` boolean — Pass `true` if you want to access full blockchain data and an archive of historical states. <br>See more about [archive nodes](https://docs.chainstack.com/operations/avalanche/modes).
      - FantomNodeConfiguration — Fantom node configuration.
        - `archive` boolean — Pass `true` if you want to access full blockchain data and an archive of historical states. <br>See more about [archive nodes](https://docs.chainstack.com/operations/fantom/modes).
      - TezosNodeConfiguration — Tezos node configuration.
        - `archive` boolean — Pass `true` if you want to access full blockchain data and an archive of historical states. <br>See more about [archive nodes](https://docs.chainstack.com/operations/tezos/modes).
        - `tezos_node_type` string — Currently 'regular' is the only supported type.
      - SolanaNodeConfiguration — Solana node configuration.
      - StarknetNodeConfiguration — StarkNet node configuration.
      - HarmonyNodeConfiguration — Harmony node configuration.
        - `archive` boolean — Only `false` (full mode) is currently supported.
        - `shard` integer — Only Shard 0 is currently supported.

---

[API](https://skmtc.dev/chainstack/apis/chainstack-platform-api.md) · [All operations](https://skmtc.dev/chainstack/apis/chainstack-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainstack/chainstack-platform-api/revisions/3ab04211149e/schema)