List Projects

GET/v1/projects

List all projects

Query ParametersExpand Collapse

cursor: optional string

Pagination cursor returned by a previous request

limit: optional number

Maximum number of items to return

maximum100

minimum10

ReturnsExpand Collapse

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

formatdate-time

name: string

Project name.

maxLength255

minLength1

resources: ProjectResources { blockchain, cloud }

Resource counts for the project.

blockchain: ProjectBlockchainResources { 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: ProjectCloudResources { 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.

formatdate-time

pagination: Pagination { next_cursor, previous_cursor, total_count }

Pagination response details.

next_cursor: string

previous_cursor: string

total_count: number

minimum0

List Projects

curl https://api.nirvanalabs.io/v1/projects \
    -H "Authorization: Bearer $NIRVANA_LABS_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
  }
}