Skip to content
Docs

List Projects

$ nirvana projects list
GET/v1/projects

List all projects

ParametersExpand Collapse
--cursor: optional string

Pagination cursor returned by a previous request

--limit: optional number

Maximum number of items to return

ReturnsExpand Collapse
project_list: object { items, pagination }
items: array of Project { id, created_at, name, 3 more }
id: string

Project ID.

created_at: string

When the Project was created.

name: string

Project name.

resources: object { blockchain, cloud }

Resource counts for the project.

blockchain: object { rpc_nodes_dedicated, rpc_nodes_flex }

Blockchain resources.

rpc_nodes_dedicated: number

Number of dedicated RPC nodes in the project.

rpc_nodes_flex: number

Number of flex RPC nodes in the project.

cloud: object { connect_connections, nks_clusters, nks_node_pools, 3 more }

Cloud infrastructure resources.

connect_connections: number

Number of Connect connections in the project.

nks_clusters: number

Number of NKS clusters in the project.

nks_node_pools: number

Number of NKS node pools in the project.

vms: number

Number of VMs in the project.

volumes: number

Number of volumes in the project.

vpcs: number

Number of VPCs in the project.

tags: array of string

Tags attached to the Project.

updated_at: string

When the Project was updated.

List Projects

nirvana projects list \
  --api-key 'My API Key'
{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-01-01T00:00:00Z",
      "name": "My Project",
      "resources": {
        "blockchain": {
          "rpc_nodes_dedicated": 1,
          "rpc_nodes_flex": 3
        },
        "cloud": {
          "connect_connections": 1,
          "nks_clusters": 2,
          "nks_node_pools": 4,
          "vms": 5,
          "volumes": 10,
          "vpcs": 2
        }
      },
      "tags": [
        "production",
        "ethereum"
      ],
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg",
    "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw",
    "total_count": 125
  }
}
Returns Examples
{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-01-01T00:00:00Z",
      "name": "My Project",
      "resources": {
        "blockchain": {
          "rpc_nodes_dedicated": 1,
          "rpc_nodes_flex": 3
        },
        "cloud": {
          "connect_connections": 1,
          "nks_clusters": 2,
          "nks_node_pools": 4,
          "vms": 5,
          "volumes": 10,
          "vpcs": 2
        }
      },
      "tags": [
        "production",
        "ethereum"
      ],
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg",
    "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw",
    "total_count": 125
  }
}