GET
/
node
curl --request GET \
  --url https://aiapi.scope3.com/node \
  --header 'Authorization: Bearer <token>'
{
  "nodes": [
    {
      "id": "my-custom-node-1",
      "cloud_id": "aws",
      "cloud_instance_id": "a2-highgpu-1g",
      "managed_service_id": "aws-bedrock",
      "gpu_id": "a100_40gb",
      "gpu_count": 8,
      "cpu_count": 2,
      "idle_power_w_ex_gpu": 100,
      "average_utilization_rate": 0.8,
      "embodied_emissions_kgco2e_ex_gpu": 2500,
      "embodied_water_l_ex_gpu": 2500,
      "use_life_years": 5,
      "customer_id": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

service
string

Filter nodes by managed service provider

cloud
string

Filter nodes by cloud provider

custom
boolean

Filter by node type:

  • true: Show only custom nodes
  • false: Show only global nodes
  • Not provided: Show all nodes
gpu
string

Filter nodes by GPU

instance
string

Filter nodes by cloud instance type

Response

200
application/json
Node details retrieved successfully
nodes
object[]
required