AvaCloud API
AvaCloud App
AvaCloud API
AvaCloud API
  • 👋Welcome
  • 🚀Getting Started
    • First steps
  • ⚙️API Reference
    • Key Concepts
    • Authentication
      • Create Token
    • L1
      • Get L1s
      • Create L1
      • Get L1
      • Health Check
      • Teardown
    • Plans
      • Get Infra Plans
  • Specification
Powered by GitBook

© 2025 Ava Labs, Inc.

On this page

Was this helpful?

  1. API Reference
  2. L1

Get L1

Returns details about an L1

PreviousCreate L1NextHealth Check

Last updated 4 months ago

Was this helpful?

Request Overview

Parameter
Example Value
Description

subnetID*

"dd9d03e6-f992-4657-bb92-f68b12999fdb"

The unique identifier of an L1

*required field


⚙️

Get L1 by subnetID

get

Get L1 by subnetID

Authorizations
Path parameters
subnetIDstringRequired

SubnetID

Responses
200
OK
application/json
401
Unauthorized
404
Not Found
get
GET /v1/api/subnets/{subnetID} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "adminThreshold": 1,
  "admins": [
    {
      "alias": "text",
      "evmAddress": "text"
    }
  ],
  "binaryInfo": {
    "customAvaGoTag": "text",
    "customGoVersion": "text",
    "customSubnetEVMTag": "text"
  },
  "bundleID": "text",
  "createdAt": 1,
  "deployInfo": {
    "avalancheSubnetID": "text",
    "blockchainID": "text",
    "customerValidators": [
      {
        "bLSPublicKey": "text",
        "cluster": "text",
        "ipAddress": "text",
        "nodeID": "text",
        "p2pPort": 1,
        "proofOfPossession": "text",
        "region": "text"
      }
    ],
    "dataDebugURLs": [
      {
        "activeSince": 1,
        "cluster": "text",
        "region": "text",
        "url": "text"
      }
    ],
    "dedicatedAPIs": [
      {
        "activeSince": 1,
        "cluster": "text",
        "region": "text",
        "url": "text"
      }
    ],
    "rpcURL": "text",
    "validatorManager": {
      "proxyAdminContractAddress": "text",
      "proxyContractAddress": "text",
      "validatorManagerAddress": "text"
    },
    "validators": [
      {
        "bLSPublicKey": "text",
        "cluster": "text",
        "ipAddress": "text",
        "nodeID": "text",
        "p2pPort": 1,
        "proofOfPossession": "text",
        "region": "text"
      }
    ],
    "vmID": "text",
    "websocketURL": "text"
  },
  "deploymentError": "text",
  "deploymentStatus": "Development",
  "deploymentType": "",
  "devnetExpiration": 1,
  "devnetIndexKey": "text",
  "devnetStartTime": 1,
  "evmChainID": "text",
  "foundationSigned": true,
  "genesis": {
    "airdrops": [
      {
        "address": "text",
        "value": "text"
      }
    ],
    "chainID": 1,
    "gasConfig": "text",
    "precompiles": [
      {
        "addressAliases": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "admins": [
          "text"
        ],
        "enabled": [
          "text"
        ],
        "name": "text",
        "rewardManagerInitialRewardConfig": {
          "allowFeeRecipients": true,
          "rewardAddress": "text"
        }
      }
    ],
    "symbol": "text",
    "vmType": "text"
  },
  "id": "text",
  "infraPlan": {
    "customerValidators": "text",
    "debugNodes": "text",
    "dedicatedNodes": "text",
    "plan": "text",
    "rpcNodes": "text",
    "validators": "text",
    "wsNodes": "text"
  },
  "isRegisteredInBridgeApp": "Y",
  "isRejected": true,
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metricsIngestionComplete": true,
  "name": "text",
  "network": "text",
  "orgID": "text",
  "planDetails": {
    "customerValidators": [
      {
        "cloudProvider": "aws",
        "count": 1,
        "region": "text"
      }
    ],
    "dedicatedNodes": [
      {
        "cloudProvider": "aws",
        "count": 1,
        "region": "text",
        "resources": {
          "cpu": "text",
          "memory": "text"
        },
        "size": "small"
      }
    ],
    "glacier": {
      "debugNodes": [
        {
          "cloudProvider": "aws",
          "count": 1,
          "region": "text",
          "resources": {
            "cpu": "text",
            "memory": "text"
          },
          "size": "small"
        }
      ],
      "enableIndexing": true
    },
    "metricsIndexing": true,
    "rpcNodes": [
      {
        "cloudProvider": "aws",
        "count": 1,
        "region": "text",
        "resources": {
          "cpu": "text",
          "memory": "text"
        },
        "size": "small"
      }
    ],
    "validators": [
      {
        "cloudProvider": "aws",
        "count": 1,
        "region": "text"
      }
    ],
    "wsNodes": [
      {
        "cloudProvider": "aws",
        "count": 1,
        "region": "text",
        "resources": {
          "cpu": "text",
          "memory": "text"
        },
        "size": "small"
      }
    ]
  },
  "publicExplorer": {
    "entryID": "text",
    "url": "text"
  },
  "runningAvaGoVersion": "text",
  "runningSubEVMVersion": "text",
  "setupInteroperability": true,
  "simulateInfra": true,
  "submittedAt": 1,
  "subscriptionID": "text",
  "teleporterConfiguration": {
    "awmRelayerID": "text",
    "awmRelayerStatus": "Pending",
    "messengerContractVersions": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "registryContractAddress": "text"
  },
  "transformedName": "text",
  "updatedAt": 1,
  "vrf": {
    "tos": 1
  }
}
  • Request Overview
  • GETGet L1 by subnetID